Skip to main content
GET
Consulter le solde
Récupère l’ensemble de vos soldes, regroupés par devise puis par catégorie.
Changement de format. La réponse ne contient plus de bloc mono-devise à la racine (currency, categories, totals). Ces champs ont été remplacés par le tableau balances, qui liste une entrée par devise détenue. Voir Migration.

Authentification

Requête

Réponse

Champs de réponse

Les totaux ne sont jamais agrégés entre devises : additionner des XOF et des CDF n’aurait aucun sens, et un total unique en masquerait une. À vous de convertir si vous souhaitez afficher une valeur consolidée.

Catégories

Ces trois catégories sont toujours présentes, à zéro le cas échéant. D’autres peuvent apparaître si votre compte en utilise.

Mode de solde

balanceMode détermine quel portefeuille finance vos payouts.
En mode unified, un solde payout à zéro n’est pas une anomalie. Fiez-vous à payoutSourceCategory pour savoir où lire le solde qui compte réellement.

Solde disponible et solde en attente

  • available — utilisable immédiatement, notamment pour un payout
  • pending — en attente de confirmation par le fournisseur de paiement
Les fonds passent de pending à available après confirmation, généralement en quelques heures.

Migration depuis l’ancien format

L’ancienne réponse exposait un seul jeu de soldes, implicitement dans la devise du compte. Un marchand encaissant en XAF ou en CDF ne voyait donc pas ces fonds.

Utilisation

  • Vérifier le solde disponible avant un payout, dans la devise du payout
  • Afficher vos soldes multi-devises dans votre propre interface
  • Déclencher des alertes de solde bas par devise