Google Standard Payments：银行卡 FOP

概览

Card FOP（付款方式）API 支持通过 标准卡片。包括信用卡和借记卡。其中有一个 为付款提供双消息流。

重要概念

Symbols & Conventions

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in these documents are to be interpreted as described in RFC 2119.

Timestamps

All timestamps are represented as milliseconds since the Unix epoch in UTC.

For example:

• August 14, 2010 16:30:00.00 AM GMT = 1281803400000
• November 6, 2007 9:37:00 PM MST = 1194410220000

Amounts

Monetary values in this API are represented using a format called "micros", a standard at Google. Micros are an integer based, fixed precision format. To represent a monetary value in micros, multiply the standard currency value by 1,000,000.

For example:

• USD$1.23 = 1230000 micro USD
• USD$0.01 = 10000 micro USD

Idempotency

All method calls within this API must have idempotent behavior. Simply put, integrators should not attempt to reprocess any request already successfully processed; the response for the successful processing should be reported instead. All methods have a common RequestHeader which contains a requestId. This requestId is the idempotency key for all calls.

For any non terminal answer (a non HTTP 200), it must not be idempotently processed. So a request that previously got a 400, when called a second time must not idempotently return 400, it must be re-evalutated. At re-evaluation, it could return a 400 or be processed successfully.

For more information on idempotency see this detailed guide.

预留拍摄流程

预留捕获流程是 哪些资金先预留，然后再收取。预订期间 不会发生资金流动。然后可以取消或捕获预订。通过 捕获或取消的最终结果会异步返回给 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

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