Bre-B
Recauda pagos instantáneos en COP por Bre-B, el sistema de pagos inmediatos de Colombia: llaves, códigos QR y límites.
Bre-B es el sistema de pagos inmediatos de Colombia, operado por el Banco de la República: transferencias banco a banco que se liquidan en segundos, a toda hora, direccionadas por una llave (un alias corto como un número de celular, registrado en un directorio central) o un código QR. co_breb es el método de Recaudos que opera sobre ese riel: Mono registra una llave por ti, el pagador le paga desde la app de su propio banco, y el dinero se valida y acredita en segundos.
Es el único método de Recaudos disponible hoy, y liquida exclusivamente en COP.
Cómo funciona un pago por Bre-B
- Tu plantilla (o intención de pago) solicita un token de pago Bre-B. Mono registra la llave ante la red, un paso asíncrono que anuncian los webhooks de
ready/ready_to_pay. - Le muestras la llave o el QR al pagador.
- El pagador paga desde la app de su banco, digitando la llave o escaneando el QR. Sin formulario de checkout, sin datos de tarjeta, sin credenciales de tu lado.
- La red le presenta el pago a Mono, que lo valida contra tus reglas (montos, pagadores esperados, estado de la plantilla) y lo autoriza o rechaza en la misma interacción.
- El pago queda registrado y avanza por su ciclo de vida; los webhooks te mantienen informado.
Como el pago se origina en el banco del pagador, la identidad del pagador (instrument.payer: nombres, documento, tipo de persona) y su cuenta (instrument.data) llegan con el pago. Eso es lo que permite exigir expected_payers sin pedirle nada al pagador.
Llaves y códigos QR
| Token | Alcance | Comportamiento |
|---|---|---|
Llave (key_per: "template") | Compartida: toda la plantilla | Estática: cualquier pagador, cualquier número de pagos (multiple_use). |
| QR estático | Compartido: toda la plantilla | Codifica la llave de la plantilla; sin monto fijo. |
Llave (key_per: "intent") | Una intención de pago | Creada por pago esperado; ata el pago a la intención de pago. |
| QR dinámico | Una intención de pago | Un solo uso, monto fijo, expira con la intención de pago. |
Los tipos de llave los asigna la red al registrarla: cellphone, email, alphanumeric, identification o merchant_code. Puedes pedir un alias personalizado con method_params.co_breb.custom_key_value y los datos de comercio del QR con qr_code_data.
Límites y tiempos
- Tope por transacción: un pago individual por Bre-B tiene un tope de $12.110.000 COP. Es el límite por transacción de la red tal como lo aplica Mono; la red lo ajusta periódicamente, así que tómalo como un valor vigente y no como una constante. Un pago por encima lo rechaza el riel. El
maximum_payin_amountde una plantilla solo puede apretar este tope, nunca superarlo. - Ventana de la intención de pago: una intención de pago Bre-B es pagable durante 30 minutos después de
ready_to_pay. Dentro de esa ventana, los intentos fallidos rearman la intención de pago: el pagador puede reintentar contra la misma llave. - Liquidación: los pagos aprobados llegan a tu cuenta de fondeo en lotes de liquidación.
Siguientes pasos
- Tokens de pago: el modelo de llaves y QR en detalle.
- Flujo de recarga: una llave permanente por subcuenta.
- Recaudar con intenciones de pago: QRs dinámicos por pago.