PaymentRequest

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

PaymentRequest 介面是 Payment Request API 的主要切入點，它能讓網頁或 app 接受終端用戶的付款。

PaymentRequest.id Read only Secure context: 個別 PaymentRequest 的唯一標識符（unique identifier），可透過 details.id 設定之。若尚未指定，預設為 UUID。
PaymentRequest.shippingAddress Read only Secure context: 若透過付款設定（payment options）請求的話，回傳用戶指定的運送地址，以便計算運輸事宜。只有在呼叫的建構子 requestShipping flag 為 true 時，此屬性才能作動。另外，部份瀏覽器會出於隱私上的理由而只節錄部分地址，除非用戶表示交易手續即將完成（例如按下「付款」鈕）。
PaymentRequest.shippingOption Read only Secure context: 回傳的運送選項的標識符。只有在呼叫的建構子 requestShipping flag 為 true 時，此屬性才能作動。
PaymentRequest.shippingType Read only Secure context: 回傳用於完成交易的運送類型。可以是 shipping, delivery, pickup, 或在建構子未提供的情形下：null。

PaymentRequest.onshippingaddresschange Secure context: 用戶修改運送地址時觸發之。
PaymentRequest.onshippingoptionchange Secure context: 用戶修改運送選項時觸發之。
PaymentRequest.onpaymentmethodchange Secure context: 針對付款方法（如 Apple Pay），用戶修改支付方式時觸發之，比方說從信用卡改為簽帳卡。
PaymentRequest.onmerchantvalidation Secure context: 針對付款方法（如 Apple Pay），本事件會呼叫 merchantvalidation 事件，在用戶代理要求驗證付款商家或供應商是否合法時觸發之。

PaymentRequest.canMakePayment() Secure context: 在呼叫 show() 前告訴 PaymentRequest 物件能不能付款。
PaymentRequest.show() Secure context: 讓用戶代理開始付款請求的用戶交互。
PaymentRequest.abort() Secure context: 讓用戶代理結束付款請求並刪除可能顯示的任何用戶界面。

Specification
Payment Request API # paymentrequest-interface

BCD tables only load in the browser