Le verdict en trois phrases
L'API MTN MoMo Collections est simple à brancher mais impitoyable sur les détails : un callback mal géré ou un statut non vérifié, et vous accumulez des commandes fantômes payées mais non confirmées. La différence entre un checkout fiable et 10 % de commandes bloquées tient à deux choses : le polling de statut et l'idempotence. Ce guide couvre le passage du sandbox gratuit à la production à Douala, avec les frais et délais réels 2026.
Les briques de l'API Collections
Le flux MTN MoMo Collections repose sur quelques éléments clés :
- Ocp-Apim-Subscription-Key : votre clé d'abonnement au produit Collections.
- Endpoint requesttopay : déclenche la demande de paiement vers le client.
- Callback URL : notifie votre serveur du résultat.
- X-Référence-Id : identifiant unique de transaction, clé de l'idempotence.
- Statuts : PENDING, SUCCESSFUL, FAILED.
La règle d'or : ne jamais faire confiance au seul callback. Le réseau peut le perdre. Il faut toujours un polling GET sur le statut de la transaction en complément.
Sandbox vs production (ordre de grandeur 2026)
| Élément | Sandbox | Production Douala |
|---|---|---|
| Coût d'accès | gratuit | frais collecte ~1,5 à 2 % |
| KYC marchand | non requis | obligatoire |
| Callback URL | localhost / ngrok | HTTPS public obligatoire |
| Timeout par défaut | 30 s | 30 s |
| Délai settlement | simulé | J+1 |
| Montants | fictifs | reels, TVA 19,25 % |
Valeurs estimatives 2026 à confirmer auprès de MTN Cameroun. Le sandbox reproduit fidèlement les statuts, ce qui permet de tout tester avant la moindre transaction réelle.
Gestion des statuts et fiabilité
| Scénario | Statut retourné | Action recommandée |
|---|---|---|
| Paiement confirmé | SUCCESSFUL | valider la commande |
| Client n'a pas encore approuvé | PENDING | continuer le polling |
| Client refuse ou annule | FAILED | libérer le panier |
| Timeout opérateur | PENDING puis GET | polling 3 tentatives |
| Callback perdu | inconnu | réconciliation par cron |
| Double requête | idempotent via X-Référence-Id | ne pas débiter 2 fois |
L'idempotence via X-Référence-Id garantit qu'un client qui clique deux fois n'est pas débité deux fois. Le cron de réconciliation rattrape les callbacks perdus en interrogeant le statut de toute transaction PENDING de plus de 5 minutes.
Mini cas pratique
Wilfried lance une boutique de pièces auto en ligne à Douala. Il traite 150 commandes/mois, panier moyen 35 000 FCFA, soit 5 250 000 FCFA de CA.
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.
Sans polling ni cron : ~10 % de commandes restent PENDING alors que le client a payé, soit 15 commandes/mois = 525 000 FCFA de CA bloque, dont une partie perdue en remboursements de clients agacés. Avec polling + réconciliation par cron : les commandes fantômes tombent à < 1 %, il récupère ~14 commandes/mois soit ~490 000 FCFA auparavant en souffrance. Coût des frais collecte à 1,75 % : ~91 875 FCFA/mois, largement absorbé.
FAQ
Le callback suffit-il pour confirmer un paiement ?
Non. Le callback peut se perdre sur réseau instable. Il faut toujours un GET de statut en complément et un cron de réconciliation pour les transactions restées PENDING.
À quoi sert le X-Reference-Id ?
C'est l'identifiant unique de la transaction. Il garantit l'idempotence : rejouer la même requête ne crée pas un second débit, essentiel quand le client clique deux fois.
Combien coûte l'accès à l'API MTN MoMo ?
Le sandbox est gratuit. En production, comptez ~1,5 à 2 % de frais collecte en 2026, plus le respect du KYC marchand et une callback URL HTTPS publique.
Comment gérer le timeout de 30 secondes ?
Après le timeout, ne concluez pas à un échec : passez en polling (3 tentatives espacées) car le client peut encore approuver sur son téléphone. Seul un statut FAILED clôt définitivement.
Faut-il gérer la TVA à 19,25 % dans le checkout ?
Oui, au Cameroun la TVA de 19,25 % doit apparaître sur la facture. Intégrez le calcul avant l'appel requesttopay pour que le montant débité corresponde à la facture.
Discutons de votre projet. Nous intégrons l'API MTN MoMo Collections à votre boutique à Douala, du sandbox à la production, avec polling et réconciliation robustes. 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.
