Ejemplo de integración
Un recorrido realista de cómo construir un recaudador PSE para e-commerce.
Esta página recorre una integración representativa de Banking de punta a punta: un recaudador PSE para e-commerce. Verás el camino completo desde que un cliente hace clic en "pagar" en tu checkout hasta que tu sistema marca la orden como pagada y despacha la mercancía.
El recaudo PSE es el caso de uso más común de Banking. El mismo patrón se transfiere a settlement de facturas, recargas de suscripción y cualquier pago iniciado por el pagador.
Esta página es un esqueleto de ejemplo de integración. La versión completa incluirá código por paso (curl, Node.js, Python), un diagrama de secuencia, manejo de errores y patrones de conciliación.
Qué vas a construir
Un checkout de e-commerce que:
- Genera un enlace de recaudo PSE cuando el cliente elige "pagar con cuenta bancaria".
- Redirige al cliente a PSE para la selección de banco y autorización.
- Recibe un webhook cuando el banco confirma el pago.
- Marca la orden como pagada y dispara el fulfillment.
- Maneja los casos de falla — abandonado, expirado, rechazado.
Arquitectura
| Capa | Componente |
|---|---|
| Frontend | UI del checkout, redirección a PSE, manejo de return URL |
| Backend | Creación de enlace de recaudo, receptor de webhook, máquina de estados de la orden |
| Mono | API de Banking + webhooks de enlace de recaudo |
| Externo | Red PSE + banco del cliente |
Recorrido
El recorrido completo está pendiente. Hasta que se publique, ver: