Retiros
Consulta los retiros de tu cuenta de cobro.
El saldo disponible se retira desde el dashboard (Retirar) a una de tus cuentas de retiro (una cuenta bancaria o una wallet), en dólares o en tu moneda local según el país. Para retirar hace falta tener la identidad verificada. Cada retiro puede tener una comisión que depende del medio y del país.
Por la API los retiros son de sólo lectura: no se crean retiros por API, el retiro en sí se pide en el dashboard. Lo que sí puedes hacer por la API es agregar y listar las cuentas de retiro, para que estén listas a la hora de retirar: ver Cuentas de retiro.
Listar retiros
GET /api/v1/payouts
Lista tus retiros, del más nuevo al más viejo, incluidos los que hiciste desde el dashboard.
El entorno lo define la API key. Parámetros: limit, starting_after y ending_before.
curl "https://api.vexorpay.com/api/v1/payouts?limit=10" \
-H "Authorization: Bearer vxp_live_tu_clave"Respuesta exitosa
200 OK
{
"data": [
{
"id": "6a1d2e3f4b5c6d7e8f901234",
"amountCents": 4462,
"feeCents": 250,
"currency": "usd",
"status": "paid",
"createdAt": "2026-10-31T12:00:00.000Z",
"arrivalDate": "2026-11-02T09:30:00.000Z"
}
],
"has_more": false,
"total_count": 1,
"url": "/v1/payouts?limit=10"
}| Campo | Qué es |
|---|---|
amountCents | Monto del retiro, en centavos de USD. |
feeCents | Comisión del retiro. |
status | Estado del retiro (por ejemplo pending, in_transit, paid, failed o canceled). |
arrivalDate | Fecha estimada (o efectiva) de acreditación. null si todavía no se conoce. |
La conversión a tu moneda local la hace el procesador de pagos al momento del retiro.
Errores
| Error | HTTP | Causa |
|---|---|---|
validation_error | 400 | Cursor de paginación inválido. |
payment_account_not_ready | 409 | Todavía no activaste tu cuenta de cobro. |
upstream_error | 502 | El procesador de pagos no respondió. Reintentá en unos minutos. |