Canaux de paiement
Comment accepter Wave ?
Mobile money Wave via checkout hébergé ou POST /charge/wave, comportement asynchrone en live et exigence XOF.
Wave est le rail mobile money principal pour l’UEMOA (XOF). Préférez checkout hébergé ou liens de paiement.
En bref
| Approbation | Redirection ou URL de lancement (wave_launch_url / checkout_url) |
| Règlement | Test : souvent à la création. Live : après approbation dans Wave, puis available_at |
| Direct vs hébergé | Hébergé et POST /charge/wave |
| Remboursement | Transactions Wave completed |
| Min / max | - |
| Devise | XOF |
Mêmes colonnes que Canaux de paiement.
Checkout hébergé (recommandé)
- Créez une session avec
currency_code: "XOF". - Le client choisit Wave.
- Il approuve dans l’app Wave.
- Confirmez via webhooks ou
GET /transactions/{id}avant livraison.
Charge directe
POST /charge/wave exige le XOF. La réponse contient wave_launch_url ou checkout_url.
Voir API Charges et Charges directes.
Test vs live
| Test | Live | |
|---|---|---|
| Crédit solde | Souvent à la création | Après approbation Wave |
| Statut | Souvent completed rapidement | Démarre en pending |
En live, ne livrez pas sur la seule redirection. Voir Vérifier les paiements.
Reversements
Les reversements Wave bénéficiaire exigent une clé live. En test, les reversements Wave renvoient 400. Voir Reversements test.