Skip to main content
POST
Crear dispersión

Headers

string
required
Token único para garantizar la idempotencia de la petición

Body

number
required
Monto de la dispersión en unidades mayores de la moneda, no en centavos. Enviar 100000 dispersa $100.000 COP.
string
required
ID de la cuenta bancaria registrada. Aprende a registrar cuentas.
string
required
ID del cliente beneficiario. Crea primero el cliente.
string
Descripción de la dispersión (entre 10 y 100 caracteres). Alimenta el título que viaja al banco destino y se devuelve en la respuesta y en los webhooks cashout.*.
string
Referencia propia para conciliar (máx. 50 caracteres). Si no la envías, se usa el valor de description como referencia.
string
Concepto de la dispersión, entre 10 y 100 caracteres. Es el texto que viaja al banco como descripción de la transferencia; si lo omites se envía Transferencia de fondos.
Si no envías reference, la descripción también se guarda como referencia. Es el comportamiento histórico del endpoint y se mantiene por compatibilidad.
string
Identificador externo de la dispersión, máximo 100 caracteres. Es el único de los tres que se devuelve en la respuesta.
string
required
Moneda de la dispersión.
string
required
Método de dispersión.

Ejemplos de uso

Response

string
Identificador único de la dispersión.
string
Cliente beneficiario.
string
Cuenta bancaria donde se enviará el dinero.
number
Monto en unidades mayores de la moneda, no en centavos.
string
Moneda de la dispersión.
string
Estado actual (pending, processing, processed, failed).
string
Canal utilizado (ACH, TURBO).
date
Fecha de programación si existe.
string
Identificador externo que enviaste en la creación.
string | null
Descripción que enviaste en la creación.
string | null
Referencia de conciliación. Si no enviaste reference, aquí llega el valor de description.
date
Fecha de creación del registro.