Skip to main content

​
¿Qué es una Dispersión?

Una dispersión (cashout) permite enviar dinero desde tu saldo en OnePay a la cuenta bancaria o billetera digital de un tercero. Es el flujo inverso al cobro: en lugar de recibir dinero, lo envías.
Para cobrar dinero a un cliente, usa Payments (link de pago) o Charges (débito directo).

​
¿Cuándo usar Dispersiones?

  • Pago a proveedores
  • Dispersión de nómina
  • Reembolsos a clientes
  • Pagos de marketplace a vendedores
  • Retiros de billetera

​
Tipos de dispersión

TipoVelocidadCoberturaIdeal para
Turbo30-120 minBancos principales + Nequi/DaviplataPagos urgentes, experiencia en tiempo real
ACH8-36 horas28+ entidades financierasPagos masivos, nómina, mayor cobertura

​
Ejemplo rápido

curl https://api.onepay.la/v1/cashouts \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: disp-001" \
  -d '{
    "customer_id": "CUSTOMER_ID",
    "account_id": "ACCOUNT_ID",
    "amount": 150000,
    "description": "Pago proveedor Enero"
  }'

​
Tiempos de procesamiento (Turbo)

BancoOperaciónTiempo promedioTiempo máximoRestricciones
Bancolombia24/730 min120 min
Davivienda24/730 min120 min
BBVALun-Vie60 min180 minSolo 6:00 a 19:00
Daviplata24/760 min120 min
Nequi24/760 min120 minPagos de 10PM a 6AM se procesan a las 6AM
Banco de Bogotá24/760 min120 minPagos de 20:30 a 3:45 se procesan a las 4:00
Grupo AvalLun-Vie60 min120 minSolo 6:00 a 17:30

​
Estados de una dispersión

EstadoDescripción
scheduledProgramada para procesarse en una fecha futura
to_processLista para ser procesada
require_approvalRequiere aprobación manual (según configuración)
processingEn proceso de transferencia
processedTransferencia exitosa
failedError en la transferencia
cancelledCancelada antes de procesarse

​
Endpoints

MétodoEndpointDescripción
POST/cashoutsCrear dispersión
GET/cashoutsListar dispersiones
GET/cashouts/Detalle de una dispersión