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 通知

Payment Integrator（付款集成商）会实现

• reserveFunds
• asynchronousCaptureFundsReservation
• asynchronousCancelFundsReservation

Google 实施

• captureFundsReservationResultNotification
• cancelFundsReservationResultNotification
• setAcquirerReferenceNumberForCaptureNotification

如需详细了解预留捕获，请参阅 详细指南。

资金转账流程

资金转账流程是以下项目中的单个消息流： 直接收取的资金该数据流由单个方法构成 由名为 Capture 的付款集成商实现。此方法 同步检查可用资金，并在成功时扣取资金。

Payment Integrator（付款集成商）会实现

• capture

Google 实施

• setAcquirerReferenceNumberForCaptureNotification

有关资金转账的更多信息，请参阅此 详细指南。

退款流程

退款流程用于退回以前退款 （通过预留捕获流程或 资金转账流程。

Payment Integrator（付款集成商）会实现

• asynchronousRefund

Google 实施

• refundResultNotification
• reverseRefundNotification
• setAcquirerReferenceNumberForRefundNotification

有关退款的更多信息，请参阅这份详细指南。

异议流程

异议流程。用于向 Google 通知争议， 客户要求退款的退款。并非每次通话 暗示资金流动，但此流程可用于将资金退回给客户， 或撤回相应请求，并将其返还给 Google。此流程可用于 添加到欺诈举报流程中，但 Google 不会 必须包括欺诈行为。

Google 实施

• inquiryNotification
• chargebackNotification
• chargebackReversedNotification

有关异议的详细信息，请参阅此详细指南。

欺诈举报流程

欺诈举报流程用于告知 Google 潜在的欺诈。此信息并不意味着任何资金流动， 用于将该事件告知 Google 风险引擎， 可以减少这可能伴随着争议或退款， 异议流程。

Google 实施

• fraudNotification

有关欺诈举报的更多信息，请参阅此 详细指南。