Le verdict en trois phrases
Intégrer Wave Business API dans un checkout Flutter à Abidjan coûte 2 à 3 jours de développement et vous fait passer d'un agrégateur à 2,9 % + 100 FCFA vers un tarif marchand de 1 % sans frais client. Le settlement est en T+1, le sandbox est gratuit et le webhook signé HMAC est obligatoire pour confirmer les paiements de façon fiable. Sur 5 000 000 FCFA de ventes mensuelles, vous économisez environ 95 000 FCFA par mois en frais.
Le flux d'intégration pas-à-pas
Wave expose une API REST simple : vous créez une *checkout session*, vous récupérez une URL de paiement (ou un QR), et vous écoutez le webhook de confirmation. Dans Flutter, on ouvre l'URL dans un WebView ou via url_launcher, puis on vérifie le statut côté serveur avant de valider la commande.
| Étape | Action technique | Durée estimée |
|---|---|---|
| 1. Compte marchand | Activation Wave Business + clé API sandbox | 1 h |
| 2. Endpoint checkout | POST /v1/checkout/sessions (montant, devise XOF) | 3 h |
| 3. WebView Flutter | Ouverture URL + retour success_url | 4 h |
| 4. Webhook HMAC | Vérification signature + idempotence | 5 h |
| 5. Réconciliation | Statut serveur avant fulfilment | 3 h |
| 6. Tests sandbox | Cas succès, échec, timeout | 4 h |
Wave contre un agrégateur : le vrai coût
Le différenciateur de Wave est le 1 % marchand sans frais côté client, là où un agrégateur classique ajoute une commission sur chaque transaction et parfois un frais fixe.
| Critère | Wave Business | Agrégateur type |
|---|---|---|
| Frais marchand | 1 % | 2,9 % + 100 FCFA |
| Frais client | 0 FCFA | souvent répercuté |
| Settlement | T+1 | T+2 à T+3 |
| Sandbox | Gratuit | Gratuit |
| Webhook | HMAC obligatoire | Signature variable |
| Sur 100 000 FCFA | 1 000 FCFA | 3 000 FCFA |
Ces chiffres sont un ordre de grandeur 2026 et doivent être confirmés dans votre contrat marchand.
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
Aminata gère une boutique de cosmétiques à Abidjan via son app Flutter. Elle encaisse 5 000 000 FCFA par mois. Avec un agrégateur à 2,9 % + 100 FCFA sur ~1 000 transactions, elle paie environ 145 000 + 100 000 = 245 000 FCFA. Avec Wave à 1 %, elle paie 50 000 FCFA. Économie mensuelle : ~195 000 FCFA, soit plus de 2 300 000 FCFA par an réinvestis dans le stock.
FAQ
Le webhook HMAC est-il vraiment obligatoire ? Oui. Sans vérification de signature, un attaquant peut simuler un paiement réussi. Wave signe chaque événement ; vous recalculez le HMAC avec votre secret et comparez avant de valider la commande.
Combien de temps pour être en production ? Comptez 2 à 3 jours de développement pour un checkout complet, plus la validation du compte marchand qui peut prendre quelques jours ouvrés.
Que faire si le client ferme la WebView avant la fin ? Ne validez jamais la commande côté client. Attendez le webhook ou interrogez GET /v1/checkout/sessions/{id} côté serveur pour connaître le vrai statut.
Wave fonctionne-t-il hors Côte d'Ivoire ? Wave est disponible au Sénégal et en Côte d'Ivoire notamment ; vérifiez la couverture pays et la devise XOF dans votre tableau de bord marchand avant de lancer.
Discutons de votre projet. Nous intégrons Wave dans votre app Flutter avec webhook signé et réconciliation en 2 à 3 jours. 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.
