Recaudo PSE
Recauda un pago desde la cuenta bancaria colombiana de un cliente usando PSE.
PSE (Pagos Seguros en Línea) es el sistema estándar en Colombia para pagar desde una cuenta bancaria en un sitio web — el equivalente local a Pix en Brasil o ACH Direct Debit en Estados Unidos. Un recaudo PSE es el flujo que tu negocio corre cuando quieres que un cliente te pague desde su cuenta bancaria: generas un enlace de pago, el cliente lo sigue hasta su banco, el banco autoriza el pago y Mono te notifica el resultado.
Este flujo es el centro de la capacidad de recaudo de Banking. Úsalo para checkout de e-commerce, settlement de facturas, recargas de suscripción o cualquier escenario donde el pagador inicie el pago.
Esta página es un esqueleto de flujo y se expandirá con ejemplos de código por paso, webhooks esperados y errores comunes. Sigue el progreso en el roadmap de documentación.
Antes de empezar
Vas a necesitar:
- Una cuenta Mono con Banking habilitado y una API key para el entorno al que estás llamando. Ver Autenticación.
- Una cuenta bancaria receptora configurada en tu dashboard de Mono.
- Un endpoint de webhook que pueda recibir eventos de enlaces de recaudo.
- Familiaridad con el concepto de enlaces de recaudo.
Vista general de la secuencia
- Crea una intención de recaudo — tu backend llama a Mono para generar una intención de pago con el monto, la moneda y una referencia que tú controlas. Mono devuelve una URL de redirección apuntando al formulario de pago respaldado por PSE.
- Redirige al pagador — tu frontend envía al cliente a esa URL. PSE maneja la selección de banco y la autorización.
- Recibe el resultado — Mono dispara un webhook
collection_intent_crediteda tu endpoint cuando el pago se settle, ocollection_intent_failedsi es rechazado. - Concilia — tu sistema actualiza la orden y acredita al cliente.
Pasos
El paso a paso completo (con ejemplos en curl, Node.js y Python) está pendiente. Hasta que se publique, ver:
- La página de concepto de enlaces de recaudo para el modelo de datos y el ciclo de vida.
- La página de webhooks de enlaces de recaudo para los payloads de los eventos
collection_intent_creditedycollection_intent_failed.
Siguientes pasos
- Envío de transferencias — la contraparte de dispersión de este flujo.
- Webhooks de Banking — los eventos que guían la conciliación.
- Sandbox — prueba el flujo sin mover dinero real.