PaymentDetailsUpdate - 用于实例化付款用户界面后向其提供更新的信息
PaymentDetailsUpdate
字典用于实例化付款用户界面后向其提供更新的信息。它作为调用 PaymentRequestUpdateEvent.updateWith()
方法的参数,或者是用于 PaymentRequest.show()
方法的 detailsPromise
参数,该参数是一个 Promise
,解析时需返回一个 PaymentDetailsUpdate
。通过该 Promise
,甚至在首次启用用户界面之前就能够更新了付款信息。
属性
PaymentDetailsUpdate
字典基于 PaymentDetailsBase
字典,并继承了其属性,包含在下面的列表中。
displayItems
可选
一个包含 PaymentItem
对象的数组,每个对象描述付款请求的一个订单项。它们代表收据或发票上的一行项目。
error
可选
一个 DOMString
,指定要向用户显示的错误消息。调用 updateWith()
时,在更新的数据中包含 error
会使 user agent 将文本显示为一般错误信息。对于特定于地址字段的错误,请使用 shippingAddressErrors
。
modifiers
可选
一个包含 PaymentDetailsModifier
对象的数组,每个对象描述特定付款方式标识符的修饰符。例如,您可以使用一种来根据所选的付款方式(“5%现金折扣!”)调整总付款金额。
shippingAddressErrors
可选
一个 AddressErrors
对象,其中包含无法验证的收货地址每个属性的错误消息。
shippingOptions
可选
一个包含 PaymentShippingOption
对象的数组,每个对象描述一个可供用户选择的可用送货选项。
total
可选
一个 PaymentItem
,表示付款金额的最新总和。请确保它等于 displayItems
中所有项目的总和。 它不是自动计算的。您必须在任何时候更改总金额时,自己更新此值。这使您可以灵活地处理诸如税收,折扣和对总价的其他调整之类的事情。
规范
规范 | 状态 | 备注 |
---|---|---|
Payment Request API PaymentDetailsUpdate 的定义 |
候选推荐 | 初始定义。 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 61 | 支持 | 551 | 不支持 | 不支持 | 未知 |
error | 61 | 支持 | 551 | 不支持 | 不支持 | 未知 |
shippingAddressErrors | 61 | 支持 | 551 | 不支持 | 不支持 | 未知 |
total | 61 | 支持 | 551 | 不支持 | 不支持 | 未知 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 不支持 | 53 | 未知 | 551 | 未知 | 不支持 | 未知 |
error | 不支持 | 60 | 未知 | 551 | 未知 | 不支持 | 未知 |
shippingAddressErrors | 不支持 | 60 | 未知 | 551 | 未知 | 不支持 | 未知 |
total | 不支持 | 60 | 未知 | 551 | 未知 | 不支持 | 未知 |
1. 仅在每晚构建版本中可用。