Le verdict en trois phrases
Wave Checkout est le moyen le plus rapide d'encaisser en ligne a Abidjan, avec une commission marchand de 1 % contre 1,5 a 2 % chez la plupart des concurrents. L'integration technique se fait en 2 a 5 jours de developpement autour d'un unique endpoint /checkout/sessions et d'un webhook signe. Le vrai delai n'est pas le code mais la validation KYC du compte marchand (3 a 7 jours ouvres) : anticipez-la avant meme d'ecrire une ligne.
Les etapes d'integration et leur duree
L'API Wave Business suit un flux classique : vous creez une session de paiement cote serveur, vous redirigez le client vers l'URL Wave, puis vous confirmez la commande uniquement sur reception du webhook. Ne validez jamais une commande sur le simple retour de redirection.
| Etape | Prerequis | Duree estimee 2026 |
|---|---|---|
| Ouverture compte marchand | Registre de commerce, piece ID gerant | 1-2 jours |
| Validation KYC | Justificatif domicile entreprise, RIB | 3-7 jours ouvres |
| Cle API sandbox | Compte valide | Immediat |
| 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 | Numeros de test | 1-2 jours |
Champs de l'API et frais 2026
La creation d'une session demande peu de champs, ce qui explique la rapidite d'integration. Voici les parametres cles et l'ordre de grandeur des frais.
| Element | 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 a l'idempotence |
| Commission marchand | 1 % | Cote marchand, estimation |
| Delai de versement | T+1 a T+2 | Vers compte Wave/bancaire |
| Token / auth | Cle API secrete | Header Authorization |
| Webhook | POST signe | Verifier la signature |
Mini cas pratique
Koffi gere une boutique de sneakers a Cocody, Abidjan. Il vend en moyenne 90 paires par mois a 35 000 FCFA, soit un chiffre d'affaires en ligne de 3 150 000 FCFA. Avec Wave a 1 %, ses frais mensuels de paiement s'elevent a 31 500 FCFA. S'il etait passe par un agregateur a 2 %, il aurait paye 63 000 FCFA, soit 31 500 FCFA d'economie par mois (378 000 FCFA sur l'annee). Le choix du provider n'est pas un detail 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 etre operationnel avec Wave Checkout ?
Comptez 2 a 5 jours de developpement pur, mais planifiez surtout les 3 a 7 jours ouvres de validation KYC du compte marchand. Au total, une boutique demarre generalement sous 10 jours calendaires.
Quels sont les frais reels cote marchand en 2026 ?
L'ordre de grandeur est de 1 % par transaction encaissee, l'un des taux les plus bas du marche ivoirien. Verifiez toujours votre contrat marchand, car des paliers de volume peuvent s'appliquer.
Puis-je tester sans compte valide ?
Oui, l'environnement sandbox fournit des cles et des numeros de test pour simuler succes et echecs avant la mise en production. La recette dure en general 1 a 2 jours.
Le webhook est-il vraiment obligatoire ?
Oui. Le retour de redirection peut etre manipule ou interrompu ; seule la reception du webhook signe (verification HMAC) doit declencher la validation definitive de la commande.
Discutons de votre projet. Nous integrons Wave Checkout sur votre boutique a 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.
