Forma de pago de redireccionamiento
Descripción general
Los pagos estándar de Google admiten formas de pago (FOP) basadas en redireccionamiento. Una forma de pago de redireccionamiento permite que los usuarios de los productos o servicios de Google paguen por ellas en la interfaz web de una entidad externa. En términos generales, al principio, se redirecciona a un usuario que desea pagar bienes a un integrador de pagos o a una entidad emisora disponible mediante un integrador de pagos. Si se redirecciona al usuario al integrador, este debe redirigirlo a la interfaz web de la entidad emisora para completar la compra. Una vez que se complete el pago, se debería redireccionar al usuario de vuelta a Google a través del integrador.
Google utiliza dos flujos principales para completar un pago de FOP de redireccionamiento:
- Iniciar redireccionamiento: Existen dos flujos diferentes que pueden iniciar un pago por redireccionamiento. El integrador de pagos solo debería implementar una de estas opciones:
- Iniciar el flujo de redireccionamiento: Redirecciona al usuario al integrador de pagos para iniciar un pago.
- Flujo de generación de URL de pago de redireccionamiento: Google inicia un pago mediante el envío de una solicitud de servidor a servidor al integrador de pagos para generar una URL de pago de redireccionamiento. Según la respuesta, Google redirecciona al usuario directamente a la entidad emisora.
- Flujo de redireccionamiento completo: Una vez que el usuario completa la compra, el integrador usa este flujo para confirmar el pago con Google.
Por último, todo el movimiento de dinero entre el banco del integrador y el de Google se realiza en el flujo de remesa.
Descripción general de FOP de redireccionamiento
En la siguiente figura, se ilustra una descripción general general de los flujos:
En términos generales, agregar un servicio como forma de pago a los productos de Google implica los siguientes flujos:
- Inicia el redireccionamiento:
- Cómo completar el flujo de redireccionamiento
- Flujo de reembolso
- Flujo de remesa
Conceptos y terminología
Símbolos y convenciones
Las palabras clave "DEBE", "NO DEBE", "OBLIGATORIO", "DEBERÍA", "NO DEBERÁ", "DEBERÍA", "NO DEBERÁ", "RECOMENDADO", "PUEDE" y "OPCIONAL" de estos documentos se deben interpretar como se describe en RFC 2119.
Marcas de tiempo
Todas las marcas de tiempo se representan como milisegundos desde el tiempo Unix (1 de enero de 1970) en UTC.
Por ejemplo:
- 23 de abril de 2019 8:23:25 p.m. GMT = 1556051005000 milisegundos
- 16 de agosto de 2018 12:28:35 p.m. GMT = 1534422515000 milisegundos
Importes
Los valores monetarios de esta API están en un formato llamado "micros", un estándar de Google. Los micros son un formato de precisión fija basado en números enteros. Para representar un valor monetario en micros, multiplica el valor de la moneda estándar por 1,000,000.
Por ejemplo:
- USD 1.23 = 1230,000 microUSD
- USD 0.01 = 10,000 microUSD
Idempotencia
Todas las llamadas de método dentro de esta API deben tener un comportamiento idempotente. Google reintentará las solicitudes de forma esporádica para asegurarse de que las transacciones estén en el mismo estado en ambos lados. Los integradores no deben intentar volver a procesar solicitudes que ya se procesaron correctamente. En su lugar, se debe informar la respuesta del procesamiento correcto. Todos los métodos tienen un RequestHeader común que contiene un requestId. Este requestId es la clave de idempotencia para todas las llamadas.
Cualquier respuesta sin terminal (una respuesta correcta que no sea HTTP 200), no se debe procesar de forma idempotente. Por lo tanto, una solicitud que anteriormente obtuvo un 400 (solicitud incorrecta o condición previa fallida), cuando se la llamó por segunda vez, no debe mostrar 400 de forma idempotente, debe volver a evaluarse. En la reevaluación, podría mostrar un 400 o procesarse correctamente.
Para obtener más información sobre la idempotencia, consulta esta guía detallada.
Integrador
Ser una empresa que usa la plataforma de pagos de Google en su negocio. Pueden ser internos, como YouTube o AdWords, o empresas externas que desean integrar su servicio para que funcione con el ecosistema de Google.
forma de pago
Forma de pago. Esto es más general que un instrumento. Visa, Mastercard y PayPal son todas formas de pago.
Instrumento
Una instancia en particular de una forma de pago por parte de un cliente específico. Por ejemplo, la tarjeta de crédito de un usuario o su cuenta de PayPal. Una FOP con token para un cliente en particular también es un instrumento, ya que es una instancia de una forma de pago para ese cliente, almacenada de forma segura en nuestro sistema.
Token
Representación en el sistema de Google de la forma de pago de un usuario específico. Como contiene toda la información necesaria para realizar una compra, un token también es un instrumento. Esto puede incluir información como el número de cuenta que un usuario tiene con su integrador.
Flujos de claves
Iniciar el proceso de redireccionamiento
El primer paso de un pago con redireccionamiento es el flujo Comenzar el redireccionamiento. El propósito del flujo para iniciar el redireccionamiento es redireccionar al usuario, mediante el integrador, a la interfaz web de la entidad emisora elegida para que pueda autorizar un pago. Después del redireccionamiento, Google proporciona información básica de la transacción al integrador, que, a su vez, la reenvía a la entidad emisora.
Para obtener más información, consulta la sección Cómo iniciar el flujo de redireccionamiento.
Completar el flujo de redireccionamiento
Una vez que el usuario se encuentra en la interfaz web de la entidad emisora, debe realizar todos los pasos necesarios para completar un pago (estos pasos pueden cambiar según la entidad emisora). Como parte del flujo de redireccionamiento completo, la entidad emisora debe redireccionar al usuario de vuelta al integrador con información sobre el pago realizado correctamente. A su vez, el integrador redireccionará al usuario de vuelta a Google, incluidos los detalles del pago como parte de la respuesta de redireccionamiento. Una vez que se confirme el pago, Google proporcionará al usuario los bienes o servicios que haya comprado.
Para obtener más información, consulta la sección Cómo completar el flujo de redireccionamiento.