API de Web Top-Up

Los integradores deben implementar un host web para redireccionar a los usuarios con fines de recarga. Esta recarga es una modalidad diferente, pero tiene el mismo propósito que la que proporcionan las Recargas de Android. Este host web debe tener un sitio web optimizado para dispositivos móviles.

El host web debe determinar las solicitudes web para dispositivos móviles y las solicitudes web para computadoras en función del valor del encabezado de usuario-agente. La página entregada en solicitudes de Web móvil debe estar optimizada para la Web móvil en iOS y Android. Además del valor del encabezado del usuario-agente, el cliente no te proporcionará ninguna otra sugerencia sobre el entorno en el que este usuario realiza la solicitud (computadora de escritorio o Web).

El servidor debe implementar un protocolo HTTPS con GET. El integrador puede definir la ruta y el host. 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

Cuando se lo solicita, Google proporciona los siguientes como parámetros de URL:

Campos
gspMajorVersion int

Es el número de la versión principal de esta solicitud.

gspTopUpRequest TopUpRedirectRequest

Solicitud de recarga

gspAssociationId string

Contiene un identificador que el integrador usa para buscar las credenciales de la cuenta que el usuario está completando. Este es el ID de asociación que se envía durante la vinculación de la cuenta en AssociateAccountRequest.

gspCallbackUrl string

URL a la que se redireccionará al usuario para finalizar el flujo de recarga en Google. Este valor está codificado en URL.

Respuesta

Cuando se complete la recarga, se deberá redireccionar al usuario a gspCallbackUrl mediante HTTPS GET. Esta URL debe tener los siguientes parámetros de búsqueda:

Campos
gspResult int

100
La recarga se realizó correctamente.
201 El usuario canceló el flujo de forma manual y este debería anularse.
202 La recarga falló por un motivo irrecuperable y el flujo debe anularse.

redirectRequestId string

OBLIGATORIO: El requestId que se envió en la solicitud de pago por redireccionamiento original o en el que se inició el proceso. Google verificará que coincida con el requestId enviado, y el flujo de redireccionamiento completo fallará si no coincide.
gspTopUpResponse RedirectResponse

OBLIGATORIO: El TopUpRedirectResponse se debe encriptar y firmar con PGP o JWE+JWS. Además, este valor debe estar codificado en base64 seguro para la Web.