# Saldo

Consulta el saldo de tu cuenta de cobro, disponible y pendiente, en USD.

> [!WARNING]
> El SDK `vexor` de npm (Stripe, MercadoPago, PayPal, Square, Talo) está **deprecado**: ya no se mantiene y no debe usarse. vexorpay es hoy una **API REST de links de pago en USD, sin SDK oficial**. Migración: <https://developers.vexorpay.com/docs/migracion-desde-el-sdk>

Fuente: <https://developers.staging.vexorpay.com/docs/api/balance>

`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](/docs/api/payouts). El entorno lo define la API key: con una clave de prueba
(`vxp_test_...`) lees el saldo de prueba de sandbox.

**curl**

```bash
curl https://api.vexorpay.com/api/v1/balance \
  -H "Authorization: Bearer vxp_live_tu_clave"
```

**Node.js**

```js
const res = await fetch('https://api.vexorpay.com/api/v1/balance', {
  headers: { Authorization: 'Bearer vxp_live_tu_clave' },
})

const data = await res.json()
```

**PHP**

```php
<?php

$client = curl_init('https://api.vexorpay.com/api/v1/balance');
curl_setopt_array($client, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer vxp_live_tu_clave'],
]);

$data = json_decode(curl_exec($client), true);
```

**Python**

```python

response = requests.get(
    'https://api.vexorpay.com/api/v1/balance',
    headers={'Authorization': 'Bearer vxp_live_tu_clave'},
)
data = response.json()
```

**Go**

```go
req, _ := http.NewRequest("GET", "https://api.vexorpay.com/api/v1/balance", nil)
req.Header.Set("Authorization", "Bearer vxp_live_tu_clave")

res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
```

### Respuesta exitosa

`200 OK`

```json
{
  "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. |