Le verdict en trois phrases
Intégrer Wave dans une boutique en ligne à Abidjan prend 1 à 5 jours selon que vous choisissez un checkout hosted (redirection) ou une intégration API complète. Le settlement Wave est en T+0 (versement le jour même), ce qui change tout pour la trésorerie d'un commerçant. Les deux pièges qui coûtent cher sont l'idempotence (éviter le double paiement) et le webhook de confirmation mal sécurisé.
Hosted vs API : que choisir
Le mode *hosted* génère 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.
| Critère | Checkout hosted | Intégration API |
|---|---|---|
| Délai de dev | 1 à 2 jours | 3 à 5 jours |
| Coût dev (estimation) | 150 000 - 300 000 FCFA | 350 000 - 600 000 FCFA |
| Webhook obligatoire | Oui | Oui |
| Contrôle du design | Faible | Total |
| Risque PCI | Nul (chez Wave) | Nul (mobile money) |
| Settlement | T+0 | T+0 |
Pour 80 % des boutiques qui démarrent, le *hosted* suffit et réduit la surface de bugs.
Les étapes techniques
Le flow standard tient en cinq étapes, chacune avec son point de vigilance.
| Étape | Action | Piège à éviter |
|---|---|---|
| 1. Clé API | Générer clé live + secret | Ne jamais exposer côté client |
| 2. Session | Créer checkout_session avec montant + référence | Référence unique par commande |
| 3. Redirect | Envoyer le client vers Wave | Gérer le retour annule |
| 4. Webhook | Recevoir la confirmation signée | Vérifier la signature HMAC |
| 5. Idempotence | Marquer la commande payée une seule fois | Clé idempotente en base |
Le montant minimum d'une transaction Wave est de 100 FCFA ; les frais marchand tournent autour de 1 % côté encaissement en 2026 (ordre de grandeur, à 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 gère une boutique de cosmétiques à Cocody, Abidjan. Elle vend environ 220 commandes/mois à un panier moyen de 18 000 FCFA, soit 3 960 000 FCFA de volume. En hosted, l'intégration lui a coûté 220 000 FCFA une fois. Avec un settlement T+0, elle récupère sa trésorerie le jour même au lieu d'attendre J+2 : sur un mois, cela débloque en moyenne 260 000 FCFA de fonds de roulement plus tôt. Le retour sur investissement de l'intégration 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 câble en 1 à 2 jours ; une intégration API complète avec webhook et idempotence demande 3 à 5 jours de développement.
Quel est le coût de développement ? Comptez 150 000 à 300 000 FCFA en hosted, et 350 000 à 600 000 FCFA en API complète (estimation 2026, hors design de la boutique).
Le webhook est-il vraiment obligatoire ? Oui. Sans webhook de confirmation, vous risquez de marquer une commande payée alors qu'elle ne l'est pas, ou l'inverse. Prévoyez aussi un polling getStatus de secours.
Comment éviter le double paiement ? En stockant une clé d'idempotence par commande : si le webhook arrive deux fois, la commande n'est validée qu'une seule fois. C'est le bug numéro un des intégrations bâclé.
Wave verse quand mon argent ? En T+0, soit le jour même dans la plupart des cas, ce qui est un avantage majeur face aux délais T+1 ou T+2 d'autres solutions.
Discutons de votre projet. Nous intégrons 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.
