Le verdict en trois phrases
Le sandbox n'est pas une formalite : c'est la ou vous provoquez volontairement les echecs avant que vos clients ne les subissent. Une recette serieuse dure 3 a 5 jours et couvre les 6 codes d'erreur les plus frequents : solde insuffisant, timeout, annulation, double-soumission, token expire et webhook perdu. Un go-live sans ces tests se paie toujours par des commandes payees non honorees et des litiges.
Scenarios de test et resultats attendus
Chaque provider fournit des numeros et des montants qui declenchent des comportements precis. Testez systematiquement le chemin heureux ET les echecs.
| Scenario | Comment le declencher | Resultat attendu |
|---|---|---|
| Paiement reussi | Numero de test valide | Commande confirmee via webhook |
| Solde insuffisant | Montant/numero declencheur | Refus, panier conserve |
| Timeout USSD | Ne pas saisir le code | Statut pending, puis polling |
| Annulation client | Refus volontaire | Panier libere |
| Double-paiement | Rejouer meme order_id | Une seule commande (idempotence) |
| Webhook perdu | Bloquer l'URL de notif | Recuperation par reconciliation |
Checklist go-live en 12 points
Avant de basculer les cles en production, validez chaque ligne. Un seul point manquant suffit a generer des incidents.
| # | Point de controle | Statut attendu |
|---|---|---|
| 1 | Cles production distinctes du sandbox | Verifie |
| 2 | URL de webhook en HTTPS publique | Verifie |
| 3 | Signature webhook verifiee | Verifie |
| 4 | Idempotence sur order_id | Verifie |
| 5 | Reconciliation par polling active | Verifie |
| 6 | Gestion des 6 codes d'erreur | Verifie |
| 7 | Timeout USSD gere (statut pending) | Verifie |
| 8 | Montants min/max respectes | Verifie |
| 9 | Messages d'erreur clairs pour le client | Verifie |
| 10 | Journalisation des transactions | Verifie |
| 11 | Test d'un vrai paiement de 100 FCFA | Verifie |
| 12 | Procedure de remboursement testee | Verifie |
Mini cas pratique
Aminata lance sa boutique de tissus a Dakar. Tentee de sauter la recette pour gagner du temps, elle simule finalement les echecs pendant 4 jours. Elle decouvre que 1 commande sur 20 partait en timeout USSD sans etre rattrapee, soit sur 300 commandes/mois a 25 000 FCFA, environ 15 commandes (375 000 FCFA) qui auraient ete perdues ou mal traitees chaque mois. Les 4 jours de recette lui evitent des milliers de FCFA de litiges et une reputation abimee des 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 prevoir pour la recette sandbox ?
Comptez 3 a 5 jours pour couvrir le chemin heureux et les principaux echecs. C'est un investissement minime face au cout 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 payees non honorees.
Comment simuler un echec de paiement en sandbox ?
Les providers fournissent des numeros de test ou des montants declencheurs 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 reel de faible montant (par exemple 100 FCFA) valide toute la chaine en conditions reelles, y compris le versement. C'est le point 11 de la checklist.
Discutons de votre projet. Nous menons la recette sandbox complete 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.
