Iniciar fluxo de redirecionamento

O redirecionamento de pagamentos pode ser iniciado de duas maneiras:

  1. Quando o usuário seleciona "Redirecionar pagamento", ele é redirecionado ao site do integrador para selecionar a forma de pagamento (FOP, na sigla em inglês) a ser usada. Nesse caso, o noFopChosen será preenchido na solicitação. Quando isso acontece, o integrador mostra ao usuário uma lista de emissores disponíveis. Depois que o usuário selecionar uma dessas opções, ele será encaminhado ao site/app do emissor para concluir a compra.

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

Nos dois casos acima, o Google vai redirecionar o usuário diretamente para o site 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 de solicitação de redirecionamento, contêm informações sobre o pagamento de redirecionamento solicitado.

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

Solicitação de redirecionamento

Confira um exemplo do URL para o qual o usuário será redirecionado como parte do fluxo "Iniciar 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 por 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 HTTPS GET 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 em um URL e tem um tamanho máximo de 512 caracteres.

Esse URL incluirá o requestId do redirectRequest criptografado no parâmetro redirectRequestId GET. O fornecedor precisa validar se o redirectRequestId do callbackUrl e o requestId do payload criptografado são idênticos para verificar se ambos estão relacionados.

redirectRequest RedirectRequest

OBRIGATÓRIO: o RedirectRequest precisa ser criptografado e assinado usando PGP ou JWE+JWS. Além disso, esse valor precisa ser codificado em base64, que é seguro para a Web.