Le verdict en trois phrases
Dès que votre marketplace dépasse une poignée 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 requête, avec callback de confirmation et retry automatique. Bien pilotée, elle paie tous vos vendeurs le même jour, gère les 3 % d'échecs et se réconcilie par ID de lot.
Comparatif des API de disbursement
Les trois grands opérateurs ivoiriens offrent des capacités proches, avec des nuances à connaître :
| Opérateur | Frais payout | Taille de lot | Callback | Plafond/jour |
|---|---|---|---|---|
| Wave | ~1 % | Jusqu'à 1 000 | Oui, temps réel | 5 000 000 FCFA |
| MTN MoMo | ~1 % | Jusqu'à 1 000 | Oui, asynchrone | 5 000 000 FCFA |
| Moov Money | ~1,2 % | Jusqu'à 500 | Oui, asynchrone | 3 000 000 FCFA |
Wave se distingue par un callback en temps réel qui confirme chaque reversement individuellement, tandis que MTN et Moov confirment le lot de façon asynchrone. Pour une marketplace multi-opérateurs, on route chaque vendeur vers son propre opérateur.
Gérer les échecs : retry et réconciliation par lot
Aucun payout n'est fiable à 100 %. Voici les causes d'échec et le taux observé :
| Cause d'échec | Taux (estimation 2026) | Traitement |
|---|---|---|
| Numéro erroné / inactif | ~1,5 % | Notifier le vendeur, corriger |
| Plafond destinataire atteint | ~0,8 % | Reporter au lot suivant |
| Timeout opérateur | ~0,5 % | Retry auto 2x |
| Solde plateforme insuffisant | ~0,2 % | Alerte trésorerie |
Au total, on observe environ 3 % d'échecs par lot. La règle : un retry automatique 2 fois absorbe la majorité des timeouts, puis les échecs résiduels partent en file de traitement manuel. Chaque lot porte un ID unique qui permet de réconcilier au franc près : montant envoyé = somme des reversements réussis + montant des échecs remis en file.
L'architecture idempotente du batch
Comme pour les webhooks, un batch de payout doit être idempotent : si vous relancez un lot après un timeout réseau, il ne faut pas payer deux fois. On attribue une clé d'idempotence par reversement (ID vendeur + période + montant) que l'opérateur reconnaît pour ignorer les doublons. C'est ce qui rend le retry sans danger.
Mini cas pratique
Koffi opère une marketplace de services à Abidjan avec 80 vendeurs payés chaque semaine, pour un volume de reversement de 6 400 000 FCFA hebdomadaire. En manuel, il passe 5 heures par semaine à saisir les numéros et montants, avec un risque d'erreur de saisie non négligeable.
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 préparation 20 minutes, exécution quelques secondes. Les frais de 1 % représentent 64 000 FCFA par semaine. Sur 80 reversements, environ 2 à 3 échouent (numéro erroné), rattrapés par retry ou traitement manuel. Gain : 4 h 40 par semaine, soit plus de 18 heures par mois rendues au business, et zéro erreur de saisie.
FAQ
Combien coûtent les frais de payout par opérateur ?
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 représente 64 000 à 77 000 FCFA.
Quel taux d'échec faut-il anticiper ?
Environ 3 % par lot, principalement des numéros erronés ou inactifs (~1,5 %). Un retry automatique 2 fois absorbe la plupart des timeouts.
Combien de destinataires par lot ?
Jusqu'à 1 000 destinataires chez Wave et MTN, 500 chez Moov. Au-delà, on découpe en plusieurs lots, chacun avec son ID de réconciliation.
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'étalent ou passent par une hausse de plafond négociée.
Le retry risque-t-il de payer deux fois ?
Non, si vous utilisez une clé d'idempotence par reversement. L'opérateur reconnaît le doublon et l'ignore, ce qui rend le retry totalement sûr.
Discutons de votre projet. Nous automatisons vos payouts vendeurs multi-opérateurs avec retry, idempotence et réconciliation 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.
