Google 標準付款：卡片 FOP

總覽

Card FOP (付款方式) API 支援透過 標準資訊卡。包括信用卡和簽帳金融卡。在單一 Pod 中 用於付款的雙訊息流程。

重要概念

符號和會議

這些文件中「必須」、「不得」、「必要」、「應」、「不應」、「應該」、「不應該」、「建議」、「可能」和「選用」等關鍵字均按照 RFC 2119 的說明使用。

時間戳記

所有時間戳記都以毫秒表示，自世界標準時間的 Unix 紀元開始計算。

例如：

• 2010 年 8 月 14 日，格林威治標準時間上午 16:30:00.00 = 1281803400000
• 2007 年 11 月 6 日下午 9:37:00 (美國標準時間) = 1194410220000

金額

這個 API 中的金額是以「微型」格式表示，這是 Google 的標準。微量是以整數為準的固定精確度格式。如要以微量表示金額，請將標準貨幣值乘以 1,000,000。

例如：

• $1.23 美元 = 12,30000 微秒
• $0.01 美元 = 10,000 微秒

冪等

這個 API 中的所有方法呼叫都必須具有冪等行為。簡單來說，整合商不應該嘗試重新處理任何已順利處理的要求，而應改為回報成功處理的回應。所有方法都有常見的 RequestHeader，其中包含 requestId。 requestId 是所有呼叫的冪等鍵。

非 HTTP 200 以外的任何終端機答案均不得以冪等方式處理。因此，先前在呼叫時取得 400 的要求，第二次呼叫時不得以冪等方式傳回 400，就必須重新評估。重新評估時，回應可能會傳回 400，或成功處理完畢。

如要進一步瞭解冪等性，請參閱這份詳細指南。

保留擷取流程

保留擷取流程是 系統會先預訂資金，之後還會擷取。預訂期間 也不會發生金錢移動這時您可以取消或擷取預訂項目。 擷取或取消作業的最終結果會以非同步的方式傳回 Google 然後透過通知來確認下列事項

付款整合商會導入

• reserveFunds
• asynchronousCaptureFundsReservation
• asynchronousCancelFundsReservation

Google 會

• captureFundsReservationResultNotification
• cancelFundsReservationResultNotification
• setAcquirerReferenceNumberForCaptureNotification

如要進一步瞭解保留額擷取，請參閱 詳細指南。

轉帳付款流程

資金轉帳流程是 由哪些資金直接擷取這個流程由單一方法組成 是由名為 Capture 的付款整合商實作。這個方法 同步檢查可用資金，如果成功就會擷取款項。

付款整合商會導入

• capture

Google 會

• setAcquirerReferenceNumberForCaptureNotification

如需轉帳付款的詳細資訊，請參閱 詳細指南。

退款流程

退款流程是用來退還之前支付的款項。 可透過預留擷取流程或 資金轉帳流程。

付款整合商會導入

• asynchronousRefund

Google 會

• refundResultNotification
• reverseRefundNotification
• setAcquirerReferenceNumberForRefundNotification

如要進一步瞭解退款事宜，請參閱這份詳細指南。

爭議流程

爭議流程。用於通知 Google 發生爭議，以及 客戶要求補償的退款。並非每次通話 這代表金錢移動，但此流程可用來將資金退還給客戶 或撤銷該物件，然後發還給 Google。這個流程適用於 除了詐欺檢舉流程以外 也不一定包括詐欺

Google 會

• inquiryNotification
• chargebackNotification
• chargebackReversedNotification

如要進一步瞭解爭議，請參閱這份詳細指南。

詐欺檢舉流程

詐欺檢舉流程旨在通知 Google 可能涉及詐欺行為這些資訊並未暗示任何金錢行動， 僅用於通知 Google 事件的風險引擎，讓整體詐騙行為能夠 可能可以減少像是爭議或交易退單 爭議流程。

Google 會

• fraudNotification

如要進一步瞭解詐欺檢舉，請參閱這篇文章 詳細指南。