Le verdict en trois phrases
Un environnement de test (sandbox) vous laisse rejouer tous les scenarios de paiement sans mouvement d'argent reel, avec des cles de test et des numeros fictifs. A ne jamais faire : passer en production sans avoir valide au minimum les cinq cas succes, echec, timeout, doublon et refund. Le cout d'un bug de paiement en production, c'est un panier abandonne et un client perdu, alors qu'une recette de 2 heures l'evite.
Sandbox Wave et Orange Money
Cote francophone, vous configurez des cles de test distinctes des cles de production, puis vous appelez l'API avec des numeros fictifs qui declenchent des reponses controlees. Le simulateur permet de forcer un echec ou un timeout sans attendre le hasard.
| Scenario | Sandbox Wave / OM (2026) | Paystack / Flutterwave test mode (2026) |
|---|---|---|
| Cles | cles test dediees | test secret/public keys |
| Succes | numero fictif OK | carte test 408... |
| PIN / OTP | code test fourni | PIN 0000, OTP 123456 |
| Echec force | numero echec dedie | carte declined dediee |
| Timeout | numero timeout | montant / carte specifique |
| Refund | simulable | simulable en test |
Les identifiants exacts (numeros, cartes) sont fournis dans la documentation de chaque operateur et evoluent ; verifiez-les avant chaque recette 2026.
Checklist de recette avant go-live
Une recette structuree couvre tous les chemins, y compris les chemins malheureux souvent oublies : que voit le client quand ca echoue ? Le webhook est-il idempotent face a un doublon ?
| Test | Attendu | Bloquant go-live ? |
|---|---|---|
| Paiement succes | commande confirmee + webhook recu | oui |
| Paiement echec | message clair, commande non validee | oui |
| Timeout operateur | statut "en attente", pas de double debit | oui |
| Webhook doublon | traite une seule fois (idempotent) | oui |
| Refund partiel | remboursement correct, statut mis a jour | oui |
| Mauvais montant | rejet propre | non |
| Reseau 3G lent | pas de double soumission | oui |
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
Ibrahim lance une boutique en ligne a Dakar. En sandbox, il rejoue 12 scenarios en 90 minutes. Il decouvre deux bugs : sur timeout, son site validait la commande a tort ; et un webhook envoye deux fois creait deux commandes. Il corrige, ajoute une cle d'idempotence sur la reference de transaction, et re-teste. Le jour du lancement, sur 80 commandes reelles, zero double debit et zero commande fantome. Cout evite estime : plusieurs paniers a 15 000 FCFA en moyenne, plus la reputation.
FAQ
Le sandbox coute-t-il de l'argent ? Non, aucun mouvement d'argent reel n'a lieu en test. Vous payez seulement votre temps de recette, de l'ordre de 2 heures pour une boutique simple.
Comment forcer un echec ou un timeout ? En utilisant les numeros fictifs dedies (Wave/OM) ou les cartes test declined (Paystack/Flutterwave). Le simulateur declenche la reponse voulue a la demande.
Qu'est-ce que l'idempotence d'un webhook ? C'est la garantie qu'un meme evenement recu deux fois ne cree qu'une seule commande. On l'obtient en stockant la reference de transaction et en ignorant les doublons.
Quels cartes et OTP de test utiliser cote anglophone ? Historiquement carte 408..., PIN 0000, OTP 123456 en test Paystack, mais verifiez la doc a jour 2026 car ces valeurs peuvent changer.
Peut-on tester un remboursement ? Oui, le refund est simulable en environnement de test. Validez que le statut de la commande passe bien a "rembourse" et que le client est notifie.
Discutons de votre projet. Nous livrons vos paiements avec une recette sandbox complete et des webhooks idempotents avant le go-live. 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.
