Le verdict en trois phrases
Le sandbox n'est pas une formalité : c'est là où vous provoquez volontairement les échecs avant que vos clients ne les subissent. Une recette sérieuse dure 3 à 5 jours et couvre les 6 codes d'erreur les plus fréquents : solde insuffisant, timeout, annulation, double-soumission, token expire et webhook perdu. Un go-live sans ces tests se paie toujours par des commandes payées non honorées et des litiges.
Scénarios de test et résultats attendus
Chaque provider fournit des numéros et des montants qui déclenchent des comportements précis. Testez systématiquement le chemin heureux ET les échecs.
| Scénario | Comment le déclencher | Résultat attendu |
|---|---|---|
| Paiement réussi | Numéro de test validé | Commande confirmée via webhook |
| Solde insuffisant | Montant/numéro déclencheur | Refus, panier conservé |
| Timeout USSD | Ne pas saisir le code | Statut pending, puis polling |
| Annulation client | Refus volontaire | Panier libéré |
| Double-paiement | Rejouer même order_id | Une seule commande (idempotence) |
| Webhook perdu | Bloquer l'URL de notif | Récupération par réconciliation |
Checklist go-live en 12 points
Avant de basculer les clés en production, validez chaque ligne. Un seul point manquant suffit à générer des incidents.
| # | Point de contrôle | Statut attendu |
|---|---|---|
| 1 | Clés production distinctes du sandbox | Vérifié |
| 2 | URL de webhook en HTTPS publique | Vérifié |
| 3 | Signature webhook vérifiée | Vérifié |
| 4 | Idempotence sur order_id | Vérifié |
| 5 | Réconciliation par polling active | Vérifié |
| 6 | Gestion des 6 codes d'erreur | Vérifié |
| 7 | Timeout USSD géré (statut pending) | Vérifié |
| 8 | Montants min/max respectés | Vérifié |
| 9 | Messages d'erreur clairs pour le client | Vérifié |
| 10 | Journalisation des transactions | Vérifié |
| 11 | Test d'un vrai paiement de 100 FCFA | Vérifié |
| 12 | Procédure de remboursement testée | Vérifié |
Mini cas pratique
Aminata lance sa boutique de tissus à Dakar. Tentée de sauter la recette pour gagner du temps, elle simule finalement les échecs pendant 4 jours. Elle découvre que 1 commande sur 20 partait en timeout USSD sans être rattrapee, soit sur 300 commandes/mois à 25 000 FCFA, environ 15 commandes (375 000 FCFA) qui auraient été perdues ou mal traitées chaque mois. Les 4 jours de recette lui évitent des milliers de FCFA de litiges et une réputation abîmée dès le lancement.
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.
FAQ
Combien de temps prévoir pour la recette sandbox ?
Comptez 3 à 5 jours pour couvrir le chemin heureux et les principaux échecs. C'est un investissement minime face au coût des incidents en production.
Quels sont les tests que l'on oublie le plus souvent ?
Le timeout USSD, le double-paiement et le webhook perdu. Ce sont justement ceux qui causent le plus de commandes payées non honorées.
Comment simuler un échec de paiement en sandbox ?
Les providers fournissent des numéros de test ou des montants déclencheurs qui forcent un refus, un solde insuffisant ou un timeout. Utilisez-les pour valider vos messages d'erreur.
Dois-je vraiment tester un vrai paiement avant le lancement ?
Oui, un paiement réel de faible montant (par exemple 100 FCFA) valide toute la chaîne en conditions réelles, y compris le versement. C'est le point 11 de la checklist.
Discutons de votre projet. Nous menons la recette sandbox complète et le go-live de vos paiements sans mauvaise surprise. 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.
