Integrer l'API MTN MoMo Collections au Cameroun en 2026

Le verdict en trois phrases

L'API MTN MoMo Collections au Cameroun exige une souscription au produit Collections, une cle primaire (subscription key) et un token d'acces qui expire en 3 600 secondes. Vous initiez un encaissement avec RequestToPay, qui renvoie un statut PENDING puis SUCCESSFUL ou FAILED que vous devez interroger. Ce guide couvre la generation de l'UUID de reference, la gestion du token horaire et la reprise apres coupure reseau 3G, avec un comparatif face a Flutterwave au Ghana.

Souscription, cle et token

Le flux MoMo Collections demarre dans le portail developpeur MTN : vous souscrivez au produit Collections, ce qui genere une Ocp-Apim-Subscription-Key. Vous creez ensuite un API User et une API Key, puis echangez ces identifiants contre un token d'acces valable 3 600 secondes (une heure). Chaque RequestToPay doit porter un en-tete X-Reference-Id : un UUID v4 unique que vous generez et conservez pour interroger le statut ensuite.

Conservez impérativement l'UUID X-Reference-Id en base : c'est votre seule cle pour interroger le statut d'un encaissement reste PENDING.

Reprise apres coupure et comparatif Flutterwave

Sur reseau 3G camerounais, une requete RequestToPay peut partir sans que vous receviez la reponse. Grace a l'idempotence via l'UUID, vous pouvez rejouer sans double encaissement : si l'UUID existe deja cote MTN, la requete est ignoree. Comparons MTN MoMo et Flutterwave au Ghana, qui utilise un webhook signe plutot qu'un polling.

Au Ghana, Flutterwave envoie l'evenement charge.completed avec un secret hash dans l'en-tete verif-hash que vous comparez a votre cle secrete avant de livrer. Le modele est donc pousse (webhook) cote Ghana et tire (polling) cote Cameroun.

Mini cas pratique

Nguema gere une boutique d'accessoires telephone a Douala (Akwa). Avec des RequestToPay sans gestion de reprise, 5 % de ses 220 commandes mensuelles restaient bloquees en PENDING apres une coupure 3G, soit 11 commandes. En stockant l'UUID X-Reference-Id et en interrogeant le statut toutes les 20 secondes pendant 2 minutes, puis via un cron a 15 minutes, le taux de blocage tombe a 0,5 %, soit une commande par mois. Sur un panier moyen de 22 000 FCFA, il recupere environ 10 x 22 000 = 220 000 FCFA d'encaissements auparavant perdus chaque mois.

FAQ

Pourquoi generer un UUID pour chaque RequestToPay ? Parce que l'X-Reference-Id est a la fois votre identifiant d'idempotence et votre cle pour interroger le statut. Sans lui, impossible de savoir si un encaissement PENDING a abouti.

Que se passe-t-il quand le token expire en 3 600 secondes ? Vous devez le regenerer via l'API User + API Key. Mettez en cache le token avec sa date d'expiration et rafraichissez-le avant la limite d'une heure.

Comment gerer une coupure 3G pendant l'encaissement ? Rejouez la requete avec le meme UUID : MTN ignore un doublon, ce qui evite un double debit. Puis interrogez le statut jusqu'a SUCCESSFUL ou FAILED.

Quelle difference avec Flutterwave au Ghana ? Flutterwave pousse un webhook charge.completed signe (secret hash), alors que MTN impose d'interroger activement le statut. L'un est pousse, l'autre tire.

Combien coute l'integration MoMo Collections ? Ordre de grandeur 2026 : 350 000 a 600 000 FCFA selon la complexite, hors frais MTN par transaction definis dans votre convention marchand.

Discutons de votre projet. Nous integrons MTN MoMo, Wave et Flutterwave avec gestion des UUID, des tokens et de la reprise reseau. WhatsApp +221 77 596 93 33.