A
API (Application Programming Interface)
Interface permettant à deux systèmes de communiquer. L’API CaurisFlux permet à votre application d’initier des paiements, de recevoir des notifications et de consulter des transactions.API Key (Clé API)
Identifiant secret utilisé pour authentifier les requêtes vers l’API. CaurisFlux utilise deux types de clés :- Clé publique (
pk_*) : Pour les opérations côté client - Clé secrète (
sk_*) : Pour les opérations côté serveur (à ne jamais exposer)
C
Checkout
Page de paiement hébergée par CaurisFlux où le client finalise son paiement. Accessible via l’URLcheckout_url retournée lors de l’initiation d’un paiement.
E
E.164
Format international des numéros de téléphone. Exemple :+221771234567 (indicatif pays + numéro local, sans espaces ni tirets).
I
Idempotence
Propriété d’une opération qui produit le même résultat lorsqu’elle est exécutée plusieurs fois. En utilisant une clé d’idempotence (Idempotency-Key), vous évitez de créer des doublons lors de retries.
K
KYC (Know Your Customer)
Processus de vérification d’identité requis pour accéder aux fonctionnalités de production. Vous devez soumettre des documents d’entreprise avant de pouvoir effectuer des transactions réelles.M
Merchant Reference
Identifiant que vous attribuez à une transaction pour la lier à votre système interne (numéro de commande, identifiant client, etc.). Cet identifiant est retourné dans les webhooks.Metadata
Données personnalisées au format JSON que vous pouvez attacher à une transaction. Elles sont stockées et retournées dans les webhooks sans être modifiées par CaurisFlux.Mobile Money
Service de paiement mobile permettant d’effectuer des transactions financières via un téléphone mobile. Exemples : Wave, Orange Money, MTN Mobile Money.N
P
Payout (Virement)
Transaction sortante : transfert de fonds de votre compte CaurisFlux vers un compte Mobile Money externe. Utilisé pour les remboursements, paiements de fournisseurs, etc.Payment (Paiement)
Transaction entrante : votre client vous verse de l’argent via Mobile Money ou carte bancaire. Les fonds sont crédités sur votre compte CaurisFlux.Pending (En attente)
Statut d’une transaction qui a été initiée mais n’est pas encore finalisée. Le client n’a pas encore confirmé le paiement.Provider (Fournisseur)
Opérateur de paiement mobile (Wave, Orange Money, MTN, etc.) ou réseau de cartes (Visa, Mastercard). CaurisFlux agrège plusieurs providers via une API unifiée.R
Rate Limiting
Mécanisme limitant le nombre de requêtes API par unité de temps pour protéger le service. Quand la limite est atteinte, l’API retourne une erreur 429.Refund (Remboursement)
Annulation partielle ou totale d’une transaction réussie. Les fonds sont retournés au client via le même moyen de paiement utilisé initialement.S
Sandbox
Environnement de test isolé permettant de développer et tester votre intégration sans effectuer de transactions réelles. Utilise des clés API distinctes (sk_test_*).
Secret Key (Clé secrète)
Clé API permettant d’effectuer toutes les opérations sur votre compte. Doit être conservée côté serveur et ne jamais être exposée côté client ou dans le code source public.Signature
Hash cryptographique (HMAC-SHA256) permettant de vérifier l’authenticité et l’intégrité d’un webhook. Calculé à partir du payload et de votre webhook secret.Status (Statut)
État actuel d’une transaction. Les statuts possibles sont :pending: En attente de confirmationprocessing: En cours de traitementsuccess: Réussiefailed: Échouéecancelled: Annuléeexpired: Expirée
T
Transaction
Opération financière enregistrée dans le système. Peut être un paiement (entrée de fonds), un virement (sortie de fonds) ou un remboursement.Transaction ID
Identifiant unique attribué par CaurisFlux à chaque transaction. Format :TRX_XXXXXXXXXXX. Utilisé pour le suivi, la réconciliation et les demandes de support.
U
USSD
Protocole de communication GSM permettant d’interagir avec un service via des codes courts (ex:*123#). Certains providers Mobile Money utilisent USSD pour la validation des paiements.