MIT サポートの概要
販売者主導型取引（MIT）は、ユーザーがセッションに積極的に参加することなく処理される取引です。Google Pay Online API の今回の更新では、これらの取引タイプに対する可視性の向上、専用の請求先詳細 UX によるユーザー エクスペリエンスの改善、支払いの継続性の向上が実現しています。
主なユースケース
- 定期的な支払い: デジタル ストリーミング サービス、メンバーシップ、公共料金。
- 後払い: ホテルの予約、事前注文、無断キャンセル料。
- 自動リロード: 交通機関やギフトカードのバリューのチャージ。
MIT API の実装
MIT API は、既存の
loadPaymentData
API の拡張機能です。インテグレータは、請求の意図を指定するために、*TransactionInfo オブジェクトを 1 つだけ含める必要があります。Google は、販売者主導型取引のタイプに応じて 3 つのオプションを提供しています。
| 取引の種類 | オブジェクト名 | 説明 |
|---|---|---|
| 定期的 | RecurringTransactionInfo |
固定頻度の請求に使用されます。トライアル、前払い、後払いの請求をサポートしています。 |
| 後払い | DeferredTransactionInfo |
事前に決定された将来の時点で 1 回の請求を行うために使用されます。 |
| 自動リロード | AutomaticReloadTransactionInfo |
残高が最小しきい値を下回ったときに、バリュー アカウントをリロードするために使用されます。 |
統合の手順
- ドキュメント: 早期アクセス プログラム期間中に DevSite にアクセスします。 3 つの新しいオブジェクト定義は、オブジェクト リファレンス セクションにあり、 上記のリストから直接リンクされています。
- 実装: API リクエストで、システムに関連する
*TransactionInfoオブジェクトを使用します。- API へのリクエストごとに渡せるオブジェクトは 1 つだけです。 使用するオブジェクトを決定してフィールドに入力するのは、 個々の販売者の責任です。
- テスト: テスト環境を使用して、請求先詳細が ペイシートに正しく表示されることを検証します。
- リリース: パラメータが検証されたら、公開します。
トークン ライフサイクル管理（TLM）
トークン ライフサイクル管理では、安全な支払いトークンが更新または無効化されたときにリアルタイム通知を提供することで、支払いの継続性を確保します。詳しくは、 トークン ライフサイクル管理のドキュメント をご覧ください。
主なトークン イベント
- 無効化/削除: トークンが使用できなくなったときに通知します。
- FPAN サフィックスの更新: 基盤となる資金調達プライマリ アカウント 番号が更新されたときに発生します。
サーバー設定の要件
直接販売者と決済サービス プロバイダ（PSP）は、これらのメッセージを受信、復号、処理するシステムを確立する必要があります。
| 要件 | 説明 |
|---|---|
| エンドポイント | POST 呼び出しを受信する安全な HTTPS エンドポイント。 |
| 認証 | 署名の検証とメッセージの復号を処理する必要があります。 |
| レスポンス | 通知を続行するには SUCCESS を返し、通知を停止するには TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE を返します。 |
| 販売者への通知 | PSP は、トークンのステータスを販売者に通知する必要があります。 |
実装上の注意
トークンの更新を受け取るには、取引とともに tokenUpdateUrl エンドポイントを渡す必要があります。PSP の場合、販売者が関連する *TransactionInfo オブジェクトでこの URL を受信して入力する方法を決定するのは、PSP の責任です。
また、暗号化されたペイロードは、MIT 用に追加の省略可能なフィールド merchantTokenId を返します。詳しくは、
支払いデータの暗号方式
のドキュメント（販売者向け）または
ペイロード構造
のドキュメント（PSP 向け）をご覧ください。