Le verdict en trois phrases
Un checkout de paiement se teste entièrement en sandbox avant toute mise en production : clés de test, numéros MSISDN factices, cartes de test, simulation des cas d'échec. En 2026, l'obtention des clés API de production prend 1 à 5 jours ouvrés selon le provider et le niveau de KYC exigé — anticipez ce délai dans votre planning. La checklist go-live (signature, idempotence, retry, échecs, réconciliation) est aussi importante que le happy path.
État des sandboxes mobile money 2026
| Provider | Sandbox dispo | Clés de test | Numéros/cartes de test | Délai clés prod |
|---|---|---|---|---|
| CinetPay | Oui | Clés API dédiées | Numéros de test fournis | ~2-5 jours |
| Hub2 | Oui | Environnement test | Cartes/numéros simules | ~2-4 jours |
| Paystack | Oui, complet | sk_test_... / pk_test_... | Cartes de test documentées | ~1-3 jours |
| Flutterwave | Oui | Clés test | Cartes + OTP de test | ~1-3 jours |
| MTN MoMo | Sandbox développeur | Subscription key + API user | MSISDN de test | ~2-5 jours |
| M-Pesa (Daraja) | Sandbox complet | Consumer key/secret test | Shortcodes + MSISDN test | ~2-5 jours |
| Wave | Environnement test | Clés test | Comptes de test | ~2-4 jours |
Règle : demandez vos accès sandbox ET lancez la procédure KYC de production le même jour. Le sandbox vous débloque immédiatement ; le KYC (documents, RCCM, pièce d'identité du gérant) est le vrai goulot d'étranglement.
Ce qu'il faut absolument simuler
Le happy path (paiement réussi) est le cas le plus simple. Un checkout robuste testé surtout les cas degrades :
| Scenario à tester | Comment le déclencher | Ce que le code doit faire |
|---|---|---|
| Paiement réussi | Numéro/carte de succès | Livrer après vérification statut |
| Paiement échoué | Numéro/carte d'échec | Afficher erreur claire, ne rien livrer |
| Paiement en attente | Montant/numéro pending | Attendre webhook + polling |
| Timeout USSD/OTP | Ne pas confirmer l'OTP | Expirer proprement, permettre retry |
| Webhook dupliqué | Rejouer l'événement | Idempotence : un seul effet |
| Mauvaise signature | Modifier le secret | Rejeter en 401 |
| Montant incohérent | Alterer le payload | Refuser, alerter |
Checklist go-live
Avant de passer en production, cochez chaque ligne. C'est ce qui sépare une intégration jouet d'une intégration prête à encaisser.
| Item go-live | Vérifié ? |
|---|---|
| Clés de prod injectées via variables d'environnement (jamais en dur) | ☐ |
| Vérification de signature active sur l'endpoint webhook | ☐ |
| Contrainte d'unicité sur la référence de transaction | ☐ |
| Reverification du statut via API avant livraison | ☐ |
Polling de secours pour les pending | ☐ |
| Messages d'erreur clairs côté client (FR/EN) | ☐ |
| Journalisation des transactions (montant, référence, statut) | ☐ |
| URL de webhook configurée côté provider | ☐ |
| Test d'un vrai paiement de faible montant en prod | ☐ |
| Procédure de remboursement testée | ☐ |
Mini cas pratique
Fatou, développeuse freelance à Dakar, intègre CinetPay pour un client restaurateur. Elle demande le sandbox et lance le KYC le lundi. Sandbox actif en 2 h : elle code et testé le happy path, les échecs et la déduplication en 2 jours. Les clés de prod arrivent le vendredi (4 jours de KYC).
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.
Grâce à la checklist, la bascule en production ne prend que 30 minutes : injection des clés, un paiement réel de 500 FCFA pour valider, remboursement testé. Zéro surprise. Sans sandbox, elle aurait testé sur des vrais paiements clients — et debugue en direct sur des commandes réelles.
FAQ
Puis-je tester sans créer de compte marchand ?
Oui pour la plupart des sandboxes : Paystack et Flutterwave donnent des clés de test immédiatement après inscription. Mais les clés de PRODUCTION exigent toujours un compte marchand validé avec KYC complet.
Combien de temps pour obtenir les clés de production ?
Ordre de grandeur 2026 : 1 à 5 jours ouvrés selon le provider et la complétude de votre dossier KYC (RCCM, pièce d'identité, RIB/compte de règlement). Lancez cette démarche dès le premier jour du projet.
Quels numéros utiliser pour simuler un paiement mobile money ?
Chaque provider publie ses MSISDN ou cartes de test dans sa doc : numéros de succès, d'échec, de pending. Ne testez jamais avec un vrai numéro en sandbox, cela ne fonctionne pas et fausse vos essais.
Faut-il tester en production avant le lancement ?
Oui, un ultime test avec un vrai paiement de faible montant (par exemple 500 FCFA) puis remboursement. Le sandbox ne reproduit jamais 100 % du comportement réel des opérateurs.
Comment gérer les secrets et clés API ?
Jamais en dur dans le code ni dans le dépôt Git. Utilisez des variables d'environnement, distinctes entre test et prod, et faites tourner les secrets si l'un fuite.
Discutons de votre projet. Nous intégrons et testons votre checkout mobile money en sandbox puis en production, checklist go-live incluse. 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.
