Le verdict en trois phrases
Un checkout Wave fiable repose sur quatre briques : création de session, redirection client, webhook de confirmation et réconciliation. Sans le webhook, vous générez des paiements orphelins — le client paie, mais votre base ne le sait jamais. En 2026 à Abidjan, avec des frais Wave CI de 1 % et une intégration de 2 à 4 jours dev, viser un taux de succès > 95 % est réaliste.
Les quatre étapes du flux Wave
Le flux Wave Checkout est volontairement simple, mais chaque étape a un piège. La création de session renvoie une wave_launch_url ; ne redirigez jamais avant d'avoir persisté la commande en base avec un statut pending.
| Étape | Action serveur | Piège fréquent | Bonne pratique |
|---|---|---|---|
| 1. Créer session | POST /checkout/sessions | Oublier client_reference | Injecter votre order_id |
| 2. Rediriger | 302 vers wave_launch_url | Rediriger avant persistance | Statut pending d'abord |
| 3. Confirmer | Recevoir webhook signé | Se fier au retour navigateur | Attendre le webhook |
| 4. Réconcilier | Marquer paid + idempotence | Double traitement | Clé d'idempotence |
Le retour navigateur (success_url) n'est jamais une preuve de paiement : le client peut fermer l'onglet. Seul le webhook fait foi.
Frais, délais et coûts 2026
Wave se distingue par une tarification plate côté marchand. Voici les ordres de grandeur observés à Abidjan en 2026 (estimations).
| Poste | Valeur 2026 | Commentaire |
|---|---|---|
| Frais transaction Wave CI | 1 % | Prélevé côté marchand |
| Temps d'intégration | 2 à 4 jours dev | API + webhook + tests |
| Taux de succès attendu | > 95 % | Après durcissement |
| Timeout de session | 30 min | Expiration pending |
| Coût agence intégration | 200 000 à 500 000 FCFA | Selon complexité |
| Délai settlement | 24 à 48 h | Vers compte marchand |
Une boutique qui traite 5 000 000 FCFA de ventes mensuelles paie donc environ 50 000 FCFA de frais Wave — à comparer aux 3 à 4 % d'un agrégateur international.
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.
Mini cas pratique
Awa, gérante d'une boutique de cosmétiques à Cocody, encaisse 90 commandes par mois à 25 000 FCFA en moyenne, soit 2 250 000 FCFA. Avant l'intégration Wave, 15 % des paiements mobiles étaient perdus par saisie manuelle du numéro. Après un checkout Wave avec webhook, le taux d'orphelins tombe sous 2 %. Gain récupéré : environ 13 commandes/mois soit 325 000 FCFA — l'intégration à 350 000 FCFA est amortie en un mois.
FAQ
Le webhook Wave est-il obligatoire ? Oui, techniquement indispensable. Le retour navigateur n'est pas fiable ; sans webhook signé vous perdez la confirmation de 5 à 15 % des paiements selon la qualité réseau.
Combien coûte réellement Wave par transaction ? En 2026 les frais marchands Wave CI tournent autour de 1 %, soit 3 à 4 fois moins qu'un agrégateur carte international à 3,8 %.
Combien de temps pour intégrer ? Comptez 2 à 4 jours de développement pour un développeur expérimenté : session, redirection, webhook et réconciliation avec tests sandbox.
Que faire des sessions non payées ? Après le timeout de 30 minutes, passez la commande en expired par un job planifié. Ne les laissez jamais bloquer le stock indéfiniment.
Peut-on tester sans compte de production ? Oui, l'environnement sandbox Wave permet de simuler succès et échecs avant la mise en production, ce qui capte l'essentiel des bugs.
Discutons de votre projet. Nous intégrons Wave à votre checkout en 2 à 4 jours, webhook et réconciliation inclus. 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.
