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

瀏覽器相容性