Flujo de Pago con Código QR
Introducción
Este documento describe el ciclo de vida de un pago realizado mediante un Código QR dentro del ecosistema Bre-B en Colombia. La solución integra el sistema de punto de venta (POS) con la plataforma PaaS de Passport, el Nodo Bre-B y las instituciones financieras participantes.
Dirigido a:
- Equipos técnicos que implementan integraciones API.
- Equipos de producto que evalúan la experiencia del usuario.
- Interesados de negocio que analizan estrategias de pagos en tiempo real.
Resumen del Flujo
La siguiente imagen resume los pasos desde la solicitud de generación del Código QR hasta la confirmación del pago vía Webhook al comercio.
Diagrama de Flujo Transaccional
Pasos del Pago con Código QR
| Passo | Acción | Desde | Hacia |
|---|---|---|---|
| 1 | Solicitud de Código QR | POS | Plataforma PaaS |
| 2 | Generación del Código QR | Plataforma PaaS | Nodo Bre-B |
| 3 | Presentación del QR al Cliente | POS | Comprador |
| 4 | Inicio del Pago | Comprador | Banco del Cliente |
| 5 | Enrutamiento del Pago | Banco del Cliente | Nodo Bre-B -> Banco Sponsor |
| 6 | Notification de Abono | Banco Sponsor | Plataforma PaaS |
| 7 | Webhook de Confirmación | Plataforma PaaS | POS |
Descripción del Flujo
La Plataforma PaaS no se conecta automáticamente al sistema POS; es responsabilidad de la fintech o proveedor establecer esta integración.
Paso 1: Solicitud de Creación del Código QR
El sistema POS del comercio solicita a la Plataforma PaaS la generación de un código QR dinámico para una nueva sesión de pago.
Paso 2: Generación del Código QR
La Plataforma PaaS se comunica con el Nodo Bre-B para generar el código QR, que incluye una llave Bre-B única y metadatos asociados al pago.
Paso 3: Presentación del QR al Cliente
El código QR es mostrado en el POS para que el cliente lo escanee desde la sección Bre-B de su aplicación bancaria móvil.
Paso 4: Inicio del Pago
La aplicación bancaria extrae la información del QR e inicia el débito desde la cuenta del comprador.
Paso 5: Enrutamiento del Pago
El banco del cliente enruta el pago a través del Nodo Bre-B, que lo reenvía al Banco Sponsor del comercio.
Paso 6: Notificación de Abono
El Banco Sponsor acredita la cuenta del comercio y notifica a la Plataforma PaaS.
Paso 7: Confirmación vía Webhook
La Plataforma PaaS envía un webhook al sistema POS del comercio confirmando que el pago fue recibido, permitiendo así finalizar la transacción.
Validación del Código QR
Passport provee, en la sección Productos > Códigos QR, un historial de todos los códigos QR generados. En los detalles de cada uno, podrás visualizar la imagen convertida desde el formato base64 a la imagen real. Puedes usar cualquier lector de códigos QR para validar la información codificada. Para más detalles, consulta el documento Códigos QR.
Ejemplo de Código QR presentado en el tablero de control