Informações gerais
O URL "Gerar redirecionamento de pagamento" é uma alternativa ao fluxo Iniciar redirecionamento para iniciar um pagamento de redirecionamento com o integrador de pagamentos. Nesse fluxo, o Google vai enviar uma solicitação de servidor para servidor ao integrador de pagamentos para receber o URL a que o usuário será redirecionado no início do pagamento. O Google redirecionará o usuário para o URL informado pelo integrador, o que permitirá que o usuário pague com o emissor selecionado e, em seguida, será redirecionado de volta para o Google usando o fluxo Redirecionamento completo.
Como o fluxo funciona
O usuário pode selecionar o emissor de duas maneiras como forma de pagamento (FOP, na sigla em inglês).
- O usuário seleciona o emissor na interface do usuário (IU) do Google.
- O usuário seleciona o integrador na interface do Google e o emissor na interface do integrador.
O usuário seleciona o emissor na interface do Google
Nesse caso, o usuário seleciona um emissor durante a seleção da forma de pagamento na interface do Google. Portanto, o campo issuerId
do objeto formOfPayment
na solicitação de URL de pagamento de redirecionamento contém um identificador exclusivo gerado pelo Google que representa o emissor escolhido. Se o integrador de pagamentos e o emissor forem a mesma entidade, o Google vai gerar um issuerId
para o integrador de pagamentos.
Gerar fluxo de URL de redirecionamento de pagamento (emissor selecionado)
Veja a lista de objetos no diagrama acima:
- Usuário: a pessoa que quer fazer um pagamento.
- IU do Google: a interface da Web ou do app do Google em que o cliente inicia um pagamento.
- Servidor do Google: o servidor de back-end no Google que cria uma solicitação de redirecionamento.
- Integrador de pagamentos: o integrador em que o usuário seleciona um emissor.
- Emissor: o emissor em que o usuário tem uma conta.
Para o fluxo "Gerar URL de pagamento de redirecionamento", já presumimos que o usuário está na propriedade do Google (interface do Google) e está escolhendo uma forma de pagamento. É aqui que tudo começa.
- O usuário seleciona o emissor específico que quer usar para fazer um pagamento. É isso que aciona o fluxo "Gerar URL de pagamento de redirecionamento".
- A IU do Google chama o servidor do Google (back-end) para criar uma nova solicitação de redirecionamento.
- O servidor do Google chama o integrador de pagamentos hospedado GenerateRedirectPaymentUrl.
- O integrador vai responder ao Google com um URL para redirecionar o usuário ao site ou app do emissor.
- A solicitação de redirecionamento é enviada para a interface do Google.
- A interface do Google redireciona o usuário para a interface da Web do emissor.
- O usuário faz a autenticação na interface da Web do emissor.
- O usuário segue as instruções na tela para concluir o pagamento.
O usuário seleciona o integrador na interface do Google
Nesse caso, o usuário seleciona o integrador na interface do Google. Portanto, o campo formOfPayment
do URL de pagamento de redirecionamento será definido como noneChosen
, porque apenas os emissores são considerados FOPs válidas. O integrador precisa fornecer uma IU que permita que o usuário selecione um dos emissores aprovados pelo Google.
Gerar o fluxo do URL de pagamento de redirecionamento (integrador selecionado)
O diagrama de sequência a seguir mostra a interação entre o navegador do usuário, o Google, o integrador e o emissor quando o usuário seleciona um integrador na interface do Google: