Skip to main content
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.

Structure

Chaque solde est identifié par cinq éléments : 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 contient :
La liste seule est disponible avec GET /api/v1/wallets.

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. 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.