Saldo
Consulta el saldo de tu cuenta de cobro, disponible y pendiente, en USD.
GET /api/v1/balance
Devuelve el saldo de tu cuenta de cobro, donde se acreditan tus ventas (ya descontadas la comisión de vexorpay y las de procesamiento). Los montos van en centavos de USD.
| Campo | Qué es |
|---|---|
currency | Siempre usd. |
availableCents | Disponible para retirar. |
pendingCents | Cobrado pero todavía no disponible: cada cobro queda pendiente unos días hasta que se libera. |
reserveCents | Retenido como reserva (por ejemplo, para cubrir reembolsos o disputas). null si no se informa. |
asOf | Momento de la lectura. |
Los reembolsos, las disputas y sus fees se descuentan de este saldo. Para retirar, ver
Retiros. El entorno lo define la API key: con una clave de prueba
(vxp_test_...) lees el saldo de prueba de sandbox.
curl https://api.vexorpay.com/api/v1/balance \
-H "Authorization: Bearer vxp_live_tu_clave"Respuesta exitosa
200 OK
{
"currency": "usd",
"availableCents": 4713,
"pendingCents": 1709,
"reserveCents": null,
"asOf": "2026-01-02T12:06:00.000Z"
}Errores
| Error | HTTP | Causa |
|---|---|---|
payment_account_not_ready | 409 | Todavía no activaste tu cuenta de cobro. |
upstream_error | 502 | El procesador de pagos no respondió. Reintenta en unos minutos. |
unexpected_error | 500 | No pudimos leer el saldo de tu cuenta. |