Le verdict en trois phrases
L'API MTN MoMo Collections repose sur un appel requestToPay puis une vérification d'état (PENDING → SUCCESSFUL/FAILED). Si vous traitez la commande sans attendre l'état final, vous double-facturez ou livrez sans encaissement. En 2026 à Douala, avec des frais de 1,5 à 2 % et une confirmation client de 30 à 120 secondes, la clé est une machine à états propre et idempotente.
Flux requestToPay et gestion d'état
Le cœur de MoMo Collections est asynchrone. Vous lancez requestToPay avec un X-Reference-Id unique (UUID), le client valide via USSD sur son téléphone, puis vous interrogez l'état. Ne considérez jamais un paiement acquis tant que l'état n'est pas SUCCESSFUL.
| État MoMo | Signification | Action boutique |
|---|---|---|
| PENDING | En attente validation USSD | Attendre / poller |
| SUCCESSFUL | Fonds confirmés | Marquer paid, livrer |
| FAILED | Rejet ou solde insuffisant | Proposer nouvel essai |
| TIMEOUT | Client n'a pas validé | Annuler la session |
| REJECTED | Client a refusé USSD | Fermer proprement |
Le X-Reference-Id sert de clé d'idempotence : si votre serveur redémarre, vous ré-interrogez le même identifiant plutôt que de relancer un paiement.
Polling vs webhook : chiffres 2026
MTN propose polling et callback. Le polling est plus simple à sécuriser mais consomme des requêtes ; le webhook est temps réel mais impose une vérification de signature. Ordres de grandeur 2026 (estimations).
| Critère | Valeur 2026 | Note |
|---|---|---|
| Frais MTN MoMo | 1,5 à 2 % | Côté marchand |
| Délai confirmation client | 30 à 120 s | Validation USSD |
| Taux d'échec USSD | 8 à 15 % | Réseau + abandon |
| Intervalle polling conseillé | 5 s | Jusqu'à 2 min max |
| Plafond transaction | ~1 000 000 FCFA | Selon profil KYC |
| Coût sandbox | Gratuit | Environnement dédié |
Un taux d'échec USSD de 8 à 15 % est normal : prévoyez un bouton « Réessayer » plutôt que de considérer chaque échec comme une perte définitive.
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 d'électronique à Akwa, Douala. Il encaisse 120 commandes/mois à 45 000 FCFA, soit 5 400 000 FCFA. Sans machine à états, 6 commandes/mois étaient facturées deux fois (client rappuie sur « payer »), générant 270 000 FCFA de remboursements et des litiges. Avec un X-Reference-Id idempotent, le double-débit disparaît : économie directe de 270 000 FCFA/mois et zéro litige de double paiement.
FAQ
Polling ou webhook pour MoMo ? Le polling toutes les 5 secondes pendant 2 minutes suffit à la plupart des boutiques et évite la complexité de signature. Le webhook devient utile au-delà de plusieurs centaines de transactions/jour.
Comment éviter le double-débit ? Utilisez un X-Reference-Id (UUID) unique par tentative comme clé d'idempotence ; ré-interrogez le même identifiant au lieu de relancer.
Quel est le taux d'échec normal ? Entre 8 et 15 % des tentatives USSD échouent (abandon, réseau, solde). Prévoyez toujours un chemin de reprise.
Combien coûtent les frais MoMo en 2026 ? Environ 1,5 à 2 % côté marchand, légèrement au-dessus de Wave mais avec une base clients MTN très large au Cameroun.
Le sandbox est-il gratuit ? Oui, l'environnement de test MTN MoMo est gratuit et simule PENDING, SUCCESSFUL et FAILED pour valider votre machine à états.
Discutons de votre projet. Nous construisons votre intégration MoMo avec machine à états idempotente et gestion des timeouts. 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.
