Concepts clés
Quelques notions pour intégrer l'API FluxxPay efficacement.
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/) |
| 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. |
| Référence PSP | Identifiant côté opérateur — champ psp_reference dans les réponses |
Montants
Les montants API sont en centimes (ex. 10000 = 100 FCFA en XOF).
Webhooks
Événements collect.* pour le résultat final (collect.completed, collect.failed). 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.