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
Símbolos e convenções
As palavras-chave "PRECISA", "NÃO PODE", "OBRIGATÓRIO", "DEVE", "NÃO DEVERÁ", "DEVE", "NÃO DEVE", "RECOMENDADO", "PODE" e "OPCIONAL" nestes documentos devem ser interpretadas conforme descrito na RFC 2119 (em inglês).
Marcações de tempo
Todos os carimbos de data/hora são representados como milissegundos desde a época Unix em UTC.
Exemplo:
- 14 de agosto de 2010, 16h30min GMT = 1281803400000
- 6 de novembro de 2007 21h37min MST = 1194410220000
Valores
Os valores monetários nesta API são representados com um formato chamado "micros", um padrão do Google. Micros são um formato de precisão fixa e baseado em números inteiros. Para representar um valor monetário em micros, multiplique o valor da moeda padrão por 1.000.000.
Exemplo:
- USD 1,23 = 1230.000 micro USD
- USD 0,01 = 10.000 micro USD
Idempotência
Todas as chamadas de método nessa API precisam ter comportamento idempotente. Simplificando, os integradores não devem tentar reprocessar qualquer solicitação já processada com sucesso. A resposta do processamento bem-sucedido precisa ser informada. Todos os métodos têm um RequestHeader comum que contém um requestId. Esse requestId é a chave de idempotência para todas as chamadas.
Para qualquer resposta não terminal (um 200 que não seja HTTP), ela não pode ser processada de maneira idempotente. Portanto, uma solicitação que anteriormente recebia um erro 400, quando chamada uma segunda vez, não poderia retornar 400 de maneira idempotente, ela precisa ser reavaliada. Na reavaliação, ela pode retornar um erro 400 ou ser processada com sucesso.
Para mais informações sobre idempotência, consulte este guia detalhado.
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.