Le verdict en trois phrases
Integrer Wave dans une boutique en ligne a Abidjan prend 1 a 5 jours selon que vous choisissez un checkout hosted (redirection) ou une integration API complete. Le settlement Wave est en T+0 (versement le jour meme), ce qui change tout pour la tresorerie d'un commercant. Les deux pieges qui coutent cher sont l'idempotence (eviter le double paiement) et le webhook de confirmation mal securise.
Hosted vs API : que choisir
Le mode *hosted* genere une session de paiement et redirige le client vers une page Wave. Le mode *API* garde le client sur votre site et pilote tout le flow. Voici les ordres de grandeur 2026.
| Critere | Checkout hosted | Integration API |
|---|---|---|
| Delai de dev | 1 a 2 jours | 3 a 5 jours |
| Cout dev (estimation) | 150 000 - 300 000 FCFA | 350 000 - 600 000 FCFA |
| Webhook obligatoire | Oui | Oui |
| Controle du design | Faible | Total |
| Risque PCI | Nul (chez Wave) | Nul (mobile money) |
| Settlement | T+0 | T+0 |
Pour 80 % des boutiques qui demarrent, le *hosted* suffit et reduit la surface de bugs.
Les etapes techniques
Le flow standard tient en cinq etapes, chacune avec son point de vigilance.
| Etape | Action | Piege a eviter |
|---|---|---|
| 1. Cle API | Generer cle live + secret | Ne jamais exposer cote client |
| 2. Session | Creer checkout_session avec montant + reference | Reference unique par commande |
| 3. Redirect | Envoyer le client vers Wave | Gerer le retour annule |
| 4. Webhook | Recevoir la confirmation signee | Verifier la signature HMAC |
| 5. Idempotence | Marquer la commande payee une seule fois | Cle idempotente en base |
Le montant minimum d'une transaction Wave est de 100 FCFA ; les frais marchand tournent autour de 1 % cote encaissement en 2026 (ordre de grandeur, a confirmer selon votre contrat).
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 gere une boutique de cosmetiques a Cocody, Abidjan. Elle vend environ 220 commandes/mois a un panier moyen de 18 000 FCFA, soit 3 960 000 FCFA de volume. En hosted, l'integration lui a coute 220 000 FCFA une fois. Avec un settlement T+0, elle recupere sa tresorerie le jour meme au lieu d'attendre J+2 : sur un mois, cela debloque en moyenne 260 000 FCFA de fonds de roulement plus tot. Le retour sur investissement de l'integration est atteint en moins de 2 mois.
FAQ
Combien de temps pour brancher Wave sur ma boutique ? Entre 1 et 5 jours. Un checkout hosted se cable en 1 a 2 jours ; une integration API complete avec webhook et idempotence demande 3 a 5 jours de developpement.
Quel est le cout de developpement ? Comptez 150 000 a 300 000 FCFA en hosted, et 350 000 a 600 000 FCFA en API complete (estimation 2026, hors design de la boutique).
Le webhook est-il vraiment obligatoire ? Oui. Sans webhook de confirmation, vous risquez de marquer une commande payee alors qu'elle ne l'est pas, ou l'inverse. Prevoyez aussi un polling getStatus de secours.
Comment eviter le double paiement ? En stockant une cle d'idempotence par commande : si le webhook arrive deux fois, la commande n'est validee qu'une seule fois. C'est le bug numero un des integrations bacle.
Wave verse quand mon argent ? En T+0, soit le jour meme dans la plupart des cas, ce qui est un avantage majeur face aux delais T+1 ou T+2 d'autres solutions.
Discutons de votre projet. Nous integrons Wave et Orange Money sur votre boutique avec webhook fiable et gestion de l'idempotence. 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.
