インテグレータは、チャージのためにユーザーをリダイレクトするウェブホストを実装する必要があります。このチャージは別のモダリティですが、Android チャージによって提供されるチャージと同じ目的です。このウェブホストには、モバイル フレンドリーなウェブサイトが必要です。
ウェブホストは、ユーザー エージェント ヘッダー値に基づいて、モバイルウェブ リクエストと PC ウェブ リクエストを判断する必要があります。モバイルウェブ リクエストに配信されるページは、Android および iOS のモバイルウェブ対応である必要があります。クライアントは、user-agent ヘッダー値の他に、ユーザーがリクエストを行っている環境(パソコンまたはウェブ)に関する他のヒントを提供しません。
サーバーは GET を使用して HTTPS プロトコルを実装する必要があります。パスとホストはインテグレータが定義できます。インテグレータは 2,048 文字の URL の長さをサポートする必要があります。これには、スキーム、ホスト、ポート、パス、パラメータが含まれます。
パラメータはすべて、URL エンコードの前に UTF-8 でエンコードされます。
リクエスト
リクエストに応じて Google は URL パラメータとして以下を提供します。
フィールド | |
---|---|
gspMajorVersion
|
int
このリクエストのメジャー バージョン番号。 |
gspTopUpRequest
|
TopUpRedirectRequest
チャージ リクエスト。 |
gspAssociationId
|
string
ユーザーがチャージするアカウントの認証情報を検索するためにインテグレータが使用する ID が含まれています。これは、AssociateAccountRequest におけるアカウントのリンク中に送信される関連付け ID です。 |
gspCallbackUrl
|
string
Google でチャージ フローを完了するためにユーザーをリダイレクトする URL。この値は URL エンコードされます。 |
レスポンス
チャージが完了したら、HTTPS GET を使用して gspCallbackUrl
にリダイレクトする必要があります。この URL には、次のクエリ パラメータが必要です。
フィールド | |||||||
---|---|---|---|---|---|---|---|
gspResult
|
int
|
||||||
redirectRequestId |
string 必須: 元の/リダイレクト支払いリクエストの開始時に送信された requestId 。Google はこれが送信された requestId と一致することを確認し、一致しない場合は完全なリダイレクト フローは失敗します。 |
||||||
gspTopUpResponse |
必須: PGP または JWE+JWS を使用して TopUpRedirectResponse の暗号化と署名を行う必要があります。さらに、この値はウェブセーフな base64 でエンコードする必要があります。 |