# Créditos

Saldo y movimientos de tu cuenta. Para **partners**, además, asignar y recuperar créditos de tus clientes. Base: `https://panel.anunzi.net/api/v1/credits/`.

| Método | Ruta | Descripción |
| ------ | ---- | ----------- |
| `GET`  | `balance.php` | Saldo de la cuenta (plan, recarga, total, y pool si es partner). |
| `GET`  | `ledger.php` | Movimientos de créditos (paginado). |
| `GET`  | `clients.php` | *(Partner)* Tus clientes con su saldo. |
| `POST` | `allocate.php` | *(Partner)* Asigna créditos de tu pool a un cliente. |
| `POST` | `reclaim.php` | *(Partner)* Recupera créditos no usados de un cliente. |

***

## Saldo

```bash
curl "https://panel.anunzi.net/api/v1/credits/balance.php" \
  -H "Authorization: Bearer anz_live_TU_API_KEY"
```

Devuelve `{ "plan": N, "recarga": N, "total": N }` (y `"pool"` si sos partner).

## Asignar créditos a un cliente *(partner)*

```json
POST allocate.php
{ "client_user_id": 456, "amount": 1000, "note": "Alta mensual" }
```

Descuenta de tu pool y acredita al cliente. Devuelve el pool restante. El cliente debe pertenecer a tu cuenta partner.

## Recuperar créditos de un cliente *(partner)*

```json
POST reclaim.php
{ "client_user_id": 456, "amount": 500 }
```

Solo recupera hasta el saldo actual del cliente.

## Movimientos

`GET /api/v1/credits/ledger.php?limit=50` → lista de asientos (`amount`, `kind`, `note`, `created_at`).