Introduction

Documentation technique de l'API CaurisFlux

À 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)

Type	Fournisseurs	Zones
Mobile Money	Wave, Orange Money, MTN MoMo, Moov Money, Free Money, Airtel Money	UEMOA, CEMAC
Cartes Internationales	Visa, Mastercard, American Express	Mondial
Cartes Régionales	GIM-UEMOA	Zone UEMOA

Décaissements (Pay-out)

Corridor	Destinations	Devises
Mobile Money	14 pays UEMOA/CEMAC	XOF, XAF
SEPA	36 pays européens	EUR
USA	États-Unis	USD
Swift	180+ pays	Multi-devises

Couverture géographique

Zone UEMOA

Sénégal, Côte d'Ivoire, Mali, Burkina Faso, Togo, Bénin, Niger, Guinée-Bissau

Devise : XOF (Franc CFA BCEAO)

Zone CEMAC

Cameroun, Gabon, Congo, Tchad, RCA, Guinée Équatoriale

Devise : 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

Environnement	URL de base	Préfixe clés
Sandbox	https://sandbox-api.caurisflux.com/api/v1	pk_test_ / sk_test_
Production	https://prod-api.caurisflux.com/api/v1	pk_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

Voir le guide

Concepts clés

Transactions, statuts, webhooks et environnements

En savoir plus

Référence API

Spécifications techniques des endpoints

Explorer l'API

Webhooks

Notifications en temps réel

Configurer

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

• Documentation : docs.caurisflux.com
• Support technique : integration@caurisflux.com
• Statut des services : status.caurisflux.com