Iniciar fluxo de redirecionamento

Os pagamentos de redirecionamento podem ser iniciados de duas maneiras diferentes:

  1. Quando o usuário selecionar "Redirecionar pagamento", ele será redirecionado para a no site do integrador para selecionar a forma de pagamento (FOP, na sigla em inglês) a ser usada. Neste caso, o noFopChosen será preenchido na solicitação. Quando isso acontece, o integrador vai mostrar ao usuário uma lista de emissores disponíveis. Uma vez o usuário selecionar uma delas, ele será encaminhado para a rede site/app para concluir a compra.

  2. O usuário selecionará uma FOP (emissor) durante o fluxo de compra. Nesse caso, O Google vai preencher o issuerId na solicitação e redireciona o usuário para o integrador. Quando o integrador receber isso, deverá redirecionar o usuário imediatamente para a site/app do emissor para concluir a compra.

.

Nos dois casos acima, o Google vai redirecionar o usuário diretamente para o do integrador sem nenhuma chamada anterior de servidor para servidor do Google.

O integrador precisa implementar um protocolo HTTPS usando GET. Os parâmetros GET, descritos em Parâmetros da solicitação de redirecionamento, contêm informações sobre o pagamento de redirecionamento solicitado.

O integrador precisa oferecer suporte a tamanhos de URL de 2.048 caracteres. Isso inclui esquema, host, porta, caminho e parâmetros. Todos os parâmetros serão codificados em UTF-8 antes de serem codificados para uso em URLs.

Solicitação de redirecionamento

Veja um exemplo do URL para o qual o usuário será redirecionado como parte do Iniciar fluxo de redirecionamento (também conhecido como solicitação de redirecionamento):

https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H

O valor decodificado pelo URL do parâmetro callbackUrl neste exemplo é:

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE

O parâmetro redirectRequest é criptografado e assinado usando PGP ou JWE+JWS antes de ser codificado com base64url.

Parâmetros da solicitação de redirecionamento

A solicitação GET HTTPS precisa ter os seguintes parâmetros de consulta:

Campos
callbackUrl string

URL para redirecionar o usuário quando um pagamento for concluído. Esse valor é codificado por URL e tem tamanho máximo de 512 caracteres.

Esse URL vai incluir o requestId do arquivo redirectRequest no GET redirectRequestId . O fornecedor precisa validar se o redirectRequestId do callbackUrl e do requestId do payload criptografado são idênticos a verificar se ambos estão relacionados.

redirectRequest RedirectRequest

OBRIGATÓRIO: o RedirectRequest precisam ser criptografados e assinados usando PGP ou JWE+JWS (link em inglês). Além disso, esse valor deve ser seguro para a Web base64 codificado.