PaymentResponse - 用户选择付款方式并批准付款请求后返回的对象

PaymentResponse 是付款请求 API 的接口，是用户选择付款方式并批准付款请求后返回的对象。

属性

PaymentResponse.details 只读 安全上下文

返回一个 JSON 可序列化的对象，该对象提供有关付款方式的消息，供商家用来处理交易并确定资金转移成功。对象的内容取决于所使用的付款方式。例如，如果使用基本卡付款方式，则此对象必须符合 BasicCardResponse 字典中定义的结构。

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 之后调用此方法。

事件

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

payerdetailchange 安全上下文

在重试期间，当用户在填写付款请求表时更改其个人信息时触发。如果有信息更改，允许开发人员重新验证任何请求的用户数据（例如，电话号码或电子邮件地址）。也可以通过 onpayerdetailchange属性绑定。

规范

规范	状态	备注
Payment Request API PaymentResponse 的定义	候选推荐	初始定义。

桌面浏览器兼容性

移动浏览器兼容性

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