Introducción

​

¿Qué es Bre-B?

​

Ejemplo Rápido

​

Crear un pago Bre-B

curl https://api.onepay.la/v1/breb \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: breb-001" \
  -d '{
    "amount": 75000,
    "currency": "COP",
    "key_type": "phone",
    "key_value": "+573001234567",
    "description": "Pago de servicio",
    "customer_id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d"
  }'

{
  "id": "9e5a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "amount": 75000,
  "amount_label": "$75.000",
  "currency": "COP",
  "status": "completed",
  "key_type": "phone",
  "key_value": "+573001234567",
  "description": "Pago de servicio",
  "customer_id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
  "completed_at": "2025-09-15T10:30:05.000000Z",
  "created_at": "2025-09-15T10:30:00.000000Z"
}

​

Características principales

• Disponibilidad 24/7: Funciona todos los días del año, a cualquier hora
• Interoperabilidad: Conecta bancos, billeteras digitales y entidades financieras
• Transferencias inmediatas: Los fondos se acreditan en segundos
• Identificadores simples: Llaves fáciles de recordar en lugar de datos bancarios
• Sin costo inicial: Sin cobro por parte del Banco de la República durante los primeros tres años

​

Cómo usar Bre-B con OnePay

​

Cobros (Pay-ins)

​

Pagos (Payouts)

​

Integración

​

Trazabilidad

• Cada transacción se registra con detalle completo
• Reportes exportables y conciliación automática

​

Casos de uso

​

Disponibilidad

• Julio 2025: Inicio del registro de llaves Bre-B
• Septiembre 2025: Lanzamiento oficial (P2P y P2M)
• OnePay estará habilitado desde la fase inicial, tanto para cobros como para pagos

​

Endpoints