Le verdict en trois phrases
L'API MTN MoMo Collections encaisse directement dans votre wallet marchand à Douala avec un settlement instantané, ce qui la distingue des flux à J+2. En 2026, comptez des frais de ~1,5 à 2 %, un plafond de 1 000 000 FCFA par transaction et un flux basé sur la clé API, l'en-tête X-Reference-Id et le polling de statut. Le sandbox est gratuit et reproduit fidèlement les codes de réponse de production.
Le flux Collections pas-à-pas
Le principe : vous générez un X-Reference-Id (UUID) unique par demande de paiement, vous appelez requesttopay, puis vous interrogez le statut jusqu'à résolution (SUCCESSFUL, FAILED, PENDING). Le client confirme sur son téléphone via un prompt MoMo.
| Étape | Appel / en-tête | Rôle |
|---|---|---|
| 1. Auth | POST /token (API key + user) | Jeton d'accès |
| 2. Référence | X-Reference-Id (UUID v4) | Idempotence de la demande |
| 3. Demande | POST /requesttopay | Déclenche le prompt MoMo |
| 4. Cible | X-Target-Environment | sandbox / production |
| 5. Polling | GET /requesttopay/{id} | Statut en temps réel |
| 6. Résolution | SUCCESSFUL / FAILED | Fulfilment ou échec |
Collections API contre checkout hébergé
L'API directe donne le contrôle sur l'UX et le settlement wallet, tandis que le checkout hébergé réduit le travail d'intégration mais externalise l'expérience.
| Critère | Collections API | Checkout hébergé |
|---|---|---|
| Frais | ~1,5-2 % | ~2 % + marge agrégateur |
| Settlement | Wallet instantané | T+1 à T+2 |
| UX | Native dans l'app | Redirection externe |
| Plafond txn | 1 000 000 FCFA | Variable |
| Effort dev | Moyen (2-3 j) | Faible (1 j) |
| Contrôle | Total | Limité |
Ces chiffres sont un ordre de grandeur 2026 à confirmer selon votre contrat MTN.
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
Parfait, gérant d'une quincaillerie en ligne à Douala, encaisse 4 000 000 FCFA par mois sur ~800 transactions. En passant d'un checkout hébergé à ~2,3 % (~92 000 FCFA) vers Collections API à 1,7 % (~68 000 FCFA), il économise ~24 000 FCFA/mois. Surtout, le settlement wallet instantané lui évite les ruptures de trésorerie qui bloquaient ses réassorts.
FAQ
À quoi sert le X-Reference-Id ? C'est l'UUID qui identifie chaque demande de paiement de façon unique. Il garantit l'idempotence : rejouer la même demande ne crée pas de double encaissement.
Pourquoi faire du polling plutôt qu'attendre un callback ? MoMo Collections repose largement sur l'interrogation de statut. Vous interrogez GET /requesttopay/{id} à intervalles courts jusqu'à SUCCESSFUL, FAILED ou expiration.
Le sandbox reflète-t-il la production ? Oui, il reproduit les codes de réponse et les statuts. Testez systématiquement les cas SUCCESSFUL, FAILED et PENDING avant la mise en production.
Que se passe-t-il au-delà de 1 000 000 FCFA ? La transaction est refusée. Pour des montants supérieurs, fractionnez la commande ou proposez un autre moyen de paiement en fallback.
Discutons de votre projet. Nous intégrons MTN MoMo Collections avec polling robuste et gestion des plafonds. 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.
