PaymentResponse

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

PaymentResponse 介面是 Payment Request 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

在重試期間,當用戶在填寫支付請求表單時更改其個人資訊時觸發。允許開發者重新驗證任何請求的使用者資料(例如,電話號碼或電子郵件地址),如果它們發生更改。

規範

規範
Payment Request API
# paymentresponse-interface

瀏覽器相容性