Wave a englouti 70% du mobile money au Sénégal en 4 ans grâce à un seul argument : 1% de frais marchand, contre 3 à 5% chez la concurrence. Pour un site e-commerce dakarois qui traite 5 millions FCFA par mois, l'écart représente 200 000 FCFA d'économies mensuelles. Voici comment brancher l'API Wave Business sur une stack moderne.
TL;DR
- Frais marchand Wave Business : 1% par transaction, plafonné à 5 000 FCFA
- Authentification : Bearer token + signature HMAC-SHA256 sur les webhooks
- Sandbox disponible avec numéros de test +221 700 000 000
- Délai d'activation KYB merchant : 5 à 10 jours ouvrés
- Settlement quotidien automatique vers compte bancaire ou wallet
H2 — Pourquoi Wave domine le mobile money sénégalais
Wave est passé de 0 à plus de 7 millions d'utilisateurs actifs au Sénégal entre 2018 et 2025. Le modèle économique repose sur le cash-in et cash-out gratuits pour le particulier, et des frais marchand à 1% (vs 3% Orange Money Merchant historique). En février 2026, Wave revendique 65% des paiements P2P et plus de 40 000 marchands actifs.
H3 — Trois cas d'usage typiques pour un marchand
- Encaissement e-commerce : un client paie sur votre site avec son numéro Wave.
- Cash-out vers compte courant : Wave reverse vos ventes en FCFA quotidiennement.
- Bulk Pay (paiements de masse) : payer 50 livreurs ou apporteurs en un appel API.
H2 — Activer un compte Wave Business
Avant l'API, il faut un compte marchand. Le processus passe par l'app Wave Business (Android/iOS) ou le portail business.wave.com.
H3 — Documents requis (KYB Sénégal)
| Document | Format | Obligatoire |
|---|---|---|
| NINEA | PDF ou photo | Oui |
| Registre du commerce (RCCM) | Oui | |
| Pièce d'identité gérant | CNI ou passeport | Oui |
| Justificatif d'adresse | Facture < 3 mois | Oui |
| Statuts SARL/SUARL | Oui pour personnes morales |
Le délai d'activation tourne autour de 5 à 10 jours ouvrés. Une fois validé, vous récupérez un API Key (secret_xxx) dans le dashboard merchant.
H2 — Endpoints clés de l'API Wave Business
L'API expose une dizaine d'endpoints sur https://api.wave.com/v1. Les plus utilisés au quotidien :
| Endpoint | Méthode | Usage |
|---|---|---|
| /checkout/sessions | POST | Créer une session de paiement |
| /checkout/sessions/{id} | GET | Vérifier l'état d'un paiement |
| /payouts | POST | Cash-out vers wallet ou banque |
| /balance | GET | Solde marchand en temps réel |
| /transactions | GET | Historique paginé |
Toutes les requêtes utilisent Bearer Authorization avec votre clé secrète et renvoient du JSON. Les montants sont en FCFA entiers (pas de centimes).
H2 — Intégration concrète dans Next.js 14
Côté backend, créez une route API qui crée la session, puis redirigez le client vers le lien de paiement Wave (wave_launch_url). À la fin, Wave appelle votre webhook pour confirmer.
- Étape 1 : route POST /api/wave/checkout — crée la session avec amount, currency XOF, success_url, error_url.
- Étape 2 : redirection client vers wave_launch_url renvoyé par Wave.
- Étape 3 : Wave POST sur /api/wave/webhook avec status checkout.session.completed.
- Étape 4 : votre serveur vérifie la signature HMAC-SHA256 et marque la commande payée.
- Étape 5 : confirmation visuelle au client + email Brevo automatique.
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.
H3 — Sécurité webhook : la signature HMAC
Wave signe chaque webhook avec un secret distinct (whsec_xxx). Vérifiez impérativement la signature avant d'écrire en base — sinon un attaquant peut faker une transaction.
H2 — Sandbox et tests
Wave fournit un environnement sandbox sur api.wave.com/v1/sandbox. Numéros de test : +221 700 000 000 (succès), +221 700 000 001 (échec), +221 700 000 002 (timeout). Aucun argent réel ne circule.
FAQ
Q : Quels sont les frais réels Wave Business en 2026 ?
R : 1% par transaction encaissée, plafonné à 5 000 FCFA. Le cash-out vers banque coûte 250 FCFA fixes. Le Bulk Pay reste à 1%. Aucun abonnement mensuel.
Q : Wave Business fonctionne-t-il hors Sénégal ?
R : Oui, en Côte d'Ivoire, Mali, Ouganda et Burkina Faso (2026). Chaque pays a une entité légale distincte — l'API key sénégalaise ne marche pas en CI.
Q : Combien de temps pour intégrer Wave sur un site existant ?
R : Pour un développeur Next.js expérimenté, comptez 2 à 4 jours : 1 jour route checkout, 1 jour webhook + signature, 1 à 2 jours tests sandbox et production.
Q : Wave supporte-t-il les paiements récurrents (abonnements) ?
R : Pas nativement en 2026. Pour un SaaS avec abonnement mensuel, il faut soit relancer manuellement le client chaque mois, soit utiliser le Bulk Pay inversé via mandat.
Q : Que se passe-t-il si le webhook échoue ?
R : Wave retente 5 fois avec backoff exponentiel sur 24h. Implémentez l'idempotence : stockez l'event_id pour ne pas traiter deux fois la même transaction.
Conclusion
Wave Business n'est pas seulement l'option la moins chère au Sénégal — c'est celle que vos clients connaissent et utilisent déjà. L'intégration technique reste accessible à toute équipe avec un développeur fullstack. Kolonell intègre Wave sur les sites e-commerce de ses clients en standard. Demandez un devis gratuit ou écrivez sur 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.