Le verdict en trois phrases
Intégrer Wave Business API au checkout d'un site web se fait via une Checkout Session qui génère une URL de redirection, suivie d'un webhook qui confirme le paiement côté serveur. Comptez 2 à 5 jours de développement pour une intégration propre avec sandbox, gestion du retour utilisateur et vérification serveur. La règle d'or : ne jamais valider une commande sur le retour navigateur seul — toujours attendre le webhook signé.
Les étapes techniques d'une intégration Wave
Le flux Wave repose sur trois appels et un événement asynchrone. Votre serveur crée la session, l'utilisateur paie sur Wave, puis Wave notifie votre webhook.
| Étape | Action | Côté | Durée dev estimée |
|---|---|---|---|
| 1. Clés API | Récupérer clé sandbox + live dans le dashboard Wave | Config | 0,5 jour |
| 2. Create Checkout Session | POST montant, devise, success_url, error_url | Serveur | 1 jour |
| 3. Redirection | Rediriger le client vers wave_launch_url | Front | 0,5 jour |
| 4. Webhook | Recevoir checkout.session.completed, vérifier la signature | Serveur | 1 jour |
| 5. Réconciliation | Marquer la commande payée, envoyer le reçu | Serveur | 0,5 jour |
| 6. Tests sandbox | Succès, échec, timeout, double clic | QA | 1 jour |
Les champs requis pour une Checkout Session sont peu nombreux : amount (en FCFA, entier), currency (XOF), success_url, error_url et un client_reference (votre ID de commande). Wave renvoie un id de session et une wave_launch_url vers laquelle rediriger.
API sur mesure ou plugin no-code : que choisir
Toutes les boutiques n'ont pas besoin de code. Voici l'arbitrage 2026 pour le marché ouest-africain.
| Critère | Intégration API sur mesure | Plugin / no-code |
|---|---|---|
| Coût initial | 150 000 – 400 000 FCFA | 0 – 80 000 FCFA |
| Délai | 2 – 5 jours | 2 – 6 heures |
| Flexibilité checkout | Totale (one-page, split) | Limitée au thème |
| Webhook personnalisé | Oui | Souvent non |
| Maintenance | À votre charge | Éditeur du plugin |
| Idéal pour | Boutique custom, volume élevé | Petite boutique WooCommerce |
Un commerçant qui traite moins de 30 commandes par mois gagne à utiliser un plugin. Au-delà, ou dès qu'un checkout one-page et une réconciliation comptable sont nécessaires, l'API sur mesure rentabilise vite les 2 à 5 jours investis.
Mini cas pratique
Awa, gérante d'une boutique de cosmétiques à Dakar, vend 45 commandes par mois à un panier moyen de 18 000 FCFA, soit 810 000 FCFA de chiffre mensuel. Son ancien checkout redirigeait vers un lien Wave manuel : elle perdait environ 8 % des paiements faute de confirmation automatique, soit 64 800 FCFA/mois. Après une intégration API à 250 000 FCFA avec webhook, les paiements perdus tombent à moins de 1 %. Économie annuelle récupérée : environ 700 000 FCFA, pour un investissement amorti en moins de 4 mois.
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 pour intégrer Wave à un site existant ?
Entre 2 et 5 jours de développement pour une intégration propre avec sandbox et webhook. Un simple bouton de redirection sans réconciliation peut se poser en une journée, mais il expose aux paiements non confirmés.
Faut-il obligatoirement un webhook ?
Oui. Le retour navigateur peut être perdu (fermeture d'onglet, coupure 3G). Seul le webhook signé garantit que votre serveur sait qu'un paiement de 18 000 FCFA est bien arrivé. C'est la première cause de commandes « fantômes ».
Existe-t-il un environnement de test Wave ?
Oui, le dashboard fournit des clés sandbox distinctes des clés live. Vous simulez succès, échec et timeout sans mouvement d'argent réel avant de basculer en production.
Quelles sont les erreurs fréquentes au lancement ?
Oublier de vérifier la signature du webhook, valider la commande sur le success_url seul, et ne pas gérer le double clic qui crée deux sessions. Ces trois erreurs représentent la majorité des incidents des premières semaines.
Quel coût prévoir pour l'intégration ?
Comptez 150 000 à 400 000 FCFA selon que le checkout est standard ou personnalisé (one-page, multi-provider, split marketplace). Le plugin no-code reste sous 80 000 FCFA mais limite les options.
Discutons de votre projet. On intègre Wave à votre checkout en 2 à 5 jours, webhook et sandbox compris. 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.
