> For the complete documentation index, see [llms.txt](https://docs.intram.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intram.org/merchant-api-v1/balance.md).

# Solde du wallet

Lire le solde du wallet marchand par moyen de paiement.

Renvoie le solde du wallet, ventilé par moyen de paiement, pour l'environnement de la clé présentée (sandbox vs live).

## Requête

```http
GET /v1/balance
X-Api-Key:    pk_live_…
X-Timestamp:  2026-05-20T10:30:00.000Z
X-Signature:  sha256=…
```

Aucun body. Aucun paramètre de query.

## Réponse `200 OK`

```json
{
  "error": false,
  "http_status": 200,
  "data": {
    "currency": "XOF",
    "payment_method_balances": [
      {
        "payment_method": "MTN Bénin",
        "available": 800000,
        "pending": 0
      },
      {
        "payment_method": "Moov Bénin",
        "available": 440000,
        "pending": 35000
      }
    ]
  }
}
```

## Champs

| Champ                                      | Type           | Description                                                           |
| ------------------------------------------ | -------------- | --------------------------------------------------------------------- |
| `http_status`                              | number         | Écho du code HTTP de la réponse                                       |
| `currency`                                 | string \| null | Code alphabétique de la devise principale du wallet (`XOF`, `EUR`, …) |
| `payment_method_balances[]`                | array          | Décomposition par moyen de paiement                                   |
| `payment_method_balances[].payment_method` | string         | Nom du moyen de paiement (`MTN Bénin`, `Moov Bénin`, `Carte Visa`, …) |
| `payment_method_balances[].available`      | number         | Montant disponible pour ce moyen de paiement                          |
| `payment_method_balances[].pending`        | number         | Montant en attente de settlement pour ce moyen de paiement            |

## Cas limites

* **Aucun wallet provisionné** : la réponse est `200` avec `currency: null` et `payment_method_balances: []`.
* **Erreur interne** : `500` avec `code: "internal_error"`.

## Synchrone — pas d'opération créée

Contrairement aux mutations, cet endpoint n'ajoute pas de ligne dans la file des opérations et n'exige pas d'`Idempotency-Key`.

## Voir aussi

* [Statut d'une opération](/merchant-api-v1/operations.md) — pour suivre les payouts / refunds en cours
* [Sandbox vs Live](/merchant-api-v1/sandbox-vs-live.md) — le solde renvoyé dépend de la clé utilisée