PaymentRequest
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
決済リクエスト API の PaymentRequest インターフェイスは、このAPIへの第一のアクセスポイントであり、ウェブコンテンツやアプリが、サイトのユーザーやアプリの公開者に代わって、エンドユーザーからの決済を受け入れることができます。
コンストラクター
PaymentRequest()安全なコンテキスト用-
新しい
PaymentRequestオブジェクトを作成します。
インスタンスプロパティ
PaymentRequest.id読取専用 安全なコンテキスト用-
特定の
PaymentRequestに固有の識別子で、details.idで設定することができます。設定されていない場合は、UUID が既定値として設定されます。 PaymentRequest.shippingAddress読取専用 安全なコンテキスト用 非推奨 Non-standard-
決済オプションでリクエストされた場合、送料を計算するためにユーザーが選んだ配送先住所を返します。このプロパティは、コンストラクターが
requestShippingフラグを設定した状態で呼び出された場合にのみ設定されます。さらに、一部のブラウザーでは、ユーザーが取引を完了する準備ができていることを示す(すなわち、「購入する」を押す)までは、プライバシーのために住所の一部が省略されることになります。 PaymentRequest.shippingOption読取専用 安全なコンテキスト用 非推奨 Non-standard-
選択された配送オプションの識別子を返します。このプロパティは、
requestShippingフラグを true に設定してコンストラクターを呼び出した場合にのみ設定されます。 PaymentRequest.shippingType読取専用 安全なコンテキスト用 非推奨 Non-standard-
取引を履行するために使用する配送の種類を返します。これは
shipping、delivery、pickupのいずれか、またはコンストラクターで値が提供されなかった場合はnullとなる。
インスタンスメソッド
PaymentRequest.canMakePayment()安全なコンテキスト用-
show()を呼び出す前にPaymentRequestオブジェクトが決済を行うことができるかどうかを示します。 PaymentRequest.show()安全なコンテキスト用-
ユーザーエージェントに決済リクエストのためのユーザーとの対話を開始させます。
PaymentRequest.abort()安全なコンテキスト用-
ユーザーエージェントに決済リクエストを終わらせ、表示されている可能性のあるユーザーインターフェイスを除去させます。
イベント
merchantvalidation安全なコンテキスト用 非推奨-
一部の決済ハンドラー(Apple Pay など)では、
merchantvalidationイベントを処理するためにこのイベントハンドラーが呼び出されます。このイベントは、ユーザーエージェントが、決済リクエストをする販売者またはベンダーが正当であるかどうかを検証する必要があると、販売者に要求する場合に配信されます。 paymentmethodchange安全なコンテキスト用-
一部の決済ハンドラー(Apple Payなど)では、クレジットカードからデビットカードに切り替えるなど、ユーザーが決済手段を変更するたびに配信されます。
shippingaddresschange安全なコンテキスト用 非推奨 Non-standard-
ユーザーが配送先を変更するたびに配信されます。
shippingoptionchange安全なコンテキスト用 非推奨 Non-standard-
ユーザーが配送オプションを変更するたびに配信されます。
仕様書
| Specification |
|---|
| Payment Request API 1.1 # paymentrequest-interface |
ブラウザーの互換性
BCD tables only load in the browser