Le verdict en trois phrases
Wave Checkout est le moyen le plus rapide d'encaisser en ligne à Abidjan, avec une commission marchand de 1 % contre 1,5 à 2 % chez la plupart des concurrents. L'intégration technique se fait en 2 à 5 jours de développement autour d'un unique endpoint /checkout/sessions et d'un webhook signé. Le vrai délai n'est pas le code mais la validation KYC du compte marchand (3 à 7 jours ouvrés) : anticipez-la avant même d'écrire une ligne.
Les étapes d'intégration et leur durée
L'API Wave Business suit un flux classique : vous créez une session de paiement côté serveur, vous redirigez le client vers l'URL Wave, puis vous confirmez la commande uniquement sur réception du webhook. Ne validez jamais une commande sur le simple retour de redirection.
| Étape | Prérequis | Durée estimée 2026 |
|---|---|---|
| Ouverture compte marchand | Registre de commerce, pièce ID gérant | 1-2 jours |
| Validation KYC | Justificatif domicile entreprise, RIB | 3-7 jours ouvrés |
| Clé API sandbox | Compte validé | Immédiat |
| Endpoint /checkout/sessions | Backend HTTPS | 1 jour dev |
| Page de redirection + retour | URL success/error | 0,5 jour dev |
| Webhook de confirmation | URL publique + HMAC | 1 jour dev |
| Recette sandbox | Numéros de test | 1-2 jours |
Champs de l'API et frais 2026
La création d'une session demande peu de champs, ce qui explique la rapidité d'intégration. Voici les paramètres clés et l'ordre de grandeur des frais.
| Élément | Valeur / champ | Note 2026 |
|---|---|---|
amount | Entier en FCFA | Montant min 100 FCFA |
currency | XOF | Zone UEMOA |
success_url / error_url | HTTPS | Obligatoires |
client_reference | Votre ID commande | Sert à l'idempotence |
| Commission marchand | 1 % | Côté marchand, estimation |
| Délai de versement | T+1 à T+2 | Vers compte Wave/bancaire |
| Token / auth | Clé API secrète | Header Authorization |
| Webhook | POST signé | Vérifier la signature |
Mini cas pratique
Koffi gère une boutique de sneakers à Cocody, Abidjan. Il vend en moyenne 90 paires par mois à 35 000 FCFA, soit un chiffre d'affaires en ligne de 3 150 000 FCFA. Avec Wave à 1 %, ses frais mensuels de paiement s'élèvent à 31 500 FCFA. S'il était passé par un agrégateur à 2 %, il aurait payé 63 000 FCFA, soit 31 500 FCFA d'économie par mois (378 000 FCFA sur l'année). Le choix du provider n'est pas un détail comptable : c'est une marge nette.
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 de temps pour être opérationnel avec Wave Checkout ?
Comptez 2 à 5 jours de développement pur, mais planifiez surtout les 3 à 7 jours ouvrés de validation KYC du compte marchand. Au total, une boutique démarre généralement sous 10 jours calendaires.
Quels sont les frais réels côté marchand en 2026 ?
L'ordre de grandeur est de 1 % par transaction encaissée, l'un des taux les plus bas du marché ivoirien. Vérifiez toujours votre contrat marchand, car des paliers de volume peuvent s'appliquer.
Puis-je tester sans compte validé ?
Oui, l'environnement sandbox fournit des clés et des numéros de test pour simuler succès et échecs avant la mise en production. La recette dure en général 1 à 2 jours.
Le webhook est-il vraiment obligatoire ?
Oui. Le retour de redirection peut être manipulé ou interrompu ; seule la réception du webhook signé (vérification HMAC) doit déclencher la validation définitive de la commande.
Discutons de votre projet. Nous intégrons Wave Checkout sur votre boutique à Abidjan en moins d'une semaine, KYC compris. 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.
