決済リクエスト API
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
決済リクエスト API (Payment Request API) は、販売者とユーザーの両方に、一貫したユーザー体験を提供します。これは新しい決済方法ではなく、ユーザーが自分の好きな決済方法を選択し、その情報を販売者が利用できるようにするための方法です。
決済リクエストの概念と利用方法
オンラインショッピングのカート放棄に関連する多くの問題は、チェックアウトフォームに起因する可能性があります。これは入力が難しく時間がかかり、完了するまでに複数の手順が必要になることがよくあるからです。決済リクエスト API はオンライン決済を完了するために必要な手順を減らし、チェックアウトフォームを廃止する可能性があることを意図しています。これは、ユーザーの詳細な情報を記憶し、 HTML フォームを必要とせずに販売者に渡されることで、チェックアウトプロセスを簡単にすることを目的としています。
決済をリクエストするには、ウェブページは、「購入」ボタンをクリックするなど、決済を開始するユーザー操作に応答して PaymentRequest
オブジェクトを作成します。PaymentRequest
を使用すると、ユーザーが取引を完了するための入力を提供している間、ウェブページでユーザーエージェントと情報を交換できます。
完全なガイドは、決済リクエスト API の使用を参照してください。
メモ:
オリジンを跨いだ <iframe>
要素内では、allowpaymentrequest
属性が設定されている場合のみ、 API が利用可能です。
インターフェイス
PaymentAddress
-
住所情報を含むオブジェクト。例えば、請求先住所や配送先住所に使用されます。
PaymentRequest
-
ユーザーエージェントの決済インターフェイスを作成および管理するための API を提供するオブジェクト。
PaymentRequestEvent
-
PaymentRequest
が行われたときに決済ハンドラーに配信されるイベント。 PaymentRequestUpdateEvent
-
ユーザーの操作に応じて、ウェブページが決済リクエストの詳細を更新できるようにします。
PaymentMethodChangeEvent
-
ユーザーが決済手段を変更することを表します(例 : クレジットカードからデビットカードへの切り替え)。
PaymentResponse
-
ユーザーが決済手段を選択し、決済リクエストを承認した後に返されるオブジェクト。
MerchantValidationEvent
-
販売者(ウェブサイト)が具体的な決済ハンドラー(例えば Apple Pay が使用できるものとして登録されているもの)の使用を許可されていることを検証することを要求するブラウザーを表します。
辞書
AddressErrors
-
エラーのある
PaymentAddress
項目に、エラーの説明文を提供する文字列を含む辞書。 PaymentDetailsUpdate
-
決済インターフェイスのインスタンス化の後で、ユーザーが対話を始める前、サーバーが情報を更新する必要がある場合に、決済の詳細に対して行われる必要がある変更を記述したオブジェクト。
仕様書
Specification |
---|
Payment Request API # paymentrequest-interface |
ブラウザーの互換性
BCD tables only load in the browser