O redirecionamento de pagamentos pode ser iniciado de duas maneiras:
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.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 |
redirectRequest
|
RedirectRequest
OBRIGATÓRIO: o |