Retiros
Consulta los retiros de tu cuenta de cobro.
El saldo disponible se retira desde el portal de retiros de tu cuenta de cobro (dashboard → Retirar) a la cuenta bancaria (u otro medio de retiro) que configures ahí, 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.
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. |