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.
Fees
Una dispersión a una cuenta bancaria puede llevar dos fees, ambos con precio definido por tus políticas de fees y devueltos en el calculated_fees de la dispersión:
| Tipo de fee | Qué es |
|---|---|
bank_transfer | Tu cobro por la transferencia — un monto fijo, un porcentaje, o ambos. |
bank_transfer_gmf | El traslado del GMF — el Gravamen a los Movimientos Financieros de Colombia, 0.4% del monto (el "4 × 1000") — cuando aplica a la dispersión. |
Los fees salen de la subcuenta origen junto con la dispersión: si fijas el monto que debe recibir el destino, el origen paga ese monto más los fees; si fijas el monto origen, el destino recibe ese monto menos los fees. Define un precio general en tus políticas base y sobrescríbelo cuando quieras cobrar de manera diferente por programa, por propietario de cuenta o por una sola cuenta.
Los mismos dos tipos de fee existen del lado de Mono: por cada dispersión, Mono te cobra sus propios bank_transfer y bank_transfer_gmf en tus cuentas, según lo acordado en tus términos comerciales. El listado de fees muestra ambos lados, diferenciados por owner. Ver Fees.
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.
- Políticas de fees — cómo ponerle precio a los fees de tus dispersiones.