Ejemplo de integración
Recorrido realista de la construcción de una integración Bre-B participant.
Esta página recorre de extremo a extremo una integración Bre-B representativa: un banco o entidad licenciada que quiere permitir a sus clientes enviar y recibir pagos Bre-B desde dentro de la app bancaria. Vas a ver el camino completo desde el intercambio de tokens hasta la generación de QR, la recepción de pagos, la resolución de target, la transferencia saliente y el manejo de webhooks.
Si estás construyendo otro caso de uso Bre-B — un adquirente de marketplace, una billetera que conecta a Bre-B, un sistema de tesorería — los patrones se transfieren directamente; solo cambian los nombres de las entidades.
Esta página es un esqueleto de ejemplo de integración. La versión completa incluirá código por paso, diagramas de secuencia para los flujos de payin y payout, y una arquitectura de referencia completa.
Qué vas a construir
Una integración Bre-B participant que soporta:
- Onboarding — registrar una cuenta tenant que mantendrá saldos y recibirá pagos Bre-B.
- Recibir pagos — generar códigos QR de Bre-B y conciliar eventos de recaudo.
- Enviar pagos — resolver una llave de pago destino, confirmar con el usuario y despachar una transferencia saliente.
- Ciclo de vida — rastrear los estados de la transferencia saliente y manejar errores.
Arquitectura
| Capa | Componente |
|---|---|
| Frontend | UI para el cliente final que muestra QR e inicia transferencias salientes |
| Backend | Refresh OAuth, generación de recaudo, resolución + despacho, receptor de webhooks |
| Mono | API de Bre-B Participant + webhooks |
| Externo | Directorio central de Bre-B + bancos contraparte |
Recorrido
El recorrido completo está pendiente. Hasta que se publique, consulta:
- Flujo de transferencia saliente
- Flujo de recaudo por QR
- Estados de la transferencia saliente
- Payloads de webhook