Retraits

Un retrait transfère des fonds de votre solde vers un compte mobile money. Un solde carte peut aussi partir vers un compte bancaire (IBAN ou RIB), depuis le tableau de bord uniquement : l’API n’accepte que des destinations mobile money. C’est la seule façon de sortir de l’argent de Mercy Pay.

Demander un retrait

Depuis le tableau de bord, frais affichés avant de confirmer.

Retraits par l'API

Une demande de retrait depuis votre serveur.

Ce qui débite le solde

Un retrait puise dans le solde du même pays, du même opérateur et de la même devise que le bénéficiaire. Pour verser 4 000 XAF vers un numéro MTN du Cameroun, il vous faut un solde CMR · MTN_MOMO_CMR en XAF qui couvre ce montant : pas un solde Orange, pas un solde dans une autre devise, même équivalente. Pour retirer vers un autre opérateur du même pays, virez d’abord entre vos soldes.

Conditions

En live, deux conditions : votre KYC doit être approuvé, et le solde concerné doit couvrir le montant demandé. En sandbox, un retrait part tout de suite, sans KYC ni validation, depuis votre solde de test et vers un numéro Mobile Money de test. Voir Environnements.

Validation

En live, notre équipe valide chaque retrait à la main : ceux du tableau de bord, ceux de l’API et les retraits automatiques. Un compte suspendu ne peut plus en demander, et un retrait en attente n’est pas validé tant que la suspension dure.

Commission

Mercy Pay retient 2 % du montant demandé, le temps du virement. Un retrait de 4 000 XAF débite bien 4 000 XAF de votre solde, mais seuls 3 920 XAF partent effectivement vers le bénéficiaire.

Champ	Exemple	Signification
`amount`	`4000`	Montant demandé, débité de votre solde
`fee_amount`	`80`	Commission Mercy Pay (2 % de `amount`)
`net_amount`	`3920`	Montant réellement envoyé au bénéficiaire

fee_amount et net_amount sont figés au moment de la création du retrait. Un changement de taux de commission plus tard dans votre historique ne les recalcule jamais rétroactivement.

Statuts

Statut	Signification
`requested`	Demande enregistrée, en attente d’approbation
`approved`	Approuvé par Mercy Pay, envoyé à l’opérateur
`processing`	Virement en cours chez l’opérateur
`paid`	Versé sur le compte du bénéficiaire
`failed`	Échec côté opérateur, le motif est dans `failure_reason`
`rejected`	Refusé par Mercy Pay, le motif est dans `failure_reason`
`canceled`	Annulé avant son examen, ou pendant qu’il attendait un opérateur indisponible

Le champ status_detail précise un retrait encore en route :

`status_detail`	Signification
`delayed`	L’opérateur est indisponible : le retrait attend son retour. Vous pouvez l’annuler depuis le tableau de bord.
`pending_processing`	Le retrait n’est pas encore parti. Il partira automatiquement, sans action de votre part.

Le solde n’est débité qu’au passage à paid. Un retrait failed, rejected ou canceled ne touche jamais votre solde, même s’il a été approuvé entre-temps. Le montant doit simplement être disponible au moment de la demande.

Origine

Le champ origin dit d’où vient le retrait : dashboard, api ou automatic. Tous arrivent dans la même liste du tableau de bord, filtrable par origine.

Destination

{
  "type": "mobile_money",
  "country": "CMR",
  "provider": "MTN_MOMO_CMR",
  "phone": "237680000000"
}

Le numéro s’écrit avec l’indicatif du pays, sans le + (237 pour le Cameroun). Pour le Congo, la Côte d’Ivoire et le Bénin, gardez le 0 qui fait partie du numéro local.

Démarrage

Paiements

Liens de paiement

Abonnements

Soldes et retraits

Développeurs