Pourquoi Wave s'est imposé à Dakar
En 2026, Wave traite plus de paiements mobiles au Sénégal que Orange Money dans plusieurs segments PME. Frais à 1% (contre 5% ailleurs), interface ultra-simple, adoption massive : si votre site e-commerce n'accepte pas Wave, vous laissez 30 à 40% de votre CA sur la table.
Bonne nouvelle : Wave a ouvert une vraie Business API en 2024, et elle est propre.
Ce que Wave Business API permet
- Checkout hosted : redirection vers une page Wave sécurisée
- Payouts : envoyer de l'argent à vos fournisseurs ou apporteurs
- Webhooks : notifications en temps réel des paiements réussis
- Multi-pays : Sénégal, Côte d'Ivoire, Mali, Burkina, Ouganda
Mise en route : les 4 étapes
1. Obtenir un compte Wave Business
Créez un compte sur business.wave.com, vérifiez votre identité avec CNI + registre de commerce (NINEA). Compter 48-72h de validation. Sans NINEA, pas d'API — préparez-le avant.
2. Récupérer vos clés API
Dans le dashboard Wave Business → *Developers* :
- API Key (à garder dans votre .env)
- Webhook Secret (pour vérifier les signatures)
- Business ID
Ne jamais committer ces clés sur GitHub. Je l'ai vu trois fois cette année.
3. Créer une session de checkout
L'endpoint principal est POST https://api.wave.com/v1/checkout/sessions. Vous envoyez :
amount(en FCFA, entier, sans virgule)currency: "XOF"success_urleterror_urlclient_reference(votre ID de commande interne)
Wave vous renvoie une wave_launch_url. Vous redirigez l'utilisateur dessus. Il paie. Wave redirige sur votre success_url.
4. Gérer le webhook
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.
C'est là que 80% des intégrations ratent. Wave envoie un POST sur votre endpoint avec un header X-Wave-Signature. Vous devez :
- Vérifier la signature HMAC-SHA256 avec votre webhook secret
- Retourner un 200 en moins de 10 secondes
- Rendre l'endpoint idempotent — Wave peut envoyer le même événement 3 fois
Les pièges que personne ne documente
Le problème des montants
Wave attend des entiers en FCFA. Envoyer 15 000,50 ou "15000" (string) = erreur 400. Toujours caster en parseInt.
La sandbox qui ment
La sandbox Wave accepte des webhooks en HTTP pour tester. En production, HTTPS obligatoire (voir mon article SSL). Beaucoup découvrent ça le jour du lancement.
Les timeouts mobiles
Les utilisateurs Wave finalisent le paiement dans l'app Wave, pas sur votre site. Si votre success_url charge en 8 secondes sur 3G Tigo, le client va croire que ça a planté. Pré-chargez une page de confirmation légère.
Le rapprochement comptable
Wave ne fournit pas de TVA automatique. Vous devez rapprocher manuellement les paiements avec votre comptable via l'export CSV mensuel. Automatisez ça dans votre admin.
Stack recommandée pour un setup propre
- Next.js 14 + App Router : API route
/api/wave/webhook - Prisma + PostgreSQL : table
PaymentavecwaveSessionIdunique - Zod : valider chaque payload webhook
- Sentry : alerte immédiate si un webhook échoue
- Retry queue : si votre DB tombe pendant un webhook
On intègre Wave pour vous en 5 jours
Chez Kolonell, on a branché Wave Business API sur plus de 15 sites e-commerce dakarois, dont des boutiques de mode et un restaurant livraison qui fait 800 commandes/mois via Wave. Intégration propre, webhooks idempotents, tests automatisés, dashboard de rapprochement.
Demandez un devis gratuit ou écrivez-moi sur WhatsApp +221 77 596 93 33. On vous livre un checkout Wave opérationnel la semaine prochaine.
Mohamed Ba
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.