Saltar al contenido

Medios de pago · Colombia

Bre-B en Colombia: pagos inmediatos, de entrada y de salida

Da a cada cliente una cuenta virtual con su propia llave Bre-B para cobrar, y paga a las llaves Bre-B de tus beneficiarios en tiempo real, 24/7.

Contactar a ventasIr a la documentación
  • Transferencia inmediata
  • Colombia
  • Pay-in · Payout

Datos clave

Bre-B tras sus primeros meses

Cifras atribuidas al Banco de la República.

Qué es

El riel de pagos inmediatos de Colombia

Bre-B es el sistema de pagos inmediatos de Colombia, lanzado el 6 de octubre de 2025 por el Banco de la República. El dinero se mueve de cuenta a cuenta en segundos, a cualquier hora. Con Localpayment lo usas de dos formas: para cobrar, con una cuenta virtual identificada por una llave Bre-B, y para pagar a las llaves Bre-B de tus beneficiarios.

  • Cuenta virtual identificada por una llave Bre-B (código 2006)
  • Pay-ins a la llave, 24/7, confirmados por webhook
  • Payouts a llaves Bre-B en tiempo real, 24/7 (código 0062)

Cómo funciona

Cómo se cobra una transferencia Bre-B

Los actores y pasos siguen el flujo documentado. El estado final siempre llega por webhook firmado.

  1. 1

    Tu empresaLocalpayment:

    Crea la cuenta virtual

    POST /api/virtual-account, una por una o en lote. El número o la llave en el formato local, listo para compartir.

  2. 2

    Tu empresaCliente:

    Comparte los datos de pago

    En tu checkout, factura o app.

  3. 3

    ClienteBanco · Bre-B:

    Transfiere desde su banco

    Solo transferencias electrónicas; los depósitos en efectivo no se acreditan.

  4. 4

    LocalpaymentTu empresa:

    Webhook: pago recibido

    Localpayment asocia la transferencia a la cuenta virtual de forma automática. Webhook firmado con los datos del pagador y el monto; los fondos se acreditan en tu saldo Localpayment.

Diagrama simplificado. Los tiempos dependen del riel y del banco; consulta los datos clave más abajo.

Cómo funciona

Cómo funciona un payout con Bre-B

Los actores y pasos siguen el flujo documentado. El estado final siempre llega por webhook firmado.

  1. 1

    Tu empresaLocalpayment:

    Envía la solicitud de payout

    POST /api/payout/ con los datos del beneficiario, el monto y el externalId. Se aplican controles de cumplimiento; con requireAuth, un segundo aprobador firma antes de mover los fondos.

  2. 2

    LocalpaymentBanco · Bre-B:

    Bloquea los fondos y envía la instrucción

    El payout pasa de Locked a In Progress por Bre-B.

  3. 3

    Banco · Bre-BBeneficiario:

    Acredita al beneficiario

    Los tiempos dependen del riel; consulta los datos clave más abajo.

  4. 4

    LocalpaymentTu empresa:

    Webhook: payout completado

    Localpayment actualiza el payout a su estado final. Webhook firmado con el estado final; puedes descargar el comprobante de pago.

Diagrama simplificado. Los tiempos dependen del riel y del banco; consulta los datos clave más abajo.

Cómo funciona

Mira Bre-B en acción

Un recorrido simplificado y ficticio. Los nombres y montos son ejemplos.

  1. 1Comercio EjemploEl checkout muestra los datos de la cuenta para pagar COP 185.000,00.
  2. 2Banco EjemploEl pagador transfiere COP 185.000,00 a la cuenta indicada.
  3. 3Pago confirmadoTu sistema recibe el webhook firmado y libera la orden.
Contactar a ventas

Datos clave

Bre-B: datos clave

  • País

    Detalle
    🇨🇴 Colombia

  • Moneda

    Detalle
    COP

  • Dirección

    Detalle
    Pay-in y payout

  • Pay-in · Cuenta virtual (llave Bre-B)

    Detalle
    En tiempo real, confirmado por webhook · COP 1 – 11.000.000

  • Payout · Llave Bre-B

    Detalle
    En tiempo real, 24/7 · COP 1 – 11.552.000

Tomados de la documentación de Localpayment de cada país. Los límites y la disponibilidad pueden cambiar; confírmalos con tu ejecutivo de cuenta.

Experiencia del cliente

Qué ve tu cliente con Bre-B

Autorización, límites y reembolsos según docs.localpayment.com. Los límites se muestran solo cuando la documentación los indica.

  • Cómo autoriza el cliente

    Tu checkout muestra una llave Bre-B como @LPTechColomb0001, generada al crear la cuenta virtual. El cliente abre la app de su banco, elige “transferir por llave”, escribe la llave, ingresa el monto y confirma. La transferencia se liquida en tiempo real y el webhook se dispara cuando los fondos quedan acreditados.

  • Límites documentados

    Cuenta virtual (llave Bre-B) (Pay-in): COP 1 – 11.000.000 · Llave Bre-B (Payout): COP 1 – 11.552.000. Por transacción, según la documentación publicada; los límites contractuales pueden variar.

  • Reembolsos y devoluciones

    Una transferencia acreditada se reembolsa con PATCH /api/payin/{externalId}/refund. Solo se admiten reembolsos totales y los fondos vuelven automáticamente a la cuenta de origen del pagador, sin datos adicionales del beneficiario. Los depósitos en efectivo nunca se acreditan.

Checklist de integración

Sal a producción con Bre-B en cinco pasos

La misma secuencia para todos los rieles. Mira el checkout animado de este país antes de construir.

  1. Obtén credenciales de Stage

    Solicita acceso, recibe credenciales de sandbox y obtén un JWT con POST /api/token/.

  2. Crea el pay-in

    POST /api/payin/ con el código Localpayment de la tabla de datos clave, país ISO-3, moneda, monto y datos del pagador.

  3. Muestra las instrucciones

    Muestra el QR, el código, la redirección o los datos de cuenta de la respuesta y respeta la fecha de vencimiento.

  4. Verifica el webhook

    Valida x-Signature (HMAC-SHA256), libera la orden con el estado 200 y deduplica por externalId.

  5. Mira el checkout animado

    Cada método de este país, pantalla por pantalla, en la galería de experiencias de checkout.

Historia

Cómo Colombia construyó un riel inmediato interoperable

Fuente: Banco de la República, “Bre-B: Sistema de Pagos Inmediatos Interoperado de Colombia”, documento técnico, feb. 2026.

  1. Estrategia de pagos inmediatos

    El Banco de la República se propone que los sistemas de pago de bajo valor de Colombia interoperen mediante un directorio central de llaves y liquidación en tiempo real.

  2. Reglas para los SPBVI

    El banco central expide la regulación de los sistemas de pago de bajo valor interoperables y define el estándar común de llaves.

  3. Llaves y luego operación plena

    El registro de llaves abre a mediados de 2025; la operación plena llega en el segundo semestre, con transferencias P2P gratuitas para los usuarios.

  4. 90 millones de llaves

    Hay más de 90 millones de llaves y 218 entidades participantes registradas, con más de 370 millones de operaciones liquidadas en tiempo real desde el lanzamiento.

Por qué Localpayment

Por qué usar Bre-B con Localpayment

  • Una API para pay-ins y payouts

    Bre-B funciona con la misma API que el resto de los métodos: POST /api/payin/ para cobrar, POST /api/payout/ para pagar y nuevos mercados por configuración.

  • Estado por webhook en cada transacción

    Cada cambio de estado llega a tu endpoint firmado con HMAC-SHA256, para que lo verifiques y automatices.

  • Conciliación en el Business Portal

    Concilia cada transacción con tu externalId y nuestro internalId, con reportes del Business Portal y APIs de saldo.

Sigue explorando

Preguntas frecuentes

Bre-B: preguntas frecuentes

¿Qué tan rápido se confirma un pago Bre-B?

Bre-B es un riel en tiempo real que confirma en segundos, 24/7. En los pay-ins el estado final te llega por webhook firmado, así que diseña el flujo de tus órdenes a partir de esa notificación.

¿Cuáles son los límites?

El rango documentado para cuentas virtuales es de COP 1 a 11.000.000, y los payouts a llaves Bre-B llegan hasta COP 11.552.000. Revisa la tabla de datos clave y confirma tus límites con tu ejecutivo de cuenta.

¿Puedo cobrar y pagar con Bre-B?

Sí. Cobras con una cuenta virtual identificada por una llave Bre-B y pagas a las llaves Bre-B de tus beneficiarios en tiempo real, 24/7.

¿Cómo se construye la llave Bre-B de una cuenta virtual?

De forma determinística a partir del nombre del beneficiario que envías al crearla: prefijo @, LP, los primeros diez caracteres del nombre y un contador de cuatro dígitos (10 a 16 caracteres en total). No puedes elegir una llave arbitraria.

¿Cómo envío un payout a una llave Bre-B?

Envía POST /api/payout/ con paymentMethod.code 0062, type BankTransfer y flow DIRECT, y coloca la llave del destinatario en beneficiary.bank.account.alias; omite el tipo y el número de cuenta.

¿Se puede reembolsar un pay-in Bre-B?

Sí, en su totalidad, con PATCH /api/payin/{externalId}/refund. Los fondos vuelven automáticamente a la cuenta de origen del pagador y el pay-in termina en 902 (REFUNDED).

¿Cuáles son los estados del payout?

100 Received, 101 Locked (superó cumplimiento), 102 In Progress (enviado a Bre-B), 200 Completed (acreditado) y 300 Rejected, cada uno entregado por webhook firmado.

Suma Bre-B a tus cobros

Cuéntanos tus mercados y volúmenes. Empiezas con credenciales de Stage (sandbox) y te acompañamos hasta el go-live.

Contactar a ventasIr a la documentación

¿Cómo podemos ayudarte?

Descarga tu ejemplar

Déjanos tus datos y obtén la edición completa al instante.