Skip to main content

​
À propos de cette documentation

Cette documentation s’adresse aux développeurs qui intègrent l’API CaurisFlux dans leurs applications. Elle couvre l’ensemble du cycle de vie des paiements : initiation, confirmation, webhooks et gestion des erreurs. Public cible :
  • Développeurs backend intégrant les paiements
  • Équipes techniques évaluant la solution
  • Architectes concevant des flux de paiement

​
Qu’est-ce que CaurisFlux ?

CaurisFlux est une infrastructure de paiement unifiée pour l’Afrique. Elle permet de collecter des paiements (Mobile Money, cartes internationales) et d’effectuer des décaissements vers l’Afrique, l’Europe et les États-Unis.

​
Collecte de paiements (Pay-in)

TypeFournisseursZones
Mobile MoneyWave, Orange Money, MTN MoMo, Moov Money, Free Money, Airtel MoneyUEMOA, CEMAC
Cartes InternationalesVisa, Mastercard, American ExpressMondial
Cartes RégionalesGIM-UEMOAZone UEMOA

​
Décaissements (Pay-out)

CorridorDestinationsDevises
Mobile Money14 pays UEMOA/CEMACXOF, XAF
SEPA36 pays européensEUR
USAÉtats-UnisUSD
Swift180+ paysMulti-devises

​
Couverture géographique

Zone UEMOA

Sénégal, Côte d’Ivoire, Mali, Burkina Faso, Togo, Bénin, Niger, Guinée-BissauDevise : XOF (Franc CFA BCEAO)

Zone CEMAC

Cameroun, Gabon, Congo, Tchad, RCA, Guinée ÉquatorialeDevise : XAF (Franc CFA BEAC)

​
Ce que vous pouvez faire avec l’API

  • Collecter des paiements : Acceptez les paiements Mobile Money et carte via checkout ou API directe
  • Effectuer des décaissements (payouts) : Envoyez des fonds vers des comptes Mobile Money ou bancaires (locaux et internationaux)
  • Gérer les remboursements : Initiez des remboursements totaux ou partiels
  • Suivre les transactions : Consultez l’historique et les statistiques
  • Recevoir des notifications : Configurez des webhooks pour les événements en temps réel

​
Environnements

EnvironnementURL de basePréfixe clés
Sandboxhttps://sandbox-api.caurisflux.com/api/v1pk_test_ / sk_test_
Productionhttps://prod-api.caurisflux.com/api/v1pk_live_ / sk_live_
Les deux environnements utilisent des clés API distinctes. Les transactions sandbox n’entraînent aucun mouvement de fonds.

​
Flux de paiement (Collect)

  1. Récupérer les méthodes - GET /payments/providers
  2. Initier le paiement - POST /payments/initiate
  3. Rediriger le client vers redirectUrl retourné
  4. Recevoir le webhook de confirmation
  5. Vérifier le statut - GET /payments/status/:transactionId

​
Flux de payout (Décaissement)

​
Payout local (Mobile Money ou Virement bancaire)

  1. Vérifier les limites - GET /payouts/limits
  2. Créer le payout - POST /payouts/initiate
  3. Recevoir le webhook de confirmation
  4. Vérifier le statut - GET /payments/status/:payoutId

​
Payout international (Virement avec conversion)

  1. Vérifier les corridors - GET /payouts/reference/corridors
  2. Récupérer les motifs - GET /payouts/reference/purposes
  3. Vérifier les documents requis - GET /payouts/reference/document-types
  4. Vérifier les champs requis - GET /payouts/reference/methods
  5. Vérifier les limites - GET /payouts/limits
  6. Créer le payout - POST /payouts/initiate
  7. Recevoir le webhook de confirmation
  8. Vérifier le statut - GET /payments/status/:payoutId

​
Structure de la documentation

Démarrage rapide

Créez votre premier paiement en quelques étapes

Concepts clés

Transactions, statuts, webhooks et environnements

Référence API

Spécifications techniques des endpoints

Webhooks

Notifications en temps réel

​
Avant de commencer

  1. Créez un compte sur dash-app.caurisflux.com
  2. Récupérez vos clés API dans Paramètres > API
  3. Testez en sandbox avec les clés pk_test_* / sk_test_*
  4. Passez en production après validation de votre intégration

​
Support