商家發起的交易 (MIT)

MIT 支援服務總覽

商家發起的交易 (MIT) 是指在使用者未處於有效工作階段時處理的交易。Google Pay 線上 API 的這項更新可為這些交易類型提供更清楚的資訊,透過專屬的帳單詳細資料使用者體驗提升使用者體驗,並改善付款連續性。

主要用途

  • 定期付款:數位串流服務、會員資格或公用事業。
  • 延後付款:飯店訂房、預購或逾時未到費用。
  • 自動加值:為大眾運輸或禮物卡加值。

實作 MIT API

MIT API 是現有 API 的擴充功能, LoadPaymentData 整合人員必須只包含一個 *TransactionInfo 物件,以指定帳單意圖。Google 會根據商家發起的交易類型提供 3 種選項:

交易類型 物件名稱 說明
週期性 RecurringTransactionInfo 用於固定頻率的收費。支援試用期、預付和後付帳單。
延遲 DeferredTransactionInfo 在預先設定的未來時間收取單筆費用。
自動重新載入 AutomaticReloadTransactionInfo 當餘額低於最低門檻時,用於重新載入儲值帳戶。

整合步驟

  1. 說明文件:在搶先體驗計畫期間存取開發人員網站。這三個新物件定義位於「物件參考」一節,並直接連結至上述清單。
  2. 實作:在 API 要求中,針對您的系統使用相關的 *TransactionInfo 物件。
    • 請注意,每次向 API 發出的要求只能傳遞一個物件。由個別商家決定要使用的物件並填入欄位。
  3. 測試:使用測試環境驗證帳單詳細資料是否正確顯示在薪資單中。
  4. 發布:確認參數後即可發布。

權杖生命週期管理 (TLM)

當安全付款權杖更新或停用時,權杖生命週期管理功能會提供即時通知,確保付款程序不中斷。如需完整詳細資料,請參閱 權杖生命週期管理說明文件

重要權杖事件

  • 停用/刪除:在權杖無法使用時發出通知。
  • FPAN 字尾更新:當底層的資金原有卡號更新時,就會發生這種情況。

伺服器設定需求

直接商家和付款服務供應商 (PSP) 必須建立系統,接收、解密及處理這些訊息。

規定 說明
端點 接收 POST 呼叫的安全 HTTPS 端點。
驗證 必須處理簽章驗證和訊息解密作業。
回應 傳回 SUCCESS 即可繼續傳送通知,傳回 TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE 則會停止傳送。
商家通知 PSP 必須向商家說明權杖狀態。

實作注意事項

必須將 tokenUpdateUrl 端點連同交易一併傳遞,才能接收權杖的更新。對於 PSP 而言,如何讓商家在相關的 *TransactionInfo 物件中接收及填入這個網址,是由 PSP 負責定義。

另請注意,加密酬載會為 MIT 傳回額外的選填欄位 merchantTokenId。如需具體詳情,請參閱 付款資料密碼編譯 說明文件 (適用於商家) 或酬載結構說明文件 (適用於 PSP)。