Skip to main content
POST
Solicitar dispersión
Dispersa el balance de tu cuenta OnePay a una cuenta bancaria registrada de tu empresa. Ambos parámetros son opcionales:
  • Si no envías amount, se dispersa el balance completo.
  • Si no envías account_id, se usa la cuenta bancaria principal (fundable) de tu empresa.
La cuenta bancaria debe pertenecer directamente a tu empresa. Cuentas de tipo PSE no son elegibles como cuenta principal. Si envías un account_id que pertenece a un cliente o invitado, recibirás un error company_account_not_found.

Headers

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

Body

amount
number
Monto a dispersar en pesos (COP). Mínimo $10.000. Si no se envía, se dispersa el balance completo.
account_id
string
ID de la cuenta bancaria destino. Debe pertenecer a tu empresa (no a un cliente o invitado). Si no se envía, se usa la cuenta principal. Aprende a registrar cuentas.

Ejemplos de uso

Errores