Le verdict en trois phrases
Wave propose en 2026 l'API la plus simple d'Afrique francophone avec un frais marchand de 1 %, un checkout hébergé et des webhooks de confirmation fiables. L'intégration technique prend une journée, mais l'onboarding marchand (2 à 5 jours) et la gestion des reversements demandent de l'anticipation. Le vrai risque n'est pas le code : c'est de traiter la commande avant d'avoir reçu et vérifié le webhook checkout.session.completed.
Frais, plafonds et onboarding Wave 2026
Wave se distingue par une tarification transparente et sans frais cachés côté commerçant. Voici les ordres de grandeur observés en 2026 pour un compte Wave Business au Sénégal et en Côte d'Ivoire.
| Élément | Valeur 2026 (estimation) |
|---|---|
| Frais marchand par transaction | 1 % |
| Frais de retrait vers banque | 0 % (compte Wave) |
| Plafond transaction unitaire | 1 000 000 FCFA |
| Plafond quotidien marchand | Configurable, souvent illimité |
| Délai settlement | Instantané sur solde Wave |
| Délai onboarding marchand | 2 à 5 jours ouvrés |
| Devise | XOF (FCFA) |
| Pays couverts | Sénégal, Côte d'Ivoire |
Le compte marchand nécessite un justificatif d'activité (registre de commerce ou pièce d'identité pour un auto-entrepreneur). Une fois validé, vous recevez vos clés API (mode sandbox puis production).
Checklist d'intégration technique
Le flux Wave Checkout repose sur trois étapes : création de session, redirection, puis confirmation par webhook. Ne jamais valider une commande sur le simple retour navigateur.
| Étape | Action | Piège fréquent |
|---|---|---|
| 1. Session | POST /checkout/sessions avec montant + URL retour | Oublier client_reference (ID commande) |
| 2. Redirection | Rediriger vers wave_launch_url | Ouvrir dans une iframe (bloqué) |
| 3. Webhook | Écouter checkout.session.completed | Ne pas vérifier la signature HMAC |
| 4. Vérification | Re-appeler GET /sessions/{id} | Se fier au seul payload webhook |
| 5. Idempotence | Stocker l'event_id traité | Double comptage sur retry Wave |
| 6. Timeout | Session expire après 30 min | Ne pas gérer session.expired |
Wave renvoie les webhooks signés : validez toujours l'en-tête de signature avec votre secret avant de faire confiance au payload. En cas d'échec de votre endpoint, Wave retente plusieurs fois — d'où l'importance de l'idempotence.
Mini cas pratique
Fatou gère une boutique de cosmétiques à Dakar avec un panier moyen de 18 000 FCFA et 300 commandes par mois, soit 5 400 000 FCFA de chiffre d'affaires mensuel. Avec Wave à 1 %, elle paie 54 000 FCFA de frais par mois. Comparé à une passerelle carte internationale à 2,9 % + frais fixes (environ 160 000 FCFA), elle économise plus de 100 000 FCFA par mois, tout en offrant le moyen de paiement préféré de ses clientes. L'intégration a été livrée en 3 jours, dont 2 d'attente de validation du compte marchand.
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 coûte réellement Wave pour un marchand en 2026 ?
Le frais marchand est de 1 % par transaction, sans abonnement mensuel ni frais d'installation. Pour 5 000 000 FCFA de ventes, cela représente 50 000 FCFA de commission.
Faut-il obligatoirement gérer les webhooks ?
Oui. Le retour navigateur peut être interrompu (client qui ferme l'onglet). Seul le webhook checkout.session.completed, vérifié via un appel GET, garantit que le paiement est réellement encaissé.
Combien de temps pour activer un compte Wave Business ?
Comptez 2 à 5 jours ouvrés après dépôt des justificatifs. Prévoyez ce délai dans votre planning de lancement pour ne pas bloquer la mise en production.
Wave fonctionne-t-il en Côte d'Ivoire comme au Sénégal ?
Oui, Wave couvre les deux marchés en 2026 avec la même logique d'API en XOF. Les plafonds et justificatifs peuvent légèrement varier selon le pays.
Peut-on rembourser via l'API ?
Wave gère les remboursements côté marchand ; l'implémentation d'un endpoint de refund est recommandée pour automatiser les retours produits sans intervention manuelle.
Discutons de votre projet. Nous intégrons Wave Business dans votre boutique avec webhooks testés et mise en production maîtrisée. 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.
