Descripción general
El flujo de redireccionamiento completo comienza después de que se completa el flujo de begin Redirect y el usuario realiza un pago en la interfaz web de la entidad emisora. El propósito del flujo de redireccionamiento completo es el siguiente:
- Notifica a Google y al integrador de pagos que el pago se realizó correctamente.
- Redirecciona al usuario de vuelta a Google a través del integrador.
Cómo funciona el flujo
El integrador transmite la información de pago completada a Google de tres maneras diferentes.
- El integrador redirecciona al usuario a Google y agrega la información de pago a la respuesta de redireccionamiento.
- El integrador envía una solicitud HTTPS al extremo RedirectPaymentCompleteNotification de Google una vez que se completa el pago.
- Google envía una solicitud HTTPS al extremo GetRedirectPaymentStatus del integrador, y este responde con los detalles del pago.
Completar el flujo de redireccionamiento
En el siguiente diagrama de secuencias, se muestra la interacción entre el navegador del usuario, Google, el integrador y la entidad emisora:
A continuación, se muestra la lista de objetos del diagrama anterior:
- Usuario: Es la persona que completó un pago.
- IU de Google: Es la interfaz web o de la app de Google, donde el cliente inició el pago.
- Servidor de Google: Es el servidor de backend de Google, que obtiene los detalles del pago completados y proporciona al usuario los bienes o servicios comprados.
- Integrador de pagos: Es el integrador de pagos que actuará como intermediario entre Google y la entidad emisora.
- Emisor: La entidad emisora a la que el usuario realizó el pago.
Suponemos que el usuario acaba de realizar un pago en el sitio web de la entidad emisora, lo que activa el flujo de redireccionamiento completo.
- El usuario completa el pago en el portal de la entidad emisora.
- La entidad emisora crea una URL de redireccionamiento que dirige al integrador con información sobre el pago completado.
- La entidad emisora redirecciona al usuario al servidor de backend del integrador de pagos.
- El integrador de pagos crea una respuesta de redireccionamiento con información del redireccionamiento de la entidad emisora.
- El integrador de pagos redirecciona al usuario a Google.
- El integrador de pagos envía una RedirectPaymentCompleteNotification a Google. Se usa en caso de que falle el redireccionamiento después de que el usuario haya completado el pago.
- Si Google no recibe una respuesta de redireccionamiento o una RedirectPaymentCompleteNotification, enviará una llamada GetRedirectPaymentStatus al integrador de pagos, que debería responder con la información del estado del pago.
- Google procesa la información de pago que proporciona al usuario los bienes o servicios que se compraron.
Notificación de redireccionamiento completado del pago
Como se muestra en el diagrama anterior, Google requiere que los integradores envíen un RedirectPaymentCompleteNotification a Google cuando determina que se aceptó o rechazó un pago de redireccionamiento. Esta notificación se puede enviar a Google antes o después de que se vuelva a redireccionar al usuario a Google.
Si un integrador descubre que se completó un pago de redireccionamiento (aceptado o rechazado) incluso varios días después de que ocurrió el redireccionamiento inicial, igualmente debe enviar una RedirectPaymentCompleteNotification a Google. Estas notificaciones ayudan a actualizar el estado final de un pago y son necesarias para administrar correctamente la conciliación.
Prácticas recomendadas y otras consideraciones
Medidas de seguridad
La URL de respuesta de redireccionamiento incluirá un campo redirectRequestId sin encriptar y un objeto RedirectResponse encriptado con el mismo valor. Google validará que ambos valores coincidan con el campo requestId enviado en la solicitud de redireccionamiento.