PaymentRequest

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

PaymentRequest 接口是该 API 的主要入口点,它允许 Web 内容和应用程序代表网站运营商或应用程序发布者从最终用户那里接受付款。

EventTarget PaymentRequest

构造函数

PaymentRequest()

创建一个新的 PaymentRequest 对象。

实例属性

PaymentRequest.id 只读

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

PaymentRequest.shippingAddress 只读 已弃用 非标准

如果通过付款选项请求,则返回用户为计算运费而选择的收货地址。仅当构造函数调用时 requestShipping 标志设置为 true 时,此属性才会被填充。此外,在某些浏览器中,地址的某些部分可能会出于隐私原因被隐藏,直到用户表明他们已准备好完成交易(即,他们点击“付款”)。

PaymentRequest.shippingOption 只读 已弃用 非标准

返回所选配送选项的标识符。仅当构造函数调用时 requestShipping 标志设置为 true 时,此属性才会被填充。

PaymentRequest.shippingType 只读 已弃用 非标准

返回用于完成交易的配送类型。这将是 shippingdeliverypickupnull(如果在构造函数中未提供值)。

静态方法

PaymentRequest.securePaymentConfirmationAvailability() 实验性

指示 安全支付确认 功能是否可用。

实例方法

PaymentRequest.canMakePayment()

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

PaymentRequest.show()

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

PaymentRequest.abort()

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

事件

merchantvalidation 已弃用

使用某些支付处理程序(例如 Apple Pay),会调用此事件处理程序来处理 merchantvalidation 事件,该事件在用户代理要求商家验证请求付款的商家或供应商的合法性时触发。

paymentmethodchange

使用某些支付处理程序(例如 Apple Pay),在用户更改支付方式时触发,例如从信用卡切换到借记卡。

shippingaddresschange 已弃用 非标准

在用户更改其收货地址时触发。

shippingoptionchange 已弃用 非标准

在用户更改配送选项时触发。

规范

规范
Payment Request API
# paymentrequest-interface

浏览器兼容性