PaymentDetailsUpdate - 用于实例化付款用户界面后向其提供更新的信息

安全上下文
该功能仅在部分或所有支持的浏览器中的安全上下文(HTTPS)中可用。

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 的定义
候选推荐 初始定义。

桌面浏览器兼容性

特性ChromeEdgeFirefoxInternet ExplorerOperaSafari
基础支持61 支持551 不支持 不支持 未知
error61 支持551 不支持 不支持 未知
shippingAddressErrors61 支持551 不支持 不支持 未知
total61 支持551 不支持 不支持 未知

移动浏览器兼容性

特性AndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
基础支持 不支持53 未知551 未知 不支持 未知
error 不支持60 未知551 未知 不支持 未知
shippingAddressErrors 不支持60 未知551 未知 不支持 未知
total 不支持60 未知551 未知 不支持 未知

1. 仅在每晚构建版本中可用。