Forma de pagamento de redirecionamento
Informações gerais
O Google Standard Payments é compatível com Formas de pagamento (FOPs, na sigla em inglês) baseadas em redirecionamento. Com uma FOP de redirecionamento, os usuários de produtos ou serviços do Google podem pagar por eles na interface da Web de uma entidade externa. De modo geral, um usuário que quer pagar por produtos é inicialmente redirecionado para um integrador de pagamentos ou para um emissor disponível por meio de um integrador de pagamentos. Se o usuário for redirecionado para o integrador, ele precisará encaminhar o usuário para a interface da Web do emissor para concluir a compra. Depois que o pagamento for concluído, o usuário será redirecionado para o Google pelo integrador.
O Google usa dois fluxos principais para concluir um pagamento FOP de redirecionamento:
- Iniciar o redirecionamento: há dois fluxos diferentes que podem iniciar um pagamento de redirecionamento. O integrador de pagamentos só precisa implementar uma destas opções:
- Iniciar fluxo de redirecionamento: inicia um pagamento redirecionando o usuário para o integrador de pagamentos.
- Gerar o fluxo de URL de redirecionamento de pagamento: o Google inicia um pagamento enviando uma solicitação de servidor para servidor ao integrador de pagamentos para gerar um URL de redirecionamento de pagamento. Com base na resposta, o Google redireciona o usuário diretamente para o emissor.
- Fluxo de redirecionamento completo: depois que o usuário concluir a compra, o integrador vai usar esse fluxo para confirmar o pagamento com o Google.
Por fim, todo o movimento de dinheiro entre o banco do integrador e o banco do Google é feito no fluxo de remessa.
Visão geral do FOP de redirecionamento
A figura a seguir ilustra uma visão geral ampla dos fluxos:
De modo geral, a inclusão do seu serviço como uma forma de pagamento nos produtos do Google envolve os seguintes fluxos:
- Inicie o redirecionamento:
- Fluxo de redirecionamento completo
- Fluxo de reembolso
- Fluxo de remessa
Conceitos e terminologia
Símbolos e convenções
As palavras-chave "PRECISA", "NÃO PODE", "OBRIGATÓRIO", "DEVE", "NÃO DEVE", "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 em milissegundos desde a época Unix (1o de janeiro de 1970) em UTC.
Exemplo:
- 23 de abril de 2019, 20:23:25 GMT = 155.6051005.000 milissegundos
- 16 de agosto de 2018, 12h28min35s GMT = 1534422515000 milissegundos
Valores
Os valores monetários nesta API estão no formato "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. O Google repetirá as solicitações esporadicamente para garantir que as transações estejam no mesmo estado em ambos os lados. Os integradores não podem tentar reprocessar solicitações já processadas. A resposta de processamento bem-sucedido deve 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.
Qualquer resposta que não seja de terminal (uma operação sem HTTP 200) não pode ser processada de maneira idempotente. Portanto, uma solicitação que anteriormente recebeu um erro 400 (solicitação inválida/pré-condição com falha), quando chamada pela segunda vez, não deve retornar 400 de maneira idempotente, ela precisa ser reavaliada. Na reavaliação, ela pode retornar um erro 400 ou ser processada.
Para mais informações sobre idempotência, consulte este guia detalhado.
Integrador
Uma empresa que usa a plataforma de pagamentos do Google nos negócios. Pode ser um conteúdo interno (próprio, como YouTube ou Google AdWords) ou uma empresa externa (3P) que quer integrar o serviço para trabalhar com o ecossistema do Google.
Forma de pagamento
Forma de Pagamento. Isso é mais geral do que um instrumento. Visa, MasterCard e PayPal são FOPs.
Instrumento
Uma instância específica de uma forma de pagamento realizada por um cliente específico. Por exemplo, o cartão de crédito de um usuário ou a conta do PayPal dele. Uma FOP tokenizada para um cliente específico também é um instrumento, porque é uma instância de uma forma de pagamento para aquele cliente, armazenada com segurança no nosso sistema.
Token
Uma representação no sistema do Google da forma de pagamento de um usuário específico. Como ele contém todas as informações necessárias para fazer uma compra, o token também é um instrumento. Isso pode incluir informações como um número de conta que o usuário tem no integrador.
Fluxos de chaves
Iniciar o fluxo de redirecionamento
A primeira etapa do pagamento de redirecionamento é o fluxo "Iniciar redirecionamento". O objetivo do fluxo de início de redirecionamento é redirecionar o usuário, por meio do integrador, para a interface da Web do emissor escolhido para autorizar um pagamento. Após o redirecionamento, o Google fornece informações básicas da transação para o integrador, que as encaminha ao emissor.
Para mais informações, consulte a seção Iniciar fluxo de redirecionamento.
Fluxo de redirecionamento completo
Quando o usuário estiver na interface da Web do emissor, ele precisará executar todas as etapas necessárias para concluir um pagamento. Essas etapas podem mudar dependendo do emissor. Como parte do fluxo de redirecionamento completo, o emissor precisa redirecionar o usuário de volta ao integrador com informações sobre o pagamento bem-sucedido. O integrador, por sua vez, redirecionará o usuário de volta para o Google, incluindo os detalhes de pagamento como parte da resposta de redirecionamento. Depois que o pagamento for confirmado, o Google fornecerá os produtos ou serviços comprados ao usuário.
Para mais informações, consulte a seção Fluxo de redirecionamento completo.