PaymentResponse

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

PaymentResponse接口是支付请求 API的一部分,在用户选择支付方式并批准支付请求后返回。

EventTarget PaymentResponse

实例属性

PaymentResponse.details 只读

返回一个可 JSON 序列化的对象,该对象提供商家用于处理交易并确定资金转移是否成功的特定于支付方式的消息。对象的内容取决于所使用的支付方式。开发人员需要咨询控制 URL 的相关人员,以了解 details 对象的预期格式。

PaymentResponse.methodName 只读

返回用户选择的支付方式的支付方式标识符,例如 Visa、Mastercard、Paypal 等。

PaymentResponse.payerEmail 只读 已弃用 非标准

返回用户提供的电子邮件地址。仅当PaymentRequest()构造函数的options参数中的requestPayerEmail选项设置为true时,此选项才会出现。

PaymentResponse.payerName 只读 已弃用 非标准

返回用户提供的姓名。仅当PaymentRequest()构造函数的options参数中的requestPayerName选项设置为 true 时,此选项才会出现。

PaymentResponse.payerPhone 只读 已弃用 非标准

返回用户提供的电话号码。仅当PaymentRequest()构造函数的options参数中的requestPayerPhone选项设置为true时,此选项才会出现。

PaymentResponse.requestId 只读

返回生成当前响应的PaymentRequest的标识符。这与PaymentRequest()构造函数中由details.id提供的相同值。

PaymentResponse.shippingAddress 只读 已弃用 非标准

返回用户提供的送货地址。仅当PaymentRequest()构造函数的options参数中的requestShipping选项设置为true时,此选项才会出现。

PaymentResponse.shippingOption 只读 已弃用 非标准

返回用户选择的送货选项的 ID 属性。仅当PaymentRequest()构造函数的options参数中的requestShipping选项设置为true时,此选项才会出现。

实例方法

PaymentResponse.retry()

如果支付响应数据存在问题(并且存在可恢复的错误),则此方法允许商家请求用户重试支付。此方法接受一个对象作为参数,该对象用于向用户准确地指示支付响应中存在的问题,以便他们可以尝试更正任何问题。

PaymentResponse.complete()

通知用户代理用户交互已结束。这将导致关闭任何剩余的用户界面。此方法应仅在PaymentRequest.show()方法返回的 Promise 后调用。

PaymentResponse.toJSON()

返回一个表示此PaymentResponse对象的JSON 对象

事件

使用addEventListener()或通过将事件监听器分配给此接口的oneventname属性来监听此事件。

payerdetailchange 已弃用 非标准

在重试期间,当用户在填写支付请求表单时更改其个人信息时触发。允许开发人员在用户数据(例如电话号码或电子邮件地址)更改时重新验证任何请求的用户数据。

规范

规范
支付请求 API
# paymentresponse-interface

浏览器兼容性

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