Le verdict en trois phrases
L'API Wave Business couvre deux besoins distincts : Collect (encaisser vos clients) et Payout (verser à des tiers, vendeurs ou salariés). Comptez 2 à 4 jours de développement pour un checkout fonctionnel, un webhook signé et une réconciliation propre. Le vrai avantage est économique : 1 % d'encaissement et un settlement en T+0, là où d'autres opérateurs facturent plus et règlent plus lentement.
Collect vs Payout : deux endpoints, deux logiques
Collect génère une session de paiement (checkout hébergé ou QR code) et vous notifie par webhook quand le client a payé. Payout envoie de l'argent *depuis* votre compte marchand vers un numéro Wave, utile pour les marketplaces (split vendeur) et la paie. Chacun a son cycle de vie et ses statuts.
| Aspect | Collect | Payout |
|---|---|---|
| Sens du flux | Client → marchand | Marchand → tiers |
| Déclencheur | POST /checkout/sessions | POST /payout |
| Confirmation | Webhook checkout.session.completed | Webhook payout.completed |
| Statuts | open, complete, expired | processing, succeeded, failed |
| Cas d'usage | Boutique, facture | Marketplace, salaire vendeur |
| Idempotence | client_reference | idempotency-key |
Frais, plafonds et délais : les chiffres 2026
Le choix d'un opérateur se joue sur trois chiffres : le taux, le plafond par transaction et le délai de règlement. Voici un ordre de grandeur 2026 pour la zone UEMOA.
| Opérateur | Frais encaissement | Plafond / transaction | Settlement |
|---|---|---|---|
| Wave | 1 % | 500 000 FCFA | T+0 |
| Orange Money | 1,4 % + 100 FCFA | 1 000 000 FCFA | T+1 |
| Free Money | 1,5 % | 500 000 FCFA | T+1 |
| MTN MoMo (CI) | ~1,5 % | 1 000 000 FCFA | T+1 |
Sur un panier moyen de 25 000 FCFA, Wave prélève 250 FCFA, contre 450 FCFA chez Orange Money (350 + 100). Sur 1 000 commandes par mois, l'écart atteint 200 000 FCFA — de quoi financer votre maintenance.
Sécuriser le webhook et réconcilier
Un webhook Wave arrive signé : vérifiez la signature HMAC avec votre secret avant de traiter. Répondez HTTP 200 en moins de 2 secondes, sinon Wave relance. Stockez chaque event_id dans une table de déduplication pour ne jamais créditer deux fois une commande — l'idempotence est traitée en détail dans un article dédié.
| Étape | Action technique | Durée typique |
|---|---|---|
| 1. Créer session | Appel Collect + client_reference | < 1 j |
| 2. Rediriger client | Checkout hébergé ou QR | < 1 j |
| 3. Recevoir webhook | Vérif signature + statut | 1 j |
| 4. Réconcilier | Match commande ↔ transaction | 1 j |
| 5. Payout (option) | Split vendeur marketplace | 1 j |
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érante d'une boutique de cosmétiques à Dakar, encaisse 850 commandes par mois à un panier moyen de 22 000 FCFA, soit 18 700 000 FCFA de volume. Avec Wave à 1 %, elle paie 187 000 FCFA de frais. Avec Orange Money (1,4 % + 100 FCFA), elle paierait 261 800 + 85 000 = 346 800 FCFA. Économie mensuelle : 159 800 FCFA, soit près de 1 917 600 FCFA par an. Le coût d'intégration (4 jours de dev) est amorti dès le premier mois.
FAQ
Combien de temps pour intégrer l'API Wave ?
Comptez 2 à 4 jours pour un développeur expérimenté : création de session, redirection, webhook signé et réconciliation. Ajoutez 1 jour si vous branchez aussi le Payout pour une marketplace.
Quel est le plafond par transaction chez Wave ?
En 2026, l'ordre de grandeur est de 500 000 FCFA par transaction. Pour des paniers plus élevés, il faut fractionner ou passer par un autre canal — anticipez-le dans votre logique de checkout.
Le settlement T+0 est-il vraiment immédiat ?
Les fonds encaissés sont crédités sur votre compte Wave marchand le jour même, ce qui améliore votre trésorerie face au T+1 d'autres opérateurs. Le virement vers votre banque suit son propre calendrier.
Faut-il tester en sandbox avant la prod ?
Oui, impérativement. Environ 70 % des bugs de production viennent de webhooks non testés. Utilisez les clés de test et simulez les échecs avant de passer en live.
Discutons de votre projet. Nous intégrons Wave Collect + Payout, webhooks signés et réconciliation en moins d'une semaine. 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.
