Pagamentos padrão do Google: forma de pagamento do cartão

Informações gerais

A API Card FOP (forma de pagamento) é compatível com pagamentos feitos usando cartões padrão. As opções são cartões de crédito e débito. Há um fluxo de mensagens únicas e duplas 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 em que os fundos são primeiro reservados e depois capturados. Durante a reserva, não ocorre nenhum movimento de dinheiro. Depois disso, a reserva pode ser cancelada ou capturada. O resultado final da captura ou do cancelamento é retornado de forma assíncrona ao Google por meio de uma notificação.

O integrador de pagamentos implementa

O Google implementa

Para mais informações sobre captura de reserva, consulte este guia detalhado.

Fluxo de transferência de fundos

O fluxo de transferência de fundos é um fluxo de mensagens único em que os fundos são capturados diretamente. O fluxo é composto por um único método implementado pelo integrador de pagamentos chamado Capture. Esse método verifica de maneira síncrona se há fundos disponíveis e captura os fundos se for bem-sucedido.

O integrador de pagamentos implementa

O Google implementa

Para mais informações sobre transferência de fundos, consulte este guia detalhado.

Fluxo de reembolso

O fluxo de reembolso é usado para devolver fundos que foram capturados anteriormente por meio do fluxo de captura de reserva ou do 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 (link em inglês) é usado para informar o Google sobre disputas e estornos em que o cliente está solicitando reembolso. Nem todas as ligações significam movimento de dinheiro, mas esse fluxo pode ser usado para devolver o valor ao cliente ou reverter e devolvê-lo ao Google. Esse fluxo pode ser usado além do fluxo de relatórios de fraudes, mas não necessariamente inclui fraudes.

O Google implementa

Para mais informações sobre disputas, consulte este guia detalhado.

Fluxo de relatórios de fraude

O fluxo de relatório de fraudes serve para informar o Google sobre uma possível fraude. Essas informações não implicam qualquer movimentação de dinheiro e são simplesmente usadas para informar o Mecanismo de Risco do Google sobre o evento para que as fraudes gerais possam ser reduzidas. Esse processo pode ser acompanhado de uma disputa ou estorno pelo fluxo de disputa.

O Google implementa

Para mais informações sobre relatórios de fraude, consulte este guia detalhado.