Le verdict en trois phrases
Wave, Orange Money et MTN MoMo fournissent tous des environnements sandbox avec des numéros de test et des montants déclencheurs d'erreur (timeout, solde insuffisant, annulation client). Tester ces scénarios en e2e avant la production évite jusqu'à 90 % des incidents de paiement au lancement. Ce guide liste les scénarios à couvrir, les cartes et OTP de test Paystack/Flutterwave, et l'ordre exact de bascule des clés test vers live.
Les scénarios e2e à couvrir
Un paiement réussi ne suffit pas à valider une intégration. Vous devez simuler tous les chemins d'échec, car c'est là qu'une boutique perd des ventes ou double des livraisons. Chaque opérateur sandbox propose des déclencheurs spécifiques.
| Scénario à tester | Comment le déclencher (sandbox) |
|---|---|
| Paiement réussi | numéro/montant de test validé |
| Solde insuffisant | montant déclencheur dédié |
| Timeout / pas de réponse | numéro de test lent |
| Annulation par le client | refuser le prompt |
| Webhook en double | rejouer l'événement |
| Montant incorrect | modifier le payload |
| Token expiré | attendre l'expiration |
| 3D Secure (cartes) | OTP de test Paystack/FW |
Comptez au minimum ces 8 scénarios avant toute mise en production. Chacun doit laisser votre système dans un état cohérent : jamais de commande livrée sans paiement confirmé, jamais de double livraison.
Sandbox par opérateur et bascule des clés
Chaque plateforme a ses spécificités de test. Côté cartes, Paystack et Flutterwave fournissent des numéros de carte et des OTP de test qui simulent le 3D Secure et les échecs d'authentification.
| Plateforme | Environnement de test | Clé de test |
|---|---|---|
| Wave CI | sandbox marchand | sk_test |
| Orange Money SN | sandbox marchand | identifiants test |
| MTN MoMo CM | sandbox développeur | API User/Key test |
| Paystack NG | mode test dashboard | sk_test + carte test |
| Flutterwave GH | mode test dashboard | clé test + OTP test |
L'ordre de bascule vers la production est strict : d'abord validez les 8 scénarios en sandbox, ensuite remplacez les clés test par les clés live, puis mettez à jour les URLs de webhook en HTTPS de production, enfin executez un paiement réel minimal (100 à 500 FCFA) que vous remboursez, avant d'ouvrir aux clients. Ne basculez jamais toutes les clés d'un coup sans ce test réel final.
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
Moussa lance une boutique de livrés à Thiès et veut intégrer Wave et Orange Money. Sans phase sandbox, son premier lancement précédent avait génère 18 incidents sur 200 commandes le premier mois (9 %) : commandes livrées sans paiement, doublons, timeouts non gérés. Pour le nouveau projet, il couvre les 8 scénarios e2e en sandbox pendant 2 jours, puis fait un paiement réel de 200 FCFA remboursé. Résultat : 2 incidents sur 200 commandes (1 %) au lancement. Sur un panier moyen de 12 000 FCFA, il évite environ 16 x 12 000 = 192 000 FCFA de pertes et litiges le premier mois, pour 2 jours de tests amortis dès la première semaine.
FAQ
Peut-on tester un vrai paiement sans débiter d'argent ? Oui, en sandbox : les numéros et montants de test ne débitent aucun compte réel. Le 3D Secure des cartes se simule avec des OTP de test fournis par Paystack et Flutterwave.
Combien de scénarios faut-il couvrir au minimum ? Au moins 8 : succès, solde insuffisant, timeout, annulation, webhook double, montant incorrect, token expire et 3D Secure. Chacun doit laisser le système cohérent.
Dans quel ordre basculer les clés test vers live ? Valider la sandbox, remplacer les clés, mettre à jour les webhooks HTTPS, puis faire un paiement réel minimal remboursé. Jamais tout d'un coup sans test final.
Faut-il refaire les tests après chaque mise à jour ? Oui pour les scénarios critiques (succès, webhook double, timeout). Une régression de webhook peut bloquer silencieusement toutes les commandes.
Combien de temps prévoir pour la phase de test ? Ordre de grandeur : 1 à 3 jours pour couvrir les 8 scénarios sur deux opérateurs, un investissement rentabilisé dès le premier mois par les incidents évités.
Discutons de votre projet. Nous testons vos intégrations Wave, Orange Money, MTN MoMo, Paystack et Flutterwave en sandbox avant toute mise en production. 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.
