リダイレクト フローを開始

リダイレクトによるお支払いは、次の 2 つの方法で開始できます。

  1. ユーザーが [お支払い方法のリダイレクト] を選択すると、インテグレータのウェブサイトにリダイレクトされ、使用するお支払い方法（FOP）を選択します。この場合、リクエストで noFopChosen が入力されます。この場合、インテグレータは利用可能な発行者のリストをユーザーに表示します。ユーザーがこのいずれかを選択すると、ユーザーはそのカード発行会社のウェブサイト/アプリに転送され、購入を完了します。

  2. お客様は購入フロー中に FOP（カード発行会社）を選択します。この場合、Google はリクエストの issuerId パラメータを入力し、ユーザーをインテグレータにリダイレクトします。インテグレータはこれを受け取ったら、すぐにカード発行会社のウェブサイト/アプリにリダイレクトして購入を完了する必要があります。

どちらの場合も、Google が事前にサーバー間呼び出しを行うことなく、Google はユーザーをインテグレータのウェブサイトに直接リダイレクトします。

インテグレータは、GET を使用して HTTPS プロトコルを実装する必要があります。リダイレクト リクエスト パラメータで説明されている GET パラメータには、リクエストされたリダイレクト支払いに関する情報が含まれます。

インテグレータは 2,048 文字の URL をサポートする必要があります。これには、スキーム、ホスト、ポート、パス、パラメータが含まれます。URL エンコードが行われる前に、すべてのパラメータは UTF-8 でエンコードされます。

リダイレクト リクエスト

リダイレクト開始フロー（リダイレクト リクエストとも呼ばれます）の一環としてユーザーがリダイレクトされる URL の例を次に示します。

https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H

この例で URL デコードされた callbackUrl パラメータの値は次のようになります。

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE

redirectRequest パラメータは、base64url でエンコードされる前に、PGP または JWE+JWS を使用して暗号化および署名されます。

リダイレクト リクエストのパラメータ

HTTPS GET リクエストには、次のクエリ パラメータが必要です。

フィールド
callbackUrl string

支払いが完了したときにユーザーをリダイレクトする URL。この値は URL エンコードされ、最大長は 512 文字です。

この URL の redirectRequestId GET パラメータに、暗号化された redirectRequest の requestId が含まれます。ベンダーは、callbackUrl の redirectRequestId と暗号化されたペイロードの requestId が同一であることを検証し、両方が関連していることを検証する必要があります。
redirectRequest RedirectRequest

必須: RedirectRequest の暗号化と署名には、PGP または JWE+JWS を使用する必要があります。さらに、この値はウェブセーフな base64 でエンコードする必要があります。