Le verdict en trois phrases
En 2026, un développeur branche une première session checkout Wave en moins de 30 minutes : récupérer les clés sandbox, créer une session de paiement, puis gérer trois statuts — pending, succeeded, failed. La force de la DX Wave : documentation en français et sandbox gratuit pour tester sans argent réel. Côté anglophone, Paystack Ghana joue la même carte avec support du cedi (GHS) et un frais de 1,95 %.
Démarrage en 30 minutes
| Étape | Action | Durée |
|---|---|---|
| 1 | Créer le compte + clés API sandbox | 5 min |
| 2 | Appeler l'endpoint création de session | 10 min |
| 3 | Rediriger vers l'URL de checkout | 5 min |
| 4 | Gérer le retour + statut | 5 min |
| 5 | Brancher le webhook de confirmation | 5 min |
Utilisez toujours les clés sandbox d'abord : elles simulent des paiements réussis et échoués sans mouvement d'argent.
Les endpoints et objets clés
| Endpoint / objet | Rôle | Champs importants |
|---|---|---|
| POST /checkout/sessions | Créer une session | amount, currency, success_url |
| GET /checkout/sessions/{id} | Lire le statut | status, transaction_id |
| Webhook checkout.completed | Confirmer le paiement | status, amount, id |
| Objet Session | État du paiement | pending / succeeded / failed |
| Objet Transaction | Détail encaissement | id, fees, settled_at |
Gérez les trois statuts explicitement : pending (afficher un écran d'attente), succeeded (valider via webhook), failed (proposer un nouvel essai).
Wave vs Paystack Ghana : la DX comparée
| Critère | Wave (XOF) | Paystack Ghana (GHS) |
|---|---|---|
| Frais local | 1 % | 1,95 % |
| Devise | FCFA (XOF) | Cedi (GHS) |
| Langue docs | Français + anglais | Anglais |
| Sandbox | Gratuit | Gratuit |
| Settlement | J+1 | T+1 |
| Méthodes | Wallet Wave, QR | Cartes, mobile money MoMo |
Wave séduit les équipes francophones d'Afrique de l'Ouest ; Paystack Ghana couvre le marché anglophone et le mobile money MoMo local.
Mini cas pratique
Sophie, développeuse freelance à Dakar, doit livrer un checkout pour une boutique cliente. En sandbox Wave, elle crée la session, teste un paiement succeeded et un failed, puis branche le webhook — le tout en 45 minutes montre en main. Facturé 80 000 FCFA la journée, son intégration complète (checkout + webhook + tests) tient en 2 jours, soit 160 000 FCFA, largement rentabilisés par la baisse des abandons de panier côté client.
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 un premier paiement en sandbox ?
Moins de 30 minutes : clés sandbox, création de session et redirection. Le sandbox simule succès et échec sans argent réel.
Les docs Wave sont-elles en français ?
Oui, ce qui accélère l'onboarding des équipes francophones. Paystack Ghana, lui, documente en anglais avec support du cedi GHS.
Quels statuts dois-je gérer ?
Trois : pending (en attente), succeeded (payé, à confirmer par webhook) et failed (échec, proposer un nouvel essai). Ne validez jamais sur le seul retour navigateur.
Le sandbox est-il gratuit ?
Oui, chez Wave comme chez Paystack. Vous testez toute la logique de paiement avant de passer en production avec les clés live.
Quelle différence de frais avec Paystack Ghana ?
Wave applique 1 % en zone XOF, Paystack Ghana 1,95 % en GHS. Le choix dépend surtout de votre marché et de votre devise.
Discutons de votre projet. On code votre intégration Wave de A à Z, sandbox puis production. 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.
