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