Le verdict en trois phrases
L'API MTN MoMo Collections est simple a brancher mais impitoyable sur les details : un callback mal gere ou un statut non verifie, et vous accumulez des commandes fantomes payees mais non confirmees. La difference entre un checkout fiable et 10 % de commandes bloquees tient a deux choses : le polling de statut et l'idempotence. Ce guide couvre le passage du sandbox gratuit a la production a Douala, avec les frais et delais reels 2026.
Les briques de l'API Collections
Le flux MTN MoMo Collections repose sur quelques elements cles :
- Ocp-Apim-Subscription-Key : votre cle d'abonnement au produit Collections.
- Endpoint requesttopay : declenche la demande de paiement vers le client.
- Callback URL : notifie votre serveur du resultat.
- X-Reference-Id : identifiant unique de transaction, cle de l'idempotence.
- Statuts : PENDING, SUCCESSFUL, FAILED.
La regle d'or : ne jamais faire confiance au seul callback. Le reseau peut le perdre. Il faut toujours un polling GET sur le statut de la transaction en complement.
Sandbox vs production (ordre de grandeur 2026)
| Element | Sandbox | Production Douala |
|---|---|---|
| Cout d'acces | gratuit | frais collecte ~1,5 a 2 % |
| KYC marchand | non requis | obligatoire |
| Callback URL | localhost / ngrok | HTTPS public obligatoire |
| Timeout par defaut | 30 s | 30 s |
| Delai settlement | simule | J+1 |
| Montants | fictifs | reels, TVA 19,25 % |
Valeurs estimatives 2026 a confirmer aupres de MTN Cameroun. Le sandbox reproduit fidelement les statuts, ce qui permet de tout tester avant la moindre transaction reelle.
Gestion des statuts et fiabilite
| Scenario | Statut retourne | Action recommandee |
|---|---|---|
| Paiement confirme | SUCCESSFUL | valider la commande |
| Client n'a pas encore approuve | PENDING | continuer le polling |
| Client refuse ou annule | FAILED | liberer le panier |
| Timeout operateur | PENDING puis GET | polling 3 tentatives |
| Callback perdu | inconnu | reconciliation par cron |
| Double requete | idempotent via X-Reference-Id | ne pas debiter 2 fois |
L'idempotence via X-Reference-Id garantit qu'un client qui clique deux fois n'est pas debite deux fois. Le cron de reconciliation 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 pieces auto en ligne a 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 paye, soit 15 commandes/mois = 525 000 FCFA de CA bloque, dont une partie perdue en remboursements de clients agaces. Avec polling + reconciliation par cron : les commandes fantomes tombent a < 1 %, il recupere ~14 commandes/mois soit ~490 000 FCFA auparavant en souffrance. Cout des frais collecte a 1,75 % : ~91 875 FCFA/mois, largement absorbe.
FAQ
Le callback suffit-il pour confirmer un paiement ?
Non. Le callback peut se perdre sur reseau instable. Il faut toujours un GET de statut en complement et un cron de reconciliation pour les transactions restees PENDING.
A quoi sert le X-Reference-Id ?
C'est l'identifiant unique de la transaction. Il garantit l'idempotence : rejouer la meme requete ne cree pas un second debit, essentiel quand le client clique deux fois.
Combien coute l'acces a l'API MTN MoMo ?
Le sandbox est gratuit. En production, comptez ~1,5 a 2 % de frais collecte en 2026, plus le respect du KYC marchand et une callback URL HTTPS publique.
Comment gerer le timeout de 30 secondes ?
Apres le timeout, ne concluez pas a un echec : passez en polling (3 tentatives espacees) car le client peut encore approuver sur son telephone. Seul un statut FAILED clot definitivement.
Faut-il gerer la TVA a 19,25 % dans le checkout ?
Oui, au Cameroun la TVA de 19,25 % doit apparaitre sur la facture. Integrez le calcul avant l'appel requesttopay pour que le montant debite corresponde a la facture.
Discutons de votre projet. Nous integrons l'API MTN MoMo Collections a votre boutique a Douala, du sandbox a la production, avec polling et reconciliation 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.
