Soldes

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 payout Orange de Côte d’Ivoire, même si l’un est largement créditeur et l’autre vide.

Structure

Chaque solde est identifié par cinq éléments :

Champ	Exemple	Rôle
`channel`	`mobile_money` ou `card`	Canal d’encaissement
`country`	`CMR`	Pays, en mobile money seulement
`provider`	`MTN_MOMO_CMR`	Opérateur, en mobile money seulement
`currency`	`XAF`	Devise du solde
`available_balance`, `pending_balance`	`4825`, `0`	En unités mineures

Les soldes carte ont country et provider à null.

Disponible et en attente

available_balance est ce que vous pouvez effectivement verser par payout 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 payout. La carte, elle, crédite d’abord pending_balance, avec un délai de sécurité de quelques jours (2 jours actuellement) 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 :

{
  "data": {
    "merchant": { "name": "Boutique Ada" },
    "wallets": [
      {
        "uuid": "3f1a8c2e-5b7d-4e9a-8c61-0d2f4b9a7e15",
        "channel": "mobile_money",
        "country": "CMR",
        "provider": "MTN_MOMO_CMR",
        "currency": "XAF",
        "available_balance": 9500,
        "pending_balance": 0
      },
      {
        "uuid": "7c4e9b1d-2a8f-4d3e-9b60-5e1a3c8d2f97",
        "channel": "card",
        "country": null,
        "provider": null,
        "currency": "USD",
        "available_balance": 0,
        "pending_balance": 4650
      }
    ]
  }
}

La liste seule est disponible avec GET /api/v1/wallets.

Démarrage

Concepts

Guides

Webhooks

Ressources

Structure

Disponible et en attente

Exemple

​Structure

​Disponible et en attente

​Exemple

Structure

Disponible et en attente

Exemple