Skip to main content
Mercy Pay relie votre application et vos clients. Un encaissement passe par deux flux possibles, mais finit toujours de la même façon.

​
Le parcours d’un encaissement

Avec la page hébergée (la plus simple à mettre en place) :
  1. Votre serveur crée une session de checkout (POST /api/v1/checkout-sessions) et reçoit une checkout_url.
  2. Votre client ouvre cette page et choisit Mobile money ou Carte bancaire.
  3. Mercy Pay crée un paiement et le traite.
Avec la charge directe (voir Accepter un paiement), vous sautez les deux premières étapes : votre serveur appelle POST /api/v1/payments avec le numéro et l’opérateur du client, sans jamais le rediriger vers Mercy Pay. Troisième option quand vous ne voulez pas créer de session par client : un lien de paiement, créé une fois et payable par autant de clients que nécessaire. Chaque paiement y crée une session comme les deux flux ci-dessus. Dans tous les cas, la suite est identique : Mercy Pay confirme le résultat, enregistre le paiement, calcule la commission, crédite le solde correspondant, puis vous envoie un événement payment.succeeded ou payment.failed.

​
Les soldes

Un solde est rattaché à un canal, un pays et un opérateur, pour une devise donnée : il y en a un pour la carte bancaire, et un par pays et par opérateur mobile money. Cette granularité n’est pas arbitraire : elle reflète le fait que l’argent lui-même reste cantonné à ce circuit jusqu’à ce que vous le versiez. Un encaissement MTN au Cameroun crédite exactement le solde CMR · MTN_MOMO_CMR, jamais le solde carte ni un autre pays, et un payout ne peut puiser que dans le solde du pays et de l’opérateur choisis. Voir Soldes.

​
Pays et opérateurs

Les pays sont notés en ISO 3166-1 alpha-3. Les codes opérateurs sont à transmettre tels quels.

​
Commission

Mercy Pay prélève une commission sur le montant brut de chaque paiement, et vous crédite du net (net = brut − commission). Rien à calculer ni à reverser de votre côté. Le taux dépend du moyen de paiement : 3,5 % en mobile money, 5 % par carte, sauf accord contraire. Un paiement mobile money de 5 000 XAF crédite donc 4 825 XAF à votre solde. Les payouts suivent le même principe avec un taux distinct de 2 %, voir Payouts.