Le verdict en trois phrases
Wave n'a pas de plugin WooCommerce officiel en 2026, mais son API *Aggregated Merchant* permet une intégration Checkout propre en quelques centaines de lignes. Vous créez une session de paiement côté serveur, redirigez l'acheteur vers l'URL Wave, puis confirmez la commande via un webhook signé reçu en moins de 3 secondes. Comptez un ticket dev de 250 000 à 450 000 FCFA et 3 à 5 jours de livraison pour une boutique en production.
Self-hosted vs agrégateur : que choisir
Deux chemins existent. Le self-hosted appelle directement l'API Wave depuis votre serveur WooCommerce : zéro intermédiaire, frais les plus bas, mais c'est à vous de gérer la signature du webhook et l'idempotence. L'agrégateur (PayDunya, Naboo, etc.) expose un plugin prêt à l'emploi mais ajoute une marge sur chaque transaction.
| Critère | Self-hosted (API directe) | Agrégateur |
|---|---|---|
| Frais par transaction | ~1 % cash-in | 1,5 % à 3 % |
| Ticket dev initial | 250 000 – 450 000 FCFA | 100 000 – 200 000 FCFA |
| Délai de mise en ligne | 3 – 5 jours | 1 – 2 jours |
| Settlement (versement) | J+1 | J+2 à J+3 |
| Contrôle du code | Total | Limité |
| Maintenance | À votre charge | Incluse |
Pour une boutique qui dépasse ~2 000 000 FCFA de volume mensuel, le self-hosted devient rentable : l'économie de frais rembourse le ticket dev en quelques mois.
Le flux technique en pratique
Le cœur de l'intégration tient en quatre étapes côté serveur. À la validation du panier WooCommerce, vous appelez POST /v1/checkout/sessions avec le montant, la devise (XOF) et vos URLs de retour. Wave renvoie une wave_launch_url et un id de session que vous stockez sur la commande.
| Paramètre technique | Valeur 2026 |
|---|---|
| Expiration de la session checkout | 30 minutes |
| Délai de réception du webhook | < 3 secondes |
| Devise supportée | XOF (FCFA) |
| Méthode d'appel | REST + Bearer token |
| Statuts commande | processing → completed / failed |
| Environnement de test | Sandbox sans contrat |
À la réception du webhook checkout.session.completed, vous vérifiez la signature, marquez la commande WooCommerce comme completed et déclenchez la préparation. Ne validez jamais une commande sur la seule redirection du navigateur : elle peut être abandonnée alors que le paiement a réussi, ou l'inverse.
Mini cas pratique
Awa, gérante d'une boutique de cosmétiques à Dakar, fait 3 500 000 FCFA de ventes par mois sur WooCommerce. En self-hosted à 1 % de frais, elle paie 35 000 FCFA de commissions Wave. Chez un agrégateur à 2,5 %, elle paierait 87 500 FCFA, soit 52 500 FCFA de plus par mois. Son ticket dev de 400 000 FCFA est donc amorti en moins de 8 mois, après quoi elle économise plus de 600 000 FCFA par an.
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
Wave a-t-il un plugin WooCommerce officiel en 2026 ?
Non. Il faut passer par l'API Aggregated Merchant en self-hosted, ou par un agrégateur tiers qui, lui, fournit un plugin. Le développement direct reste la voie la moins chère à moyen terme.
Combien coûte l'intégration ?
Entre 250 000 et 450 000 FCFA pour une intégration self-hosted testée, webhook et gestion des échecs compris. Un agrégateur descend à 100 000 – 200 000 FCFA mais prélève ensuite une marge par transaction.
Quels sont les frais Wave côté commerçant ?
Environ 1 % en cash-in commerçant en 2026 (ordre de grandeur, à confirmer selon votre contrat). Le settlement se fait généralement à J+1 sur votre compte Wave Business.
Que se passe-t-il si le client ferme son navigateur après avoir payé ?
Rien n'est perdu : le webhook signé confirme le paiement côté serveur en moins de 3 secondes, indépendamment du navigateur. La session, elle, expire au bout de 30 minutes si le paiement n'est pas allé au bout.
Combien de temps pour mettre la boutique en ligne ?
3 à 5 jours ouvrés en self-hosted une fois le compte Wave Business validé, contre 1 à 2 jours via un agrégateur déjà branché.
Discutons de votre projet. On intègre Wave Checkout à votre WooCommerce, webhook et tests compris, en 3 à 5 jours. 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.
