Le verdict en trois phrases
Wave, Orange Money et MTN MoMo fournissent tous des environnements sandbox avec des numeros de test et des montants declencheurs d'erreur (timeout, solde insuffisant, annulation client). Tester ces scenarios en e2e avant la production evite jusqu'a 90 % des incidents de paiement au lancement. Ce guide liste les scenarios a couvrir, les cartes et OTP de test Paystack/Flutterwave, et l'ordre exact de bascule des cles test vers live.
Les scenarios e2e a couvrir
Un paiement reussi ne suffit pas a valider une integration. Vous devez simuler tous les chemins d'echec, car c'est la qu'une boutique perd des ventes ou double des livraisons. Chaque operateur sandbox propose des declencheurs specifiques.
| Scenario a tester | Comment le declencher (sandbox) |
|---|---|
| Paiement reussi | numero/montant de test valide |
| Solde insuffisant | montant declencheur dedie |
| Timeout / pas de reponse | numero de test lent |
| Annulation par le client | refuser le prompt |
| Webhook en double | rejouer l'evenement |
| Montant incorrect | modifier le payload |
| Token expire | attendre l'expiration |
| 3D Secure (cartes) | OTP de test Paystack/FW |
Comptez au minimum ces 8 scenarios avant toute mise en production. Chacun doit laisser votre systeme dans un etat coherent : jamais de commande livree sans paiement confirme, jamais de double livraison.
Sandbox par operateur et bascule des cles
Chaque plateforme a ses specificites de test. Cote cartes, Paystack et Flutterwave fournissent des numeros de carte et des OTP de test qui simulent le 3D Secure et les echecs d'authentification.
| Plateforme | Environnement de test | Cle de test |
|---|---|---|
| Wave CI | sandbox marchand | sk_test |
| Orange Money SN | sandbox marchand | identifiants test |
| MTN MoMo CM | sandbox developpeur | API User/Key test |
| Paystack NG | mode test dashboard | sk_test + carte test |
| Flutterwave GH | mode test dashboard | cle test + OTP test |
L'ordre de bascule vers la production est strict : d'abord validez les 8 scenarios en sandbox, ensuite remplacez les cles test par les cles live, puis mettez a jour les URLs de webhook en HTTPS de production, enfin executez un paiement reel minimal (100 a 500 FCFA) que vous remboursez, avant d'ouvrir aux clients. Ne basculez jamais toutes les cles d'un coup sans ce test reel 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 livres a Thies et veut integrer Wave et Orange Money. Sans phase sandbox, son premier lancement precedent avait genere 18 incidents sur 200 commandes le premier mois (9 %) : commandes livrees sans paiement, doublons, timeouts non geres. Pour le nouveau projet, il couvre les 8 scenarios e2e en sandbox pendant 2 jours, puis fait un paiement reel de 200 FCFA rembourse. Resultat : 2 incidents sur 200 commandes (1 %) au lancement. Sur un panier moyen de 12 000 FCFA, il evite environ 16 x 12 000 = 192 000 FCFA de pertes et litiges le premier mois, pour 2 jours de tests amortis des la premiere semaine.
FAQ
Peut-on tester un vrai paiement sans debiter d'argent ? Oui, en sandbox : les numeros et montants de test ne debitent aucun compte reel. Le 3D Secure des cartes se simule avec des OTP de test fournis par Paystack et Flutterwave.
Combien de scenarios faut-il couvrir au minimum ? Au moins 8 : succes, solde insuffisant, timeout, annulation, webhook double, montant incorrect, token expire et 3D Secure. Chacun doit laisser le systeme coherent.
Dans quel ordre basculer les cles test vers live ? Valider la sandbox, remplacer les cles, mettre a jour les webhooks HTTPS, puis faire un paiement reel minimal rembourse. Jamais tout d'un coup sans test final.
Faut-il refaire les tests apres chaque mise a jour ? Oui pour les scenarios critiques (succes, webhook double, timeout). Une regression de webhook peut bloquer silencieusement toutes les commandes.
Combien de temps prevoir pour la phase de test ? Ordre de grandeur : 1 a 3 jours pour couvrir les 8 scenarios sur deux operateurs, un investissement rentabilise des le premier mois par les incidents evites.
Discutons de votre projet. Nous testons vos integrations 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.
