PaymentRequest
支付请求 API的PaymentRequest
接口是进入 API 的主要访问点,并允许 Web 内容和应用程序代表网站运营商或应用程序发布者接受来自最终用户的付款。
构造函数
PaymentRequest()
-
创建一个新的
PaymentRequest
对象。
实例属性
PaymentRequest.id
只读-
特定
PaymentRequest
的唯一标识符,可以通过details.id
设置。当未设置时,默认为 UUID。 PaymentRequest.shippingAddress
只读 已弃用 非标准-
如果通过付款选项请求,则返回用户为计算运费而选择的送货地址。此属性仅在使用
requestShipping
标志设置为 true 的情况下调用构造函数时填充。此外,在某些浏览器中,出于隐私考虑,地址的部分内容将被涂黑,直到用户表示他们已准备好完成交易(即,他们点击“付款”)。 PaymentRequest.shippingOption
只读 已弃用 非标准-
返回所选送货选项的标识符。此属性仅在使用
requestShipping
标志设置为 true 的情况下调用构造函数时填充。 PaymentRequest.shippingType
只读 已弃用 非标准-
返回用于履行交易的运输类型。这将是
shipping
、delivery
、pickup
或null
中的一个,如果在构造函数中未提供值则为null
。
实例方法
PaymentRequest.canMakePayment()
-
在调用
show()
之前指示PaymentRequest
对象是否可以付款。 PaymentRequest.show()
-
导致用户代理开始用户与付款请求的交互。
PaymentRequest.abort()
-
导致用户代理结束付款请求并删除可能显示的任何用户界面。
事件
merchantvalidation
已弃用-
对于某些支付处理程序(例如,Apple Pay),此事件处理程序用于处理
merchantvalidation
事件,该事件在用户代理需要商家验证请求付款的商家或供应商是否合法时分派。 paymentmethodchange
-
对于某些支付处理程序(例如,Apple Pay),每当用户更改支付工具(例如,从信用卡切换到借记卡)时分派。
shippingaddresschange
已弃用 非标准-
每当用户更改其送货地址时分派。
shippingoptionchange
已弃用 非标准-
每当用户更改送货选项时分派。
规范
规范 |
---|
支付请求 API # paymentrequest-interface |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。