Dispersiones
Envía dinero desde una cuenta de ledger de Core hacia un destino.
Una dispersión es un movimiento de fondos hacia afuera de una cuenta de ledger de Core. El destino puede ser otra cuenta de ledger dentro de Core (una transferencia interna) o una cuenta bancaria colombiana externa (en cuyo caso Core delega la ejecución a nivel de riel a Banking). En cualquier caso, la dispersión produce un par balanceado de entradas de ledger: un débito en la cuenta origen y un crédito en la cuenta destino — el mismo patrón de partida doble que sigue cada movimiento en Core.
Usa dispersiones cuando tu producto necesite empujar dinero hacia afuera de un saldo — retiros, settlements de vendedores de marketplace, nómina, reembolsos o barridos de tesorería.
Qué es
Una dispersión tiene una cuenta de ledger origen, un destino, un monto, una divisa y un estado. La máquina de estados es:
pending → processing → settled
└→ failedLas transiciones exactas y los estados terminales se documentarán en la versión completa de esta página.
Dispersiones internas vs. externas
| Tipo | Destino | Riel |
|---|---|---|
| Interna | Otra cuenta de ledger de Core | Entrada de ledger en el mismo tenant — instantáneo. |
| Externa | Cuenta bancaria colombiana | Banking maneja el riel (Turbo, ACH, Transfiya). |
Las dispersiones externas heredan el enrutamiento, fallback y comportamiento de confirmación de Banking.
Modelo de datos
El schema completo vive en la referencia de API de dispersiones de Core.
Eventos de webhook
Las dispersiones emiten eventos en cada transición de estado. Ver webhooks de Core.
Siguientes pasos
- Ledger — las cuentas entre las que las dispersiones mueven dinero.
- Transferencias de Banking — la mecánica a nivel de riel para destinos externos.
- Flujo de dispersión — caso de uso de extremo a extremo.