Web Top-Up API

インテグレータは、チャージのためにユーザーをリダイレクトするウェブホストを実装する必要があります。このチャージは別のモダリティですが、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

100
チャージが完了しました。
201 ユーザーが手動でフローをキャンセルしたため、フローを中止する必要があります。
202 致命的な理由でチャージが失敗しているため、フローを中止する必要があります。

redirectRequestId string

必須: 元の/リダイレクト支払いリクエストの開始時に送信された requestId。Google はこれが送信された requestId と一致することを確認し、一致しない場合は完全なリダイレクト フローは失敗します。
gspTopUpResponse RedirectResponse

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