API paiement mobile money au Burkina Faso: guide d'intégration 2026

Le verdict en trois phrases

Au Burkina Faso, Orange Money et Moov Money exposent deux API Collect distinctes : pas d'API unique, donc deux implémentations derrière une abstraction commune. La bonne méthode est de valider en sandbox avant le go-live, avec des clés d'API séparées par environnement, puis de basculer sur les clés de production une fois les callbacks confirmés. Cadrez dès le départ le plafond (ordre de grandeur 1 000 000 FCFA par transaction), la subscription key et le callback qui porte la référence unique.

Sandbox puis go-live : la séquence qui évite les incidents en production

L'erreur classique est de coder directement contre la production. Le passage par un environnement sandbox, avec des clés d'abonnement dédiées, permet de tester les callbacks, les timeouts et les cas d'échec sans mouvementer d'argent réel.

Ne demandez les clés de production qu'une fois les callbacks sandbox stables. Cela évite d'exposer des identifiants de production pendant les phases d'essai.

Endpoints, clés et plafonds au Burkina Faso en 2026

Voici les paramètres à cadrer pour Orange Money Collect et Moov Money côté burkinabè. Les plafonds sont des ordres de grandeur 2026, à confirmer avec le contrat marchand.

Comparaison avec MTN MoMo (Kampala, Ouganda)

En Ouganda, MTN MoMo expose la Collections API avec une subscription key, un environnement sandbox et un callback portant l'en-tête X-Reference-Id. La logique est proche mais les plafonds sont exprimés en shillings.

Mini cas pratique

Boukary, gérant d'une boutique de pièces détachées à Ouagadougou, encaisse 350 commandes par mois pour un panier moyen de 45 000 FCFA, soit 15 750 000 FCFA. Certaines commandes B2B dépassaient le plafond de 1 000 000 FCFA par transaction et échouaient silencieusement. En découpant automatiquement ces paiements en plusieurs transactions sous plafond et en réconciliant via status(), il élimine 100 % de ces échecs, sécurisant environ 1 200 000 FCFA de ventes B2B jusque-là perdues chaque mois.

FAQ

Y a-t-il une API unique pour le mobile money au Burkina ? Non, Orange Money et Moov Money exposent des API Collect distinctes. Le bon pattern est une abstraction commune côté serveur, avec une implémentation par opérateur derrière la même interface.

Pourquoi passer par un sandbox avant la production ? Pour tester les callbacks, timeouts et cas d'échec sans mouvementer d'argent réel, et pour n'exposer les clés de production qu'une fois le flux stable. Cela évite les incidents coûteux en production.

Quel est le plafond par transaction en 2026 ? Ordre de grandeur 1 000 000 FCFA côté Orange et Moov, à confirmer avec votre contrat marchand. Pour les paiements B2B élevés, découpez automatiquement en plusieurs transactions sous plafond.

À quoi sert la subscription key ? Elle authentifie vos appels à l'API Collect et distingue vos environnements test et production. Ne mélangez jamais une clé sandbox avec des appels de production.

Comment gérer un callback manquant ? Prévoyez une réconciliation via un appel status() sur la référence unique. Si le callback n'arrive pas, cette vérification de secours confirme ou infirme le paiement.

Discutons de votre projet. Nous intégrons Orange Money Collect et Moov au Burkina Faso, du sandbox au go-live, avec gestion des plafonds et réconciliation. WhatsApp +221 77 596 93 33.