Visão geral
A API Card FOP (forma de pagamento) aceita pagamentos feitos com cartões padrão. Podem ser cartões de crédito e débito. Há uma camada fluxo de mensagem dupla fornecido para pagamentos.
Conceitos importantes
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.
Fluxo de captura de reserva
O fluxo de captura de reserva é um fluxo de duas mensagens quais fundos são primeiro reservados e depois capturados. Durante a reserva nenhuma movimentação de dinheiro ocorre. A reserva pode ser cancelada ou capturada. A o resultado final da captura ou do cancelamento é retornado de forma assíncrona ao Google por uma notificação.
O integrador de pagamentos implementa
O Google implementa
captureFundsReservationResultNotificationcancelFundsReservationResultNotificationsetAcquirerReferenceNumberForCaptureNotification
Para mais informações sobre a captura de reserva, consulte guia detalhado.
Fluxo de transferência de fundos
O fluxo de transferência de fundos é um único fluxo de mensagens em
quais fundos são capturados diretamente. O fluxo é composto por um único método que
é implementado pelo integrador de pagamentos Capture. Esse método
verifica de forma síncrona se há fundos disponíveis e os captura, se forem bem-sucedidos.
O integrador de pagamentos implementa
O Google implementa
Para mais informações sobre transferência de fundos, guia detalhado.
Fluxo de reembolso
O fluxo de reembolso é usado para devolver fundos que foram anteriormente é capturada pelo fluxo de captura de reserva ou pelo fluxo de transferência de fundos.
O integrador de pagamentos implementa
O Google implementa
Para mais informações sobre reembolsos, consulte este guia detalhado.
Fluxo de disputa
O fluxo de disputa. é usado para informar o Google sobre disputas e estornos em que o cliente está solicitando um reembolso. Nem todas as ligações implica movimentação de dinheiro, mas esse fluxo pode ser usado para devolver fundos a um cliente, ou reverter isso e retorná-los ao Google. Esse fluxo pode ser usado em além do fluxo de denúncia de fraudes, mas não incluem necessariamente fraudes.
O Google implementa
Para mais informações sobre disputas, consulte este guia detalhado.
Fluxo de relatórios de fraude
O fluxo de denúncia de fraudes serve para informar o Google sobre possíveis fraudes. Essas informações não implicam nenhum movimento de dinheiro e são simplesmente usado para informar o mecanismo de risco do Google sobre o evento para que as fraudes gerais podem ser reduzidos. Isso pode ser acompanhado por uma disputa ou estorno pelo fluxo de disputa.
O Google implementa
Para mais informações sobre denúncias de fraude, acesse guia detalhado.