Le verdict en trois phrases
Un environnement de test (sandbox) vous laisse rejouer tous les scénarios de paiement sans mouvement d'argent réel, avec des clés de test et des numéros fictifs. À ne jamais faire : passer en production sans avoir validé au minimum les cinq cas succès, échec, timeout, doublon et refund. Le coût d'un bug de paiement en production, c'est un panier abandonné et un client perdu, alors qu'une recette de 2 heures l'évité.
Sandbox Wave et Orange Money
Côté francophone, vous configurez des clés de test distinctes des clés de production, puis vous appelez l'API avec des numéros fictifs qui déclenchent des réponses contrôlées. Le simulateur permet de forcer un échec ou un timeout sans attendre le hasard.
| Scénario | Sandbox Wave / OM (2026) | Paystack / Flutterwave test mode (2026) |
|---|---|---|
| Clés | clés test dédiées | test secret/public keys |
| Succès | numéro fictif OK | carte test 408... |
| PIN / OTP | code test fourni | PIN 0000, OTP 123456 |
| Échec force | numéro échec dédié | carte declined dédiée |
| Timeout | numéro timeout | montant / carte spécifique |
| Refund | simulable | simulable en test |
Les identifiants exacts (numéros, cartes) sont fournis dans la documentation de chaque opérateur et évoluent ; vérifiez-les avant chaque recette 2026.
Checklist de recette avant go-live
Une recette structurée couvre tous les chemins, y compris les chemins malheureux souvent oubliés : que voit le client quand ça échoue ? Le webhook est-il idempotent face à un doublon ?
| Test | Attendu | Bloquant go-live ? |
|---|---|---|
| Paiement succès | commande confirmée + webhook reçu | oui |
| Paiement échec | message clair, commande non validée | oui |
| Timeout opérateur | statut "en attente", pas de double débit | oui |
| Webhook doublon | traité une seule fois (idempotent) | oui |
| Refund partiel | remboursement correct, statut mis à jour | oui |
| Mauvais montant | rejet propre | non |
| Réseau 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 à Dakar. En sandbox, il rejoue 12 scénarios en 90 minutes. Il découvre deux bugs : sur timeout, son site validait la commande à tort ; et un webhook envoyé deux fois créait deux commandes. Il corrige, ajoute une clé d'idempotence sur la référence de transaction, et re-testé. Le jour du lancement, sur 80 commandes réelles, zéro double débit et zéro commande fantôme. Coût évité estimé : plusieurs paniers à 15 000 FCFA en moyenne, plus la réputation.
FAQ
Le sandbox coûte-t-il de l'argent ? Non, aucun mouvement d'argent réel 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 échec ou un timeout ? En utilisant les numéros fictifs dédiés (Wave/OM) où les cartes test declined (Paystack/Flutterwave). Le simulateur déclenche la réponse voulue à la demande.
Qu'est-ce que l'idempotence d'un webhook ? C'est la garantie qu'un même événement reçu deux fois ne crée qu'une seule commande. On l'obtient en stockant la référence de transaction et en ignorant les doublons.
Quels cartes et OTP de test utiliser côté anglophone ? Historiquement carte 408..., PIN 0000, OTP 123456 en test Paystack, mais vérifiez la doc à 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 à "rembourse" et que le client est notifié.
Discutons de votre projet. Nous livrons vos paiements avec une recette sandbox complète 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.
