Envío de transferencias

Una transferencia bancaria es una dispersión: el dinero sale de tu cuenta Mono y llega a la cuenta bancaria de un beneficiario. Mono enruta transferencias por tres rails — ACH para transferencias estándar de mismo día, Transfiya para transferencias dentro de un clúster específico de bancos, y Mono Turbo para transferencias en tiempo real a bancos participantes — y cae automáticamente cuando un rail no soporta un destino.

Usa este flujo para corridas de nómina, settlement a proveedores, dispersiones a vendedores de marketplace, devoluciones o cualquier caso donde tu negocio empuja dinero hacia una cuenta bancaria conocida.

Antes de empezar

Vas a necesitar:

• Una cuenta Mono con Banking habilitado y una API key. Ver Autenticación.
• Saldo suficiente en la cuenta origen para cubrir la transferencia más cualquier comisión.
• Un endpoint de webhook que pueda recibir eventos de transferencia bancaria.
• Familiaridad con el concepto de transferencias.
• Una clave de idempotencia por cada transferencia para que los reintentos sean seguros.

Vista general de la secuencia

1. Prepara la transferencia — recolecta la cuenta destino, el monto, la moneda y la preferencia de routing (turbo, transfiya o ach). Genera una clave de idempotencia.
2. Envía — llama POST /transfers. Mono crea la transferencia en estado created y la agrupa en un lote. La respuesta confirma aceptación, no crédito.
3. Recibe confirmación — Mono dispara bank_transfer_approved cuando el rail acredita el destino, o bank_transfer_rejected si es rechazada. Los estados terminales de la transferencia son approved y declined.
4. Maneja los fallbacks — si el rail primario falla, Mono reintenta usando el fallback_routing que especificaste y dispara bank_transfer_fallback_routing antes del resultado final.

Pasos

El paso a paso completo (transferencias puntuales y por lote) está pendiente. Hasta que se publique, ver:

• La página de concepto de transferencias para opciones de routing, fallbacks y estados.
• La página de webhooks de transferencias bancarias para los payloads de los eventos.

Siguientes pasos

• Recaudo PSE — la contraparte de recaudo de este flujo.
• Webhooks de Banking — los eventos que guían la confirmación y el manejo de fallbacks.
• Claves de idempotencia — requeridas para reintentos seguros en cada transferencia.