> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercy-pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Soldes

> Vos soldes sont séparés par canal, par pays et par opérateur. Chaque encaissement crédite le solde qui lui correspond.

Un **solde** (wallet) contient les fonds que Mercy Pay vous doit à un moment donné. Vos soldes ne sont **jamais mélangés** entre eux : un solde MTN du Cameroun ne peut pas financer un payout Orange de Côte d'Ivoire, même si l'un est largement créditeur et l'autre vide.

## Structure

Chaque solde est identifié par cinq éléments :

| Champ | Exemple | Rôle |
| - | - | - |
| `channel` | `mobile_money` ou `card` | Canal d'encaissement |
| `country` | `CMR` | Pays, en mobile money seulement |
| `provider` | `MTN_MOMO_CMR` | Opérateur, en mobile money seulement |
| `currency` | `XAF` | Devise du solde |
| `available_balance`, `pending_balance` | `4825`, `0` | En unités mineures |

Les soldes carte ont `country` et `provider` à `null`.

## Disponible et en attente

`available_balance` est ce que vous pouvez effectivement verser par payout dès maintenant. `pending_balance` contient des fonds déjà comptés mais pas encore disponibles.

Le mobile money crédite directement `available_balance` : dès qu'un paiement passe à `succeeded`, le solde correspondant est disponible pour un payout. La carte, elle, crédite d'abord `pending_balance`, avec un délai de sécurité de quelques jours (2 jours actuellement) avant que les fonds basculent automatiquement vers `available_balance`, sans action de votre part.

## Exemple

Après un encaissement au Cameroun (MTN), déjà disponible, et une carte internationale en USD encaissée hier et toujours en attente, la réponse de [`GET /api/v1/account`](/api/account) contient :

```json theme={null}
{
  "data": {
    "merchant": { "name": "Boutique Ada" },
    "wallets": [
      {
        "uuid": "3f1a8c2e-5b7d-4e9a-8c61-0d2f4b9a7e15",
        "channel": "mobile_money",
        "country": "CMR",
        "provider": "MTN_MOMO_CMR",
        "currency": "XAF",
        "available_balance": 9500,
        "pending_balance": 0
      },
      {
        "uuid": "7c4e9b1d-2a8f-4d3e-9b60-5e1a3c8d2f97",
        "channel": "card",
        "country": null,
        "provider": null,
        "currency": "USD",
        "available_balance": 0,
        "pending_balance": 4650
      }
    ]
  }
}
```

La liste seule est disponible avec [`GET /api/v1/wallets`](/api/wallets).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.