Consulter le solde
Solde
Consulter le solde
Récupérer les soldes disponibles, par devise et par catégorie
GET
Consulter le solde
Récupère l’ensemble de vos soldes, regroupés par devise puis par catégorie.
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.
Solde disponible et solde en attente
- available — utilisable immédiatement, notamment pour un payout
- pending — en attente de confirmation par le fournisseur de paiement
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