> ## 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 retrait Orange de Côte d'Ivoire, même si l'un est largement créditeur et l'autre vide.

## Dans le tableau de bord

**Soldes** affiche ce qui est **Disponible** et **En attente**, regroupé par **Pays** ou par **Moyens de paiement**, en cartes ou en liste.

![La page Soldes, avec le disponible et l'en attente par pays et par opérateur](https://docs.mercy-pay.com/images/payouts/balances-light.webp)
![La page Soldes, avec le disponible et l'en attente par pays et par opérateur](https://docs.mercy-pay.com/images/payouts/balances-dark.webp)

## 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 retrait 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 retrait. La carte, elle, crédite d'abord `pending_balance`, le temps que les fonds nous soient versés, en général sous 5 jours, 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`](https://docs.mercy-pay.com/api/account/get) contient :

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "merchant": {
      "name": "Boutique Ada"
    },
    "wallets": [
      {
        "id": "wal_3f1a8c2e5b7d4e9a8c610d2f4b9a7e15",
        "object": "wallet",
        "livemode": false,
        "created": "2026-10-02T14:05:00+00:00",
        "channel": "mobile_money",
        "country": "CMR",
        "provider": "MTN_MOMO_CMR",
        "currency": "XAF",
        "available_balance": 9500,
        "pending_balance": 0
      },
      {
        "id": "wal_7c4e9b1d2a8f4d3e9b605e1a3c8d2f97",
        "object": "wallet",
        "livemode": false,
        "created": "2026-10-02T14:05:00+00:00",
        "channel": "card",
        "country": null,
        "provider": null,
        "currency": "USD",
        "available_balance": 0,
        "pending_balance": 4650
      }
    ]
  }
}
```

La liste seule est disponible avec [`GET /api/v1/wallets`](https://docs.mercy-pay.com/api/wallets/list).

## Virer entre deux opérateurs

Un retrait puise dans le solde de l'opérateur qui reçoit. Vos clients paient surtout par MTN et vous voulez retirer vers Orange ? Ouvrez le solde du pays et choisissez **Virer vers un autre opérateur**, ou utilisez [`POST /api/v1/wallet_transfers`](https://docs.mercy-pay.com/api/wallet-transfers/create). Le montant passe tout de suite d'un solde à l'autre, sans frais. Les deux soldes doivent être du même pays et de la même devise : un solde carte ne peut pas y prendre part.


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