Skip to main content
POST
https://api.onepay.la/v1
/
balances
/
cashout
Solicitar dispersión
curl --request POST \
  --url https://api.onepay.la/v1/balances/cashout \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency: <x-idempotency>' \
  --data '
{
  "amount": 123,
  "account_id": "<string>"
}
'
{
  "id": "9e5d2f3a-8c1b-4e6f-9d0a-bc789def1234",
  "amount": 500000,
  "amount_label": "$500.000",
  "status": "pending",
  "type": "ACH",
  "account": {
    "id": "9d0ac58c-2226-4f1c-b305-15e6dc3b47f6",
    "subtype": "SAVINGS",
    "bank": {
      "id": "9957817c-f17e-472b-b531-e3d1490bf757",
      "name": "Bancolombia",
      "logo": "https://example.com/logo.png"
    }
  },
  "created_at": "2025-02-08T10:30:00.000000Z",
  "processed_at": null,
  "is_test": false
}

​
Headers

​
x-idempotency
string
required
Token único para garantizar la idempotencia de la petición
​
amount
number
required
Monto a dispersar
​
account_id
string
required
ID de la cuenta bancaria destino. Aprende a registrar cuentas.
{
  "id": "9e5d2f3a-8c1b-4e6f-9d0a-bc789def1234",
  "amount": 500000,
  "amount_label": "$500.000",
  "status": "pending",
  "type": "ACH",
  "account": {
    "id": "9d0ac58c-2226-4f1c-b305-15e6dc3b47f6",
    "subtype": "SAVINGS",
    "bank": {
      "id": "9957817c-f17e-472b-b531-e3d1490bf757",
      "name": "Bancolombia",
      "logo": "https://example.com/logo.png"
    }
  },
  "created_at": "2025-02-08T10:30:00.000000Z",
  "processed_at": null,
  "is_test": false
}