Iniciar flujo de redireccionamiento

Los pagos mediante redireccionamiento pueden iniciarse de dos maneras diferentes:

1. Cuando el usuario seleccione “Redireccionar el pago”, se lo redireccionará al sitio web del integrador para que seleccione la forma de pago (FOP) que desea usar. En este caso, el noFopChosen se propagará en la solicitud. Cuando esto sucede, el integrador le mostrará al usuario una lista de las entidades emisoras disponibles. Una vez que el usuario seleccione una de estas opciones, se lo redireccionará al sitio web o la app de esa entidad emisora para completar la compra.

2. El usuario seleccionará una FOP (emisor) durante el flujo de compra. En este caso, Google propagará el parámetro issuerId en la solicitud y redireccionará al usuario al integrador. Cuando el integrador recibe esto, debe redireccionar de inmediato al usuario al sitio web o la app de la entidad emisora para completar la compra.

Nota: El integrador de pagos y la entidad emisora pueden ser la misma entidad.

En los dos casos anteriores, Google redireccionará al usuario directamente al sitio web del integrador sin ninguna llamada anterior de Google entre servidores.

El integrador debe implementar un protocolo HTTPS con GET. Los parámetros GET, que se describen en Parámetros de solicitud de redireccionamiento, contendrán información sobre el pago de redireccionamiento solicitado.

El integrador debe admitir longitudes de URL de 2,048 caracteres. Esto incluye el esquema, el host, el puerto, la ruta de acceso y los parámetros. Todos los parámetros se codificarán en UTF-8 antes de codificarse como URL.

Solicitud de redireccionamiento

Este es un ejemplo de la URL a la que se redireccionará al usuario como parte del flujo de iniciar redireccionamiento (también conocido como solicitud de redireccionamiento):

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

El valor decodificado de URL del parámetro callbackUrl en este ejemplo es el siguiente:

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

El parámetro redirectRequest se encripta y se firma con PGP o JWE+JWS antes de codificarse en base64url.

Parámetros de la solicitud de redireccionamiento

La solicitud GET HTTPS debe tener los siguientes parámetros de consulta:

Campos
callbackUrl	string URL a la que se redireccionará al usuario cuando se complete un pago. Este valor está codificado en formato URL y tiene una longitud máxima de 512 caracteres. Esta URL incluirá el requestId del redirectRequest encriptado en el parámetro GET de redirectRequestId. El proveedor debe validar que el redirectRequestId del callbackUrl y el requestId de la carga útil encriptada sean idénticos para verificar que ambos estén relacionados.
redirectRequest	RedirectRequest OBLIGATORIO: El RedirectRequest se debe encriptar y firmar con PGP o JWE+JWS. Además, este valor debe estar codificado en base64 seguro para la Web.