PaymentRequest

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在某些或所有支持的浏览器中。

支付请求 APIPaymentRequest接口是进入 API 的主要访问点,并允许 Web 内容和应用程序代表网站运营商或应用程序发布者接受来自最终用户的付款。

EventTarget PaymentRequest

构造函数

PaymentRequest()

创建一个新的 PaymentRequest 对象。

实例属性

PaymentRequest.id 只读

特定 PaymentRequest 的唯一标识符,可以通过 details.id 设置。当未设置时,默认为 UUID。

PaymentRequest.shippingAddress 只读 已弃用 非标准

如果通过付款选项请求,则返回用户为计算运费而选择的送货地址。此属性仅在使用 requestShipping 标志设置为 true 的情况下调用构造函数时填充。此外,在某些浏览器中,出于隐私考虑,地址的部分内容将被涂黑,直到用户表示他们已准备好完成交易(即,他们点击“付款”)。

PaymentRequest.shippingOption 只读 已弃用 非标准

返回所选送货选项的标识符。此属性仅在使用 requestShipping 标志设置为 true 的情况下调用构造函数时填充。

PaymentRequest.shippingType 只读 已弃用 非标准

返回用于履行交易的运输类型。这将是 shippingdeliverypickupnull 中的一个,如果在构造函数中未提供值则为 null

实例方法

PaymentRequest.canMakePayment()

在调用 show() 之前指示 PaymentRequest 对象是否可以付款。

PaymentRequest.show()

导致用户代理开始用户与付款请求的交互。

PaymentRequest.abort()

导致用户代理结束付款请求并删除可能显示的任何用户界面。

事件

merchantvalidation 已弃用

对于某些支付处理程序(例如,Apple Pay),此事件处理程序用于处理merchantvalidation事件,该事件在用户代理需要商家验证请求付款的商家或供应商是否合法时分派。

paymentmethodchange

对于某些支付处理程序(例如,Apple Pay),每当用户更改支付工具(例如,从信用卡切换到借记卡)时分派。

shippingaddresschange 已弃用 非标准

每当用户更改其送货地址时分派。

shippingoptionchange 已弃用 非标准

每当用户更改送货选项时分派。

规范

规范
支付请求 API
# paymentrequest-interface

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。