Concepts clés
Les notions de base pour intégrer l'API FluxxPay.
Modèle agrégateur
Vous envoyez pays + opérateur (ex. BJ + mtn). FluxxPay achemine le paiement vers le réseau Mobile Money correspondant. Vous ne gérez pas les contrats opérateur un par un.
La liste à jour (minimums, OTP, collecte et décaissement) est la matrice des corridors.
Collecte (encaissement)
| Terme | Description |
|---|---|
| Collect | API d'encaissement Mobile Money (/api/v1/collect/payments) |
| Payout | API de décaissement Mobile Money (/api/v1/payout/) |
| Référence | Identifiant unique de commande côté marchand |
| Statut | pending, processing, completed, failed, etc. (minuscules en v2) |
| Référence PSP | Identifiant côté opérateur : champ psp_reference dans les réponses |
Montants
Pour Collect et Payout, amount est dans l’unité de la devise (ex. 100 = 100 FCFA en XOF).
Webhooks
Événements collect.payment.* pour le résultat final (collect.payment.completed, collect.payment.failed). Signature HMAC hex sur le body brut. Complétez par GET + ?sync=true en secours.
Produits marchands
En complément de l'API : FluxLink (lien à montant fixe), QuickLink (montant libre), FluxCorporate (masse), FluxPage et FluxMarket (à venir). Voir le panorama produits.