Milio te permite enviar dinero de forma rápida y segura a través de Bre-b, la red de pagos inmediatos del sistema financiero colombiano. Con nuestra API puedes integrar este canal directamente en tus flujos de negocio para dispersar fondos a clientes, proveedores o cualquier beneficiario que tenga una llave Bre-b activa.
¿Qué es una llave Bre-b?
Una llave Bre-b es un identificador único vinculado a una cuenta bancaria. Funciona como un alias que permite recibir pagos sin necesidad de compartir datos bancarios sensibles. En el sistema de Milio, las llaves siguen el formato:
@MLXXXXXXXXXXXXXXXXX
Existen dos tipos de llaves que puedes gestionar desde la API:
- Llave genérica de empresa: Asociada directamente a tu empresa, sin vínculo a un cliente específico.
- Llave de cliente: Asociada a un cliente particular. Contiene información como nombre y correo del titular.
¿Cómo funciona una transferencia Bre-b?
El flujo completo de una transferencia Bre-b en Milio tiene tres etapas:
1. Gestión de llaves
Antes de realizar una transferencia, necesitas tener la llave Bre-b del beneficiario. Puedes crearla y administrarla usando los endpoints de Transferencias con Bre-b
2. Creación de la transacción
Una vez tienes la llave, creas la transacción enviando los datos del beneficiario junto con el monto. La API valida la llave Bre-b de forma síncrona antes de procesar la operación.
3. Seguimiento del estado
Las transacciones pasan por un ciclo de estados desde su creación hasta su finalización. Puedes consultar el estado en cualquier momento usando el endpoint de consulta.
Ciclo de estados de una transacción
created → approved → processing → done
↘ fail
cancelled
compliance_cancelled
| Estado | Descripción |
|---|---|
created | Transacción creada, pendiente de aprobación |
approved | Aprobada y en espera de procesamiento. Al usar API Key se aprueba automáticamente |
processing | En ejecución |
done | Completada exitosamente |
fail | Falló. Los fondos fueron reembolsados |
cancelled | Cancelada antes del procesamiento. Los fondos fueron reembolsados |
compliance_cancelled | Cancelada por cumplimiento normativo |
Consideraciones importantes
Encriptación: Tanto el cuerpo del request como el de la respuesta están encriptados. Asegúrate de implementar el proceso de encriptación/desencriptación antes de integrar la API.
Autenticación: Todas las peticiones requieren el header
X-API-KEYcon tu llave de API de Milio.
Idempotencia: Al crear transacciones, utiliza siempre un
idempotency_keyúnico (UUID v4 recomendado) para evitar transacciones duplicadas ante reintentos.
Endpoints disponibles
| Método | Endpoint | Descripción |
|---|---|---|
GET | /breb_keys/ | Listar llaves Bre-b |
POST | /breb_keys/ | Crear una llave Bre-b |
PUT | /breb_keys/?id={id} | Cancelar una llave Bre-b |
POST | /transactions/ | Crear una transacción Bre-b |
GET | /transactions/bre-b/{id}/ | Consultar una transacción Bre-b |
Autenticación
Todas las peticiones a la API de Milio requieren el siguiente header:
X-API-KEY: tu_api_key_aquí
Para obtener tu API Key, accede al panel de Milio o contacta a nuestro equipo de soporte.