Le verdict en trois phrases
Intégrer MTN MoMo Collection API et Moov Money repose sur un même schéma : vous générez une référence unique (X-Reference-Id), lancez une requête de collecte, puis interrogez le statut (PENDING → SUCCESSFUL / FAILED) via polling ou webhook. Le piège n°1 en 2026 est le timeout : le client peut mettre 60 à 90 secondes à valider son code USSD, donc un timeout trop court fait échouer des paiements pourtant valides. Comptez 3 à 5 jours d'intégration par opérateur et visez un timeout de 90 secondes pour un taux de succès de 88 à 95 %.
Paramètres clés par opérateur
| Paramètre | MTN MoMo | Moov Money |
|---|---|---|
| Environnement test | Sandbox dédié | Sandbox partenaire |
| Identifiant transaction | X-Reference-Id (UUID) | Référence marchande |
| Statuts | PENDING / SUCCESSFUL / FAILED | PENDING / SUCCESS / FAILED |
| Confirmation | Polling + webhook | Callback + polling |
| Pays | Bénin, plusieurs marchés | Bénin, Togo, Niger |
| Délai intégration | 3 à 5 jours | 3 à 4 jours |
Estimation 2026 : les détails d'API varient selon la version et le contrat marchand.
Fiabilité : timeout, retry et taux de succès
Le taux de succès dépend directement de votre gestion du temps d'attente et des relances.
| Paramètre | Valeur recommandée | Impact si mal réglé |
|---|---|---|
| Timeout de collecte | 90 secondes | < 60 s : échecs de paiements valides |
| Intervalle de polling | 3 à 5 secondes | trop court : quota API dépassé |
| Nombre de retries | 2 à 3 | 0 : abandons sur erreur réseau |
| Idempotence (clé) | Obligatoire | double débit du client |
| Taux de succès cible | 88 à 95 % | < 85 % : perte de CA directe |
Un passage d'un timeout de 45 s à 90 s peut à lui seul faire remonter le taux de succès de 82 % à 93 % sur MTN MoMo.
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.
Mini cas pratique
Ibrahim tient une boutique en ligne à Cotonou : 600 tentatives de paiement/mois, panier moyen 18 000 FCFA. Avec un timeout à 45 s, son taux de succès plafonne à 82 %, soit 108 paiements échoués et 1 944 000 FCFA de CA perdu/mois. En portant le timeout à 90 s et en ajoutant 2 retries, il monte à 93 %, récupérant 66 paiements soit 1 188 000 FCFA/mois — un simple réglage sans nouveau produit ni nouvelle pub.
FAQ
Combien de temps pour intégrer MTN MoMo ? Comptez 3 à 5 jours avec le sandbox : génération du X-Reference-Id, appel de collecte, gestion des statuts et des webhooks. La mise en production dépend de la validation de votre compte marchand.
Quel timeout choisir ? 90 secondes est le bon compromis en 2026. En dessous de 60 s, vous faites échouer des paiements que le client valide encore via son USSD.
Faut-il du polling ou des webhooks ? Les deux : le webhook confirme vite quand il arrive, le polling est votre filet de sécurité si le callback se perd. Interrogez toutes les 3 à 5 secondes.
Comment éviter les doubles débits ? Une clé d'idempotence par tentative de paiement. Sans elle, un retry réseau peut débiter deux fois le client — la première cause de litige.
Moov Money couvre-t-il toute l'Afrique de l'Ouest ? Non, Moov est surtout fort au Bénin, Togo et Niger. Pour le Sénégal, privilégiez Wave et Orange Money ; combinez les opérateurs selon vos pays cibles.
Discutons de votre projet. Nous intégrons MTN MoMo et Moov avec timeout, retries et idempotence calibrés pour maximiser votre taux de succès. 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.
