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.
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 l'API Collect, les montants sont en unités majeures (ex. 3000 = 3 000 FCFA en XOF). L'API Payout et d'autres produits peuvent encore utiliser des centimes — consultez la page concernée.
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.