Transferencia saliente
Envía una transferencia Bre-B desde tu cuenta tenant a otro participante.
Una transferencia saliente es un pago Bre-B: los fondos dejan tu cuenta tenant en Mono y llegan a un destino identificado por una llave de pago — un alias como un número de teléfono, documento, email, un identificador alfanumérico Bre-B o un código de comercio. A diferencia de una transferencia por tarjeta o ACH, las transferencias Bre-B settlean en tiempo real, 24/7, y el destino se resuelve en runtime contra el directorio central.
Usa este flujo cuando tu negocio empuja dinero a un usuario final — reembolsos, nómina por Bre-B, pagos a vendedores de marketplace, barridos de tesorería a otro participante o retiros de clientes.
Esta página es un esqueleto de flujo. La versión completa incluirá ejemplos de código para cada paso y patrones de conciliación. La secuencia, el ciclo de vida y el catálogo de errores ya están documentados en detalle — ver abajo y las páginas enlazadas.
Antes de empezar
Vas a necesitar:
- Una cuenta de Bre-B participant con Mono y credenciales OAuth de cliente. Ver Autenticación.
- Una cuenta tenant con saldo suficiente para cubrir la transferencia.
- Un endpoint de webhook suscrito a eventos de transferencia saliente y eventos de target-resolution, con verificación de firma en su lugar.
- Una clave de idempotencia por transferencia.
Visión general de la secuencia
- Resuelve el target — envía la llave de pago destino a Mono. Mono consulta el directorio Bre-B y devuelve el nombre y banco del titular para confirmación.
- Confirma con el pagador — muestra el nombre resuelto al usuario y obtén una confirmación explícita antes de despachar.
- Despacha la transferencia — llama al endpoint de transferencia saliente con el target resuelto, monto, moneda y clave de idempotencia.
- Rastrea el ciclo de vida — la transferencia se mueve por estados pending, sent, accepted, settled o rejected. Los webhooks disparan en cada transición.
- Concilia — en settlement, acredita la operación en tus libros; en rechazo, surface el motivo de la falla al usuario usando el catálogo de errores.
Pasos
El paso a paso completo (con muestras de curl, Node.js y Python) está pendiente. Hasta que se publique, consulta:
- Estados de la transferencia saliente — la máquina de estados completa, transiciones y estados terminales.
- Errores de transferencia saliente — motivos de rechazo y manejo recomendado.
- Payloads de webhook — el envelope y los schemas de eventos.
- Firmas de webhook — verificación HMAC-SHA256.
- Sandbox: transferencias salientes — simula el ciclo de vida completo sin dinero real.
Siguientes pasos
- Recaudo por QR — la contraparte de payin de este flujo.
- Estados de la transferencia saliente — el ciclo de vida que sigue cada transferencia saliente.
- Claves de idempotencia — requeridas para reintentos seguros en cada despacho.