トークンの更新フロー

概要

インテグレータによっては、支払いトークンの有効期限が切れる場合があります。この場合、トークンの有効期限が近づくと、Google はユーザーの認証を再度行い、トークンの有効期限を延長します。これを、更新トークンのフロー（再関連付けフロー）と呼びます。このフローでは、インテグレータは支払いトークンの有効期限が切れるときに Google に通知します。

注: トークンの最小存続期間は 1 年間です。

フローの仕組み

トークンの有効期限が切れている場合、または有効期限が近づいている場合は、このフローに沿って有効期限の更新処理が行われます。

更新トークンのフロー

上記の図に示されたオブジェクトのリストは次のとおりです。

• Google サーバー: キャプチャ コマンドを決済インテグレーター サーバーに送信する Google のバックエンド サーバー。
• 決済インテグレータ サーバー: 資金回収のリクエストを受け入れるインテグレータのバックエンド サーバー。

このフローでは、トークンの有効期限が切れているか、有効期限が近づいています。アクションは決済インテグレータ サーバーから始まります。

1. 決済インテグレータ サーバーは、トークンの有効期限が切れているか、有効期限が近づいていることを Google サーバーに通知します。
2. Google サーバーは、refreshToken メッセージを決済インテグレータ サーバーに送信します。これには、認証の証明としての authenticationRequestId と GPT が含まれます。
3. 決済インテグレータ サーバーは、トークンを新しい有効期限で更新します。これは、元のトークンの有効期限が切れているかどうかにかかわらず発生することがあります。
4. 決済インテグレータ サーバーは Google サーバーに成功メッセージを送信します。

注: インテグレータは、最初の関連付けが拒否されるのと同じ理由で、更新を拒否することもできます。

ベスト プラクティスとその他の考慮事項

決済インテグレータ サーバーに送信される googlePaymentToken は新しいトークンではなく、associateAccount を介してすでに確立されている既存のトークンです。トークンが不明な場合は、FAILED_PRECONDITION というエラー メッセージが返されます。