Dispersión

Una dispersión es el flujo de extremo a extremo de mover dinero hacia afuera de una cuenta de ledger de Core: disparar la dispersión, observar su transición por el ciclo de vida, manejar éxito o falla y conciliar el ledger. Las dispersiones internas (de cuenta a cuenta dentro de Core) se liquidan instantáneamente; las externas (a cuentas bancarias colombianas) viajan por los rieles de Banking y heredan los tiempos de confirmación de Banking.

Usa este flujo cuando un saldo le sea exigible a su dueño — un usuario de billetera solicita un retiro, se cierra la ventana de settlement de un vendedor de marketplace, corre la nómina o un barrido de tesorería mueve fondos entre cuentas internas.

Antes de empezar

Vas a necesitar:

• Una API key de Core con el scope payouts.
• Una cuenta de ledger origen con saldo suficiente.
• Un destino — otra cuenta de ledger (interna) o una cuenta bancaria colombiana (externa).
• Un endpoint de webhook suscrito a eventos de dispersión.
• Una clave de idempotencia por dispersión.

Resumen de la secuencia

Dispersión interna

1. Envía la dispersión con origen, destino, monto y clave de idempotencia.
2. Core registra una transacción de ledger balanceada.
3. El webhook se dispara con el estado final.

Dispersión externa

1. Envía la dispersión con origen, cuenta bancaria destino, monto y clave de idempotencia.
2. Core registra un hold sobre la cuenta origen y despacha la transferencia a Banking.
3. Banking enruta la transferencia (Turbo, ACH, Transfiya) y devuelve una confirmación.
4. Core convierte el hold en un settlement en caso de éxito, o lo libera en caso de rechazo.
5. El webhook se dispara con el estado final.

Pasos

El paso a paso completo está pendiente. Hasta que se publique, ver:

• Página de concepto de Dispersiones.
• Página de concepto de transferencias de Banking — para destinos externos.
• Referencia de API de dispersiones de Core.

Siguientes pasos

• Contabilidad de ledger
• Flujo de transferencias de Banking
• Idempotency Keys