Le verdict en trois phrases
Des que votre marketplace depasse une poignee de vendeurs, le payout manuel devient un gouffre de temps et d'erreurs. L'API de disbursement (Wave, MTN MoMo, Moov Money) traite des lots de centaines de reversements en une requete, avec callback de confirmation et retry automatique. Bien pilotee, elle paie tous vos vendeurs le meme jour, gere les 3 % d'echecs et se reconcilie par ID de lot.
Comparatif des API de disbursement
Les trois grands operateurs ivoiriens offrent des capacites proches, avec des nuances a connaitre :
| Operateur | Frais payout | Taille de lot | Callback | Plafond/jour |
|---|---|---|---|---|
| Wave | ~1 % | Jusqu'a 1 000 | Oui, temps reel | 5 000 000 FCFA |
| MTN MoMo | ~1 % | Jusqu'a 1 000 | Oui, asynchrone | 5 000 000 FCFA |
| Moov Money | ~1,2 % | Jusqu'a 500 | Oui, asynchrone | 3 000 000 FCFA |
Wave se distingue par un callback en temps reel qui confirme chaque reversement individuellement, tandis que MTN et Moov confirment le lot de facon asynchrone. Pour une marketplace multi-operateurs, on route chaque vendeur vers son propre operateur.
Gerer les echecs : retry et reconciliation par lot
Aucun payout n'est fiable a 100 %. Voici les causes d'echec et le taux observe :
| Cause d'echec | Taux (estimation 2026) | Traitement |
|---|---|---|
| Numero errone / inactif | ~1,5 % | Notifier le vendeur, corriger |
| Plafond destinataire atteint | ~0,8 % | Reporter au lot suivant |
| Timeout operateur | ~0,5 % | Retry auto 2x |
| Solde plateforme insuffisant | ~0,2 % | Alerte tresorerie |
Au total, on observe environ 3 % d'echecs par lot. La regle : un retry automatique 2 fois absorbe la majorite des timeouts, puis les echecs residuels partent en file de traitement manuel. Chaque lot porte un ID unique qui permet de reconcilier au franc pres : montant envoye = somme des reversements reussis + montant des echecs remis en file.
L'architecture idempotente du batch
Comme pour les webhooks, un batch de payout doit etre idempotent : si vous relancez un lot apres un timeout reseau, il ne faut pas payer deux fois. On attribue une cle d'idempotence par reversement (ID vendeur + periode + montant) que l'operateur reconnait pour ignorer les doublons. C'est ce qui rend le retry sans danger.
Mini cas pratique
Koffi opere une marketplace de services a Abidjan avec 80 vendeurs payes chaque semaine, pour un volume de reversement de 6 400 000 FCFA hebdomadaire. En manuel, il passe 5 heures par semaine a saisir les numeros et montants, avec un risque d'erreur de saisie non negligeable.
Besoin d'un site web professionnel ?
Kolonell crée des sites web qui attirent des clients, optimisés pour le marché sénégalais. Devis gratuit en 2 minutes.
En basculant sur l'API de disbursement, il envoie un lot unique : temps de preparation 20 minutes, execution quelques secondes. Les frais de 1 % representent 64 000 FCFA par semaine. Sur 80 reversements, environ 2 a 3 echouent (numero errone), rattrapes par retry ou traitement manuel. Gain : 4 h 40 par semaine, soit plus de 18 heures par mois rendues au business, et zero erreur de saisie.
FAQ
Combien coutent les frais de payout par operateur ?
Environ 1 % chez Wave et MTN MoMo, 1,2 % chez Moov Money en ordre de grandeur 2026. Sur un lot de 6 400 000 FCFA, cela represente 64 000 a 77 000 FCFA.
Quel taux d'echec faut-il anticiper ?
Environ 3 % par lot, principalement des numeros errones ou inactifs (~1,5 %). Un retry automatique 2 fois absorbe la plupart des timeouts.
Combien de destinataires par lot ?
Jusqu'a 1 000 destinataires chez Wave et MTN, 500 chez Moov. Au-dela, on decoupe en plusieurs lots, chacun avec son ID de reconciliation.
Y a-t-il un plafond de payout journalier ?
Oui, de l'ordre de 5 000 000 FCFA/jour chez Wave et MTN, 3 000 000 chez Moov. Les gros volumes s'etalent ou passent par une hausse de plafond negociee.
Le retry risque-t-il de payer deux fois ?
Non, si vous utilisez une cle d'idempotence par reversement. L'operateur reconnait le doublon et l'ignore, ce qui rend le retry totalement sur.
Discutons de votre projet. Nous automatisons vos payouts vendeurs multi-operateurs avec retry, idempotence et reconciliation par lot. WhatsApp +221 77 596 93 33.
Mohamed Bah
Fondateur, Kolonell
Passionné par le digital et l'entrepreneuriat en Afrique, Mohamed accompagne les entreprises sénégalaises dans leur transformation digitale depuis 2020. Fondateur de Kolonell, il croit que chaque PME mérite une présence en ligne professionnelle et accessible.
