Google 標準付款：卡片 FOP

總覽

Card FOP (付款方式) API 支援使用標準卡片付款。可以是信用卡和簽帳金融卡。付款時，系統會提供單一和雙重訊息的流程。

重要概念

符號和會議

這些文件中「必須」、「不得」、「必要」、「應」、「不應」、「應該」、「不應該」、「建議」、「可能」和「選用」等關鍵字均按照 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 的資格。除了詐欺檢舉流程外，這個流程也可使用，但不一定會將詐欺行為納入其中。

Google 實施

• inquiryNotification
• chargebackNotification
• chargebackReversedNotification

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

詐欺檢舉流程

「詐欺回報流程」是用來通知 Google 潛在的詐欺行為。這項資訊不代表任何金錢流動，只會用來通知 Google 的 Risk Engine 事件，以減少整體詐欺事件。可以透過爭議流程與爭議或交易退單一併提供。

Google 實施

• fraudNotification

如要進一步瞭解詐欺報告，請參閱這份詳細指南。