Visión general de arquitectura
Cómo la API de Bre-B Participant te conecta a la red Bre-B.
Bre-B es el esquema interbancario de pagos instantáneos de Colombia — un rail en tiempo real similar a Pix de Brasil o UPI de India que permite a cualquier banco participante o entidad licenciada enviar y recibir fondos 24/7 en segundos. La API de Bre-B Participant te da una rampa programable a esa red: te autenticas con OAuth, registras cuentas tenant, generas códigos QR para pagos entrantes y despachas transferencias salientes contra llaves de pago (alias como teléfono, documento, email, alfanumérico o código de comercio).
Esta página es el punto de partida correcto si quieres entender el camino que toma un request desde tu código hasta el directorio central de Bre-B y de vuelta.
Componentes
| Componente | Rol |
|---|---|
| Servicio de autenticación | Emite access tokens OAuth para la API de Participant. |
| Cuentas tenant | Cuentas lógicas en Mono que mantienen saldos y reciben pagos Bre-B. |
| Target resolution | Busca una llave de pago contra el directorio central de Bre-B. |
| Transferencias salientes | Despacha un pago a un target resuelto. |
| Recaudos | Genera códigos QR y concilia pagos entrantes. |
| Webhooks | Eventos asíncronos de resoluciones, transferencias y recaudos. |
Ciclo de vida del request (transferencia saliente)
- Autenticación — intercambia las credenciales de cliente por un access token OAuth.
- Resuelve el target — envía la llave de pago; recibes el nombre y banco del titular.
- Despacha — envía el target resuelto con monto y clave de idempotencia.
- Rastrea el ciclo de vida — los webhooks se disparan en cada transición de estado.
- Concilia — acredita o libera la operación en tus libros.
Modelo de tenants
Cada cliente es un tenant participante de Bre-B en Mono. Las cuentas tenant están aisladas; las resoluciones y transferencias siempre operan contra un tenant específico.
Referencias de ciclo de vida
Una vez que un request entra a la plataforma se mueve a través de una máquina de estados determinística, y cada transición emite un webhook. Los dos flujos tienen sus propias páginas de ciclo de vida — léelas junto con la arquitectura de arriba para entender qué debería estar escuchando tu integración.
- Ciclo de vida de la transferencia saliente — estados, eventos de webhook y resultados terminales para los pagos que despachas.
- Ciclo de vida del recaudo — estados, eventos de webhook y resultados terminales para códigos QR y llaves de pago que reciben fondos.