Le verdict en trois phrases
Passer du sandbox au live sans casse tient à une discipline de vérification : clés séparées, webhooks re-testés en production, KYC marchand validé et un vrai paiement de 1 FCFA effectué avant l'ouverture. La plupart des incidents de lancement viennent de clés de test laissées en production ou de webhooks pointant encore sur l'URL de staging. Cette checklist en 12 points transforme une mise en production risquée en une opération d'une demi-journée.
Les 12 points de contrôle avant lancement
Chaque point ci-dessous doit être coché avant d'ouvrir les paiements aux vrais clients.
| # | Point de contrôle | Statut attendu |
|---|---|---|
| 1 | Compte marchand activé (mode live) | validé |
| 2 | KYC complet (RCCM, pièce dirigeant) | validé |
| 3 | Clés API live séparées des clés test | rotation faite |
| 4 | URL webhook pointée sur la prod | testée |
| 5 | Signature HMAC vérifiée en live | active |
| 6 | Paiement réel de 1 FCFA testé | réussi |
| 7 | Remboursement de test effectué | réussi |
| 8 | Idempotence en base validée | active |
| 9 | Plafonds live connus (ex. 3M FCFA/jour) | configurés |
| 10 | Page de retour succès/échec | testée |
| 11 | Journalisation des transactions | active |
| 12 | Reconciliation quotidienne planifiée | active |
Un seul point non coché — typiquement le n°3 ou le n°4 — suffit à faire échouer silencieusement des paiements réels.
Délais et plafonds : ce que le live change
Le passage en production modifie les délais d'activation et impose des plafonds absents du sandbox. Voici les ordres de grandeur 2026.
| Élément | Sandbox | Live |
|---|---|---|
| Activation du compte | immédiate | 2-10 jours ouvrés |
| KYC requis | non | RCCM + pièce d'identité |
| Plafond journalier | illimité | ~3 000 000 FCFA/jour (par défaut) |
| Plafond par transaction | illimité | 500 000-2 000 000 FCFA |
| Rotation des clés | libre | recommandée à chaque déploiement |
| Montant de test | fictif | réel (1 FCFA) |
Les plafonds par défaut se relèvent sur demande auprès de l'agrégateur, souvent après quelques semaines d'historique de transactions saines.
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, gérant d'une épicerie en ligne à Dakar, lance son paiement Wave un vendredi soir. Il a coché 11 points sur 12 mais oublié le n°4 : son webhook pointe encore sur staging. Résultat, 17 commandes payées le week-end restent en statut « en attente », soit 255 000 FCFA de ventes non honorées à un panier moyen de 15 000 FCFA. Une reconciliation lundi matin rattrape tout, mais 6 clients avaient déjà relancé au support. La checklist aurait évité l'incident en cinq minutes.
FAQ
Combien de temps prend l'activation d'un compte marchand ? De 2 à 10 jours ouvrés selon l'agrégateur et la complétude de votre dossier KYC (RCCM, pièce d'identité du dirigeant).
Pourquoi tester un vrai paiement de 1 FCFA ? Parce que le sandbox ne reproduit jamais parfaitement le live : un paiement réel minimal valide les clés, le webhook et le versement de bout en bout.
Faut-il changer les clés API à chaque déploiement ? Pas obligatoirement, mais une rotation régulière limite l'impact d'une fuite. Ne laissez jamais une clé de test active en production.
Quels plafonds live prévoir ? Souvent 3 000 000 FCFA par jour et 500 000 à 2 000 000 FCFA par transaction au départ, relevables sur demande après quelques semaines d'historique.
Que faire si des paiements restent en attente après le lancement ? Lancez une reconciliation immédiate contre l'API de statut, corrigez l'URL webhook, puis rejouez les notifications manquantes pour honorer les commandes.
Discutons de votre projet. Nous pilotons votre passage en production avec cette checklist 12 points, sans paiement perdu. 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.
