loading...
loading...

Cómo procesar pagos locales a Colombia (COP) vía Bre-B usando stablecoins

Pagos Bre-B a Colombia en COP fondeados con USDC, con datos de transacciones y llaves Bre-B

Tu diseñadora en Bogotá acaba de cerrar el sprint. Te manda un número de celular y te pide que le pagues “por Bre-B”. Tu banco solo sabe enviar giros SWIFT, que pueden tardar días.

Los pagos Bre-B a Colombia con stablecoins cierran esa brecha. Tú fondeas en USDC o USD, fijas una cotización, y tu destinatario recibe pesos colombianos (COP) a través de su llave Bre-B.

Los colombianos adoptaron Bre-B rápido. Según La República, desde su lanzamiento en octubre de 2025 el sistema superó los 1.000 millones de transacciones. Ya hay 108 millones de llaves registradas por 35 millones de personas.

Esta guía explica qué es Bre-B, cómo funciona el flujo con stablecoins y qué datos necesitas de tu destinatario. Luego te muestra cómo enviar tu primer pago por Bre-B desde el dashboard y por API.

Por qué pagar a personas en Colombia es más difícil de lo que debería

Colombia ya tiene uno de los sistemas de pago locales más rápidos de la región. Pero tu pago internacional primero tiene que cruzar la frontera, y ahí es donde se frena.

Los destinatarios esperan dinero inmediato. Bre-B procesa casi 8 millones de pagos al día, frente a 2,5 millones en noviembre de 2025. Un contratista acostumbrado a esa velocidad no va a esperar una semana por un giro.

Las transferencias tradicionales esperan ciclos. Las transferencias interbancarias por ACH se compensan en cinco ciclos en días hábiles, según Bancolombia. Una transferencia enviada el viernes en la noche llega el lunes.

El peso se mueve rápido. La tasa oficial fue de COP 3.273,49 por dólar el 3 de octubre de 2026, un 12,87% menos que al inicio del año. Una cotización que no está fija antes de enviar puede costarte a ti o a tu destinatario.

Las transferencias internacionales pequeñas son caras. Enviar montos pequeños al exterior cuesta en promedio un 6,36% del monto enviado, según el Banco Mundial. En US$20.000 mensuales de pagos a contratistas, ese promedio te costaría US$1.272 cada mes.

¿Qué es Bre-B?

Bre-B es el sistema de pagos inmediatos interoperable de Colombia, operado por el Banco de la República. Funciona dentro de las apps de bancos y otras entidades financieras, así que no tiene app propia. Las transferencias se mueven en segundos, a cualquier hora y cualquier día.

En lugar de un número de cuenta, quien envía usa la llave del destinatario. El Banco de la República permite cinco tipos de llave:

  • Número de documento de identidad: la cédula u otro documento registrado en el banco del destinatario.
  • Número de celular: un celular colombiano registrado en el banco.
  • Correo electrónico: el correo registrado en el banco.
  • Llave alfanumérica: generada por el banco, empieza con el símbolo @.
  • Código de comercio: asignado por el banco, solo para negocios.

Cada llave apunta a una sola cuenta o depósito, aunque una cuenta puede tener varias llaves. El sistema tiene más de 110 millones de llaves y unas 250 entidades participantes, frente a unas 40 al lanzamiento.

Pagos Bre-B a Colombia con stablecoins: cómo funciona

Yativo es infraestructura de pagos, no un banco. Usamos stablecoins como capa de liquidación entre tu saldo y Colombia. Luego, un socio de pago local licenciado envía los pesos por Bre-B.

  1. Fondeas tu saldo float en Yativo con un depósito en moneda fiat o en stablecoins, como USDC.
  2. Yativo convierte el valor del pago a USDC y lo liquida on-chain.
  3. Un socio de pago local licenciado en Colombia recibe la liquidación en stablecoins.
  4. El socio convierte los USDC a COP y envía una transferencia Bre-B a la llave del destinatario.
  5. Tu destinatario recibe pesos en la cuenta asociada a esa llave.

Tu destinatario no necesita una billetera cripto. Nunca ve ni toca stablecoins. Para él, el pago se ve como cualquier transferencia Bre-B de un remitente local.

Las stablecoins ya son conocidas en Colombia. Chainalysis estima el volumen de transacciones cripto de Colombia en US$44.200 millones entre julio de 2024 y junio de 2025.

Rieles de pago disponibles para Colombia

Los métodos de pago activos de Yativo para COP son Bre-B y Bank Transfer. Nuestra lista de métodos para Colombia también incluye SWIFT, que paga en USD.

Bre-B (COP)

Yativo paga por Bre-B con los gateway IDs 1277 y 1278. Usa el que devuelva el endpoint de métodos de pago para tu cuenta.

Datos requeridos: los campos que devuelve el formulario de pago Bre-B, como la llave Bre-B y el nombre del destinatario. Más abajo, en la sección de API, verás cómo obtenerlos.

Tiempo de liquidación: tu cotización muestra el tiempo de entrega antes de confirmar. El riel Bre-B liquida en segundos, 24/7.

Límite: hasta COP 12.110.000 por transacción en 2026, y el banco del destinatario puede fijar un tope menor.

Ideal para: freelancers, contratistas, creadores y otras personas que ya usan Bre-B.

Transferencia bancaria (COP)

Bank Transfer, gateway ID 2, paga a una cuenta de ahorros o corriente en un banco colombiano. Pide el banco, el tipo de cuenta y el número de cuenta, y sirve para empresas y montos más grandes. Nuestra guía de transferencia bancaria a Colombia lo explica paso a paso.

Alternativas en USD

Si tu destinatario prefiere dólares en lugar de pesos, Bre-B no sirve, porque solo mueve COP. Usa SWIFT, gateway ID 564, que paga en USD. Revisa la lista actualizada antes de integrar, ya que la disponibilidad depende de tu cuenta.

Datos del destinatario que debes reunir antes de tu primer pago por Bre-B

El formulario de pago Bre-B en nuestra API es la lista oficial de campos. Pide estos datos a tu destinatario durante el onboarding.

  • Tipo de llave: número de documento, celular, correo o llave alfanumérica.
  • Valor de la llave: exactamente como está registrada, por ejemplo un celular de 10 dígitos o una llave con @.
  • Nombre legal: para compararlo con el nombre que aparece para la llave.
  • Documento de identidad: cédula o NIT, guardado en tu registro del beneficiario.
  • Referencia de pago: un número de factura o contrato para conciliar.

Pide la llave por escrito, nunca a través de un enlace. El Banco de la República advierte que las llaves solo se registran en la app o el sitio web de cada entidad. Además, nadie necesita aceptar una transferencia a través de un mensaje.

Cómo enviar un pago por Bre-B con Yativo

Opción 1: Dashboard (para pagos manuales)

  1. Fondea tu saldo float en Yativo con un depósito en moneda fiat o en stablecoins.
  2. Ve a Transfer en tu dashboard de Yativo.
  3. Selecciona la billetera float con la que vas a pagar, por ejemplo USD, EUR, MXN o el saldo que hayas fondeado.
  4. Elige el cliente en cuyo nombre estás pagando. Este paso es necesario para las fintechs que procesan pagos en nombre de sus clientes.
  5. Elige Colombia como país de destino y el método de pago Bre-B.
  6. Ingresa los datos que pide el formulario de Bre-B, como la llave Bre-B del destinatario y su nombre.
  7. Ingresa el monto en USD o COP.
  8. Revisa la cotización: tipo de cambio, comisiones, tiempo de entrega y el monto exacto en COP que recibe tu destinatario.
  9. Confirma con tu PIN y 2FA.
  10. Sigue el pago en tiempo real y descarga el comprobante para tus registros.

Opción 2: API (para pagos automatizados y masivos)

Todos los endpoints de abajo están en la documentación de la API de Yativo. Las llamadas de producción van a https://api.yativo.com/api/v1, y el sandbox funciona en https://smtp.yativo.com/api/v1.

Autentica cada solicitud con los headers X-Api-Key y X-Api-Secret, y cada key solo funciona desde las IP de servidor que tiene registradas. Estas API keys reemplazaron a los bearer tokens. Los tokens de login dejan de funcionar desde servidores el 15 de octubre de 2026, como explicamos en nuestra actualización de octubre. Cada solicitud POST también necesita un header Idempotency-Key único.

Paso 1. Genera una dirección de fondeo en USDC sobre Solana para recargar tu saldo en USD:

POST https://api.yativo.com/api/v1/crypto/create-wallet
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 3b2a1c0d-9e8f-4a7b-8c6d-5e4f3a2b1c0e
Content-Type: application/json

{
  "currency": "USDC_SOL"
}

Paso 2. Lista los métodos de pago disponibles para Colombia:

curl "https://api.yativo.com/api/v1/payment-methods/payout?country=COL" \
  -H "X-Api-Key: $YATIVO_API_KEY" \
  -H "X-Api-Secret: $YATIVO_API_SECRET" \
  -H "Accept: application/json"

La respuesta puede incluir dos métodos Bre-B, con los gateway IDs 1277 y 1278. Usa el que el endpoint devuelva para tu cuenta. Los ejemplos de abajo usan 1277.

Paso 3. Obtén los campos requeridos para ese gateway:

GET https://api.yativo.com/api/v1/beneficiary/form/show/1277
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET

La respuesta lista todos los campos requeridos y los valores aceptados para cada uno. Arma tu objeto payment_data a partir de ella. Para el detalle de los campos, ver documentación de API.

Paso 4. Crea el beneficiario. Reemplaza el marcador con los campos que devolvió el formulario:

POST https://api.yativo.com/api/v1/beneficiaries/payment-methods/
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 8d7c6b5a-4f3e-4d2c-9b1a-0f9e8d7c6b5b
Content-Type: application/json

{
  "gateway_id": 1277,
  "nickname": "Laura Gómez (diseño UX)",
  "currency": "COP",
  "customer_id": "e8caa491-57b6-4c39-9e3a-d2c97e47fbf0",
  "payment_data": {
    "{field_from_form}": "{value}"
  }
}

Paso 5. Opcionalmente, fija tu tipo de cambio. Las cotizaciones son válidas por 5 minutos:

POST https://api.yativo.com/api/v1/exchange-rate
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 1f2e3d4c-5b6a-4978-8a9b-c0d1e2f3a4b6
Content-Type: application/json

{
  "from_currency": "USD",
  "to_currency": "COP",
  "method_id": 1277,
  "method_type": "payout",
  "amount": 600
}

Paso 6. Inicia el pago desde tu saldo en USD:

POST https://api.yativo.com/api/v1/wallet/payout
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 6a5b4c3d-2e1f-4a0b-9c8d-7e6f5a4b3c2e
Content-Type: application/json

{
  "debit_wallet": "USD",
  "amount": 600,
  "payment_method_id": 4832,
  "customer_id": "e8caa491-57b6-4c39-9e3a-d2c97e47fbf0",
  "quote_id": "4a72ecf8-6c8a-4e38-9971-8aabe9f785ed"
}

Usa el id de la respuesta del beneficiario como payment_method_id. Omite quote_id si no fijaste un tipo de cambio. Para pagos masivos, repite la llamada por cada beneficiario, como describimos en nuestra página de payouts.

¿Bre-B o transferencia bancaria? Qué opción de pago a Colombia te conviene

 Bre-B (COP)Transferencia bancaria (COP)USD vía SWIFT
Velocidad de liquidaciónSe muestra en tu cotizaciónSe muestra en tu cotizaciónDepende de los bancos corresponsales
Datos requeridosLlave Bre-B (ver documentación de API)Banco, tipo de cuenta, número de cuentaVer documentación de API
Ideal paraPersonas, contratistasEmpresas, proveedores, nóminaDestinatarios que quieren USD
DisponibilidadActivaActivaActiva
Moneda recibidaCOPCOPUSD

Buenas prácticas para pagos por Bre-B

Confirma la llave antes del primer pago. Es fácil escribir mal una llave, y una llave válida pero equivocada le paga a otra persona. Envía un primer pago pequeño y pide a tu destinatario que confirme que llegó.

Respeta el límite por pago. Cada pago por Bre-B llega como máximo a COP 12.110.000 en 2026. Envía los montos mayores por transferencia bancaria en lugar de dividirlos.

Usa transferencia bancaria para empresas. Las reglas de Bre-B todavía se están ampliando a los pagos empresariales. Pagarle a una empresa por cuenta bancaria mantiene limpios los registros de ambas partes.

Fija el tipo de cambio en las nóminas. El peso se ha movido casi un 13% frente al dólar este año. Las cotizaciones son válidas por 5 minutos, así que fija una antes de un lote grande.

Deja de usar gateway IDs retirados. El antiguo método BreB (COL), gateway 1355, fue dado de baja el 2 de septiembre de 2026. Lee los gateway IDs desde el endpoint de métodos de pago en cada ejecución.

Usa una sola estrategia en toda LATAM. El mismo flujo funciona en otros mercados. Revisa nuestra guía de pagos locales a Argentina por transferencia bancaria y nuestro análisis de rieles de pago en LATAM.

Preguntas frecuentes

¿Mi destinatario en Colombia necesita una billetera cripto?

No. Tu destinatario recibe pesos colombianos en la cuenta o depósito electrónico asociado a su llave Bre-B. Nunca interactúa con stablecoins.

¿Es legal y cumple con la normativa pagar por Bre-B a destinatarios en Colombia?

Sí, cuando el pago pasa por infraestructura regulada. Yativo está registrada ante FinCEN como Money Services Business, con el número de registro 31000270723339. Un socio de pago local licenciado envía la transferencia por Bre-B, así que tu destinatario ve un pago local normal. Tus propias obligaciones tributarias y de reporte siguen vigentes, así que confírmalas con tu asesor de cumplimiento.

¿Qué tan rápido es un pago por Bre-B?

Tu cotización de Yativo muestra el tiempo de entrega antes de confirmar. El riel Bre-B mueve dinero entre entidades en segundos, las 24 horas, los siete días de la semana, según el Banco de la República.

¿Cuánto puedo enviar en un solo pago por Bre-B?

Hasta 1.000 UVB por transacción, que equivalen a COP 12.110.000 en 2026. El banco del destinatario puede fijar un límite menor, así que usa transferencia bancaria para montos más grandes.

¿Puedo pagar a una empresa colombiana por Bre-B?

Por ahora, usa transferencia bancaria para empresas. Las reglas de Bre-B hoy cubren pagos entre personas y de personas a comercios, y las reglas para nómina y pagos a proveedores todavía están en preparación. Nuestra guía de transferencia bancaria cubre ese riel.

¿Mi destinatario puede recibir dólares en lugar de pesos?

No por Bre-B, que solo mueve COP. Para recibir dólares, usa SWIFT, que paga en USD. Revisa GET /payment-methods/payout?country=COL para ver los métodos habilitados en tu cuenta.

Empieza a pagar en Colombia por Bre-B

Bre-B ya procesó más de 1.000 millones de transacciones en su primer año, así que tus destinatarios en Colombia esperan recibir el dinero en segundos. Con Yativo fondeas en USDC o USD y entregas COP a una llave Bre-B a través de un socio de pago local licenciado. Tus destinatarios reciben una transferencia inmediata local, y tú usas una sola API para todos tus pagos. Agenda una demo para configurar tu primer pago por Bre-B.

Fuentes