Google Standard Payments：银行卡 FOP

概览

Card FOP（付款方式）API 支持使用标准卡进行付款。可以是信用卡和借记卡。付款支持单消息流和双消息流。

重要概念

符号与惯例

本文档中的“必须”“不得”“必需”“会”“不会”“应”“不应”“建议”“可以”和“非强制”等关键字应按 RFC 2119 中的说明进行解释。

时间戳

所有时间戳均以自世界协调时间 (UTC) 的 Unix 纪元以来的毫秒数表示。

例如：

• 2010 年 8 月 14 日上午 16:30:00.00 (GMT) = 1281803400000
• MST 2007 年 11 月 6 日晚上 9:37:00 = 1194410220000

金额

此 API 中的货币值使用 Google 的一项标准“micros”表示。微单位是一种基于整数的固定精度格式。如需以微单位表示货币价值，请用标准货币价值乘以 1,000,000。

例如：

• 1.23 美元 = 1230000 微美元
• 0.01 美元 = 10000 微美元

幂等性

此 API 中的所有方法调用都必须具有幂等行为。简而言之，集成商不应尝试重新处理任何已经成功处理的请求，而应报告成功处理的响应。所有方法都有一个包含 requestId 的通用 RequestHeader。 此 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

如需详细了解欺诈报告，请参阅此详细指南。