PaymentRequest
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
PaymentRequest
介面是 Payment Request API 的主要切入點,它能讓網頁或 app 接受終端用戶的付款。
建構子
PaymentRequest()
Secure context-
建立新的
PaymentRequest
物件。
屬性
PaymentRequest.id
Read onlySecure 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