Skip to main content
Toutes les routes nécessitent votre clé API secrète (Authorization: Bearer sk_...) ou une session dashboard.
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, 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.

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.
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…).
Pas de filtre ?country= disponible sur la liste — récupérez tous vos soldes et filtrez côté client.
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.
Pas de filtre par paire de devises — listez tout et filtrez côté client.