Le verdict en trois phrases
En 2026, deux voies existent pour encaisser sur votre boutique : le checkout heberge Wave (lien de paiement, QR code) que vous branchez en 1 a 2 jours, et l'integration directe API avec webhooks que vous cablez en 4 a 8 jours. Le heberge gagne quand vous voulez lancer vite ; l'integration directe gagne quand vous voulez un checkout invisible dans votre tunnel et une reconciliation automatique. Dans les deux cas, le vrai risque n'est pas le code du paiement mais la fiabilite du webhook de confirmation : sans idempotence ni polling de secours, vous perdez des commandes.
Wave Business API vs Paystack Inline : ce que vous cablez vraiment
Wave (Senegal, Cote 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 differents mais la logique cote serveur est identique : creer une session, rediriger/ouvrir la modale, attendre le webhook, verifier le statut.
| Etape d'integration | Wave Business API | Paystack Inline |
|---|---|---|
| Temps dev (jours) | 4-8 | 3-6 |
| Pre-requis KYC | RCCM, piece dirigeant, compte Wave Business | RC, BVN/CAC, compte pro |
| Delai activation marchand | 3-10 jours | 2-7 jours |
| Mode d'encaissement | Checkout link + QR + API | Modale Inline + redirect |
| Webhook confirmation | Oblige (signature a verifier) | Oblige (x-paystack-signature) |
| Cout integration prestataire | 200 000 - 600 000 FCFA | 200 000 - 500 000 FCFA |
Le checkout link Wave se genere en un appel API et se partage meme par WhatsApp : ideal pour une premiere version. L'Inline Paystack donne une meilleure conversion car le client ne quitte jamais la page produit.
Les pieges webhook qui coutent des commandes
Un webhook, c'est Wave/Paystack qui appelle votre serveur pour dire "paiement reussi". Si votre serveur repond mal, l'operateur reessaie, et vous risquez de traiter deux fois la meme commande.
| Piege frequent | Consequence | Parade technique |
|---|---|---|
| Pas de verification de signature | Faux webhook, fraude | Verifier HMAC/secret a chaque appel |
| Pas d'idempotence | Commande dupliquee | Cle unique par transaction en base |
| Timeout serveur > 5 s | L'operateur retente en boucle | Repondre 200 vite, traiter en async |
| Webhook manque (reseau) | Paiement encaisse, commande absente | Polling de secours toutes les 2-5 min |
| Statut lu depuis le front | Client bidouille l'URL de retour | Statut confirme uniquement cote serveur |
Regle d'or : le webhook notifie, le polling confirme. 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 gere une boutique de cosmetiques a Dakar, 35 commandes/jour, panier moyen 18 000 FCFA. Elle demarre avec un checkout link Wave (2 jours de dev, 250 000 FCFA de prestation). Apres 3 semaines, elle constate un ecart : 4 paiements encaisses sur Wave sans commande enregistree, soit 72 000 FCFA "perdus" a rapprocher a la main chaque semaine. Kolonell ajoute un polling de secours + journal de reconciliation (1,5 jour, 180 000 FCFA). Resultat : ecart ramene a 0, et 40 minutes/semaine de pointage manuel economisees, soit ~2 h 40/mois qu'Awa reinvestit dans ses ventes WhatsApp.
FAQ
Faut-il forcement une integration directe API ? Non. Pour lancer, un checkout link Wave ou une modale Paystack suffit et se met en place en 1 a 3 jours. L'API directe se justifie quand votre volume depasse ~50 commandes/jour ou que vous voulez un tunnel 100 % maison.
Combien coute l'integration en 2026 ? Comptez un ordre de grandeur de 200 000 a 600 000 FCFA de prestation selon la complexite (heberge simple vs API + webhooks + reconciliation), hors frais operateur par transaction.
Combien de temps avant d'encaisser reellement ? Le code prend 4 a 8 jours, mais l'activation du compte marchand (KYC) ajoute 3 a 10 jours. Prevoyez 2 a 3 semaines bout en bout.
Wave ou Paystack pour une boutique senegalaise ? Wave domine le mobile money au Senegal et en Cote d'Ivoire ; Paystack est plus fort au Nigeria/Ghana avec cartes. Beaucoup de boutiques combinent Wave (local) et une carte via agregateur pour la diaspora.
Qui gere les webhooks apres la mise en ligne ? C'est un sujet d'ops permanent : monitoring, alertes sur echecs, reconciliation. Prevoyez une maintenance mensuelle plutot que de considerer le paiement comme "fini".
Discutons de votre projet. Kolonell integre Wave, Orange Money et Paystack avec webhooks fiables et reconciliation automatique, testes avec des montants reels. 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.
