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

# Wallet

> Consultez vos soldes par pays et les taux de change appliqués aux transferts interwallet.

Toutes les routes nécessitent votre clé API secrète (`Authorization: Bearer sk_...`) ou une session dashboard.

<Note>
  La gestion du wallet (méthodes de retrait, demandes de retrait, transferts interwallet, relevé détaillé des mouvements) se fait **exclusivement depuis le [tableau de bord](https://app.alphapay.me)**, pas via l'API. Seule la consultation des soldes et des taux de change reste accessible par clé API — voir [Accès dashboard vs. clé API](/account-setup#acc%C3%A8s-dashboard-vs-cl%C3%A9-api).
</Note>

## Un wallet par (marchand, pays)

Contrairement à une approche par devise, AlphaPay tient un solde distinct pour **chaque pays** où vous encaissez — jamais un solde global par devise. C'est un choix structurant : plusieurs pays partagent parfois la même devise (le XOF pour le Bénin, le Togo, la Côte d'Ivoire, le Sénégal...), et confondre les deux masquerait dans quel pays l'argent se trouve réellement.

```
Votre marchand
│
├── Wallet Bénin (XOF)   ── available_amount, pending_amount, is_frozen
├── Wallet Sénégal (XOF) ── un solde distinct, même devise
└── Wallet Cameroun (XAF)
```

Un wallet est créé automatiquement dès qu'un mouvement l'exige (premier encaissement dans ce pays, par exemple) — il n'y a pas de création manuelle.

## Soldes

Lecture seule stricte : aucune écriture n'est possible côté marchand, le solde ne bouge que via les mouvements internes de la plateforme (encaissement, retrait, ajustement admin...).

* [Lister les soldes](/api-reference/wallet/balances-list)
* [Récupérer un solde](/api-reference/wallet/balances-get)

<Note>
  Pas de filtre `?country=` disponible sur la liste — récupérez tous vos soldes et filtrez côté client.
</Note>

Le champ `is_frozen` mérite attention : quand il vaut `true`, les **entrées restent acceptées** (vos encaissements continuent d'être crédités) mais toutes les **sorties sont bloquées** (retrait, transfert sortant). Un gel est toujours décidé côté plateforme, jamais déclenché par le marchand.

## Taux de change

Les taux appliqués aux transferts interwallet lors d'une conversion de devise.

* [Lister les taux de change](/api-reference/wallet/exchange-rates-list)

<Note>
  Pas de filtre par paire de devises — listez tout et filtrez côté client.
</Note>