Le verdict en trois phrases
En 2026, deux voies existent pour encaisser sur votre boutique : le checkout hébergé Wave (lien de paiement, QR code) que vous branchez en 1 à 2 jours, et l'intégration directe API avec webhooks que vous câblez en 4 à 8 jours. Le hébergé gagne quand vous voulez lancer vite ; l'intégration directe gagne quand vous voulez un checkout invisible dans votre tunnel et une réconciliation automatique. Dans les deux cas, le vrai risque n'est pas le code du paiement mais la fiabilité du webhook de confirmation : sans idempotence ni polling de secours, vous perdez des commandes.
Wave Business API vs Paystack Inline : ce que vous câblez vraiment
Wave (Sénégal, Côte d'Ivoire) expose une API Business avec checkout link, QR et webhooks. Paystack (Nigeria, Ghana) propose l'Inline JS qui ouvre une modale sans quitter la page. Les deux couvrent des besoins différents mais la logique côté serveur est identique : créer une session, rediriger/ouvrir la modale, attendre le webhook, vérifier le statut.
| Étape d'intégration | Wave Business API | Paystack Inline |
|---|---|---|
| Temps dev (jours) | 4-8 | 3-6 |
| Pré-requis KYC | RCCM, pièce dirigeant, compte Wave Business | RC, BVN/CAC, compte pro |
| Délai activation marchand | 3-10 jours | 2-7 jours |
| Mode d'encaissement | Checkout link + QR + API | Modale Inline + redirect |
| Webhook confirmation | Oblige (signature à vérifier) | Oblige (x-paystack-signature) |
| Coût intégration prestataire | 200 000 - 600 000 FCFA | 200 000 - 500 000 FCFA |
Le checkout link Wave se génère en un appel API et se partage même par WhatsApp : idéal pour une première version. L'Inline Paystack donne une meilleure conversion car le client ne quitte jamais la page produit.
Les pièges webhook qui coûtent des commandes
Un webhook, c'est Wave/Paystack qui appelle votre serveur pour dire "paiement réussi". Si votre serveur répond mal, l'opérateur réessaie, et vous risquez de traiter deux fois la même commande.
| Piège fréquent | Conséquence | Parade technique |
|---|---|---|
| Pas de vérification de signature | Faux webhook, fraude | Vérifier HMAC/secret à chaque appel |
| Pas d'idempotence | Commande dupliquée | Clé unique par transaction en base |
| Timeout serveur > 5 s | L'opérateur retente en boucle | Répondre 200 vite, traiter en async |
| Webhook manqué (réseau) | Paiement encaissé, commande absente | Polling de secours toutes les 2-5 min |
| Statut lu depuis le front | Client bidouille l'URL de retour | Statut confirmé uniquement côté serveur |
Règle d'or : le webhook notifie, le polling confirmé. On ne valide jamais une commande sur la seule foi de la page de retour.
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 à Dakar, 35 commandes/jour, panier moyen 18 000 FCFA. Elle démarre avec un checkout link Wave (2 jours de dev, 250 000 FCFA de prestation). Après 3 semaines, elle constate un écart : 4 paiements encaissés sur Wave sans commande enregistrée, soit 72 000 FCFA "perdus" à rapprocher à la main chaque semaine. Kolonell ajoute un polling de secours + journal de réconciliation (1,5 jour, 180 000 FCFA). Résultat : écart ramené à 0, et 40 minutes/semaine de pointage manuel économisées, soit ~2 h 40/mois qu'Awa réinvestit dans ses ventes WhatsApp.
FAQ
Faut-il forcément une intégration directe API ? Non. Pour lancer, un checkout link Wave ou une modale Paystack suffit et se met en place en 1 à 3 jours. L'API directe se justifie quand votre volume dépasse ~50 commandes/jour ou que vous voulez un tunnel 100 % maison.
Combien coûte l'intégration en 2026 ? Comptez un ordre de grandeur de 200 000 à 600 000 FCFA de prestation selon la complexité (hébergé simple vs API + webhooks + réconciliation), hors frais opérateur par transaction.
Combien de temps avant d'encaisser réellement ? Le code prend 4 à 8 jours, mais l'activation du compte marchand (KYC) ajoute 3 à 10 jours. Prévoyez 2 à 3 semaines bout en bout.
Wave ou Paystack pour une boutique sénégalaise ? Wave domine le mobile money au Sénégal et en Côte d'Ivoire ; Paystack est plus fort au Nigeria/Ghana avec cartes. Beaucoup de boutiques combinent Wave (local) et une carte via agrégateur pour la diaspora.
Qui gère les webhooks après la mise en ligne ? C'est un sujet d'ops permanent : monitoring, alertes sur échecs, réconciliation. Prévoyez une maintenance mensuelle plutôt que de considérer le paiement comme "fini".
Discutons de votre projet. Kolonell intègre Wave, Orange Money et Paystack avec webhooks fiables et réconciliation automatique, testés avec des montants réels. 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.
