Glossaire

Vocabulaire métier et technique utilisé sur la plateforme Nex. Cette page est la source unique pour les définitions ; toute autre page qui utilise un de ces termes y renvoie.

Devises et zones monétaires

Terme	Définition
XAF	Franc CFA de la zone BEAC (CEMAC). Devise principale Nex.
XOF	Franc CFA de la zone BCEAO (UEMOA). Devise secondaire.
CEMAC	Communauté Économique et Monétaire de l’Afrique Centrale (Cameroun, Congo, Gabon, Guinée équatoriale, Tchad, RCA).
UEMOA	Union Économique et Monétaire Ouest-Africaine.
BEAC	Banque des États de l’Afrique Centrale (banque centrale CEMAC).
COBAC	Commission Bancaire de l’Afrique Centrale (régulateur prudentiel).
GABAC	Groupe d’Action contre le Blanchiment d’Argent en Afrique Centrale (FATF-style regional body).

Acteurs

Terme	Définition
Consumer	Utilisateur particulier de l’app Nex.
Agent	Utilisateur professionnel d’un point de distribution, opère via Nex Pro.
Master-agent	Agent superviseur d’un réseau d’agents (cf. docs master-agent).
Merchant (marchand)	Commerçant qui encaisse via Nex Business.
Merchant member	Utilisateur rattaché à un merchant avec un rôle (owner, admin, operator, cashier, accountant). Voir NEX-500.
POS	Point de vente d’un merchant. Une card est liée à un seul POS via UNIQUE PARTIAL.

Concepts transactionnels

Terme	Définition
Intent	Représentation canonique d’une transaction en cours. Cycle de vie pending → confirmed → completed (ou failed / pending_review). Voir /architecture/transactions.
Flow	Schéma config-driven qui décrit la séquence d’étapes d’un type de transaction (P2P, MERCHANT_PAY, CASH_IN, CASH_OUT, etc.). Voir /architecture/transaction-flows-config-driven.
Ledger entity	Couple (entity_id, entity_type) qui identifie un détenteur de wallet dans le ledger. Convention : agent simple = (userId, 'user'), master-agent = (organizationId, 'corporate').
Wallet	Compte ledger interne associé à une ledger entity.
Preflight risk	Évaluation anti-fraude exécutée avant la confirmation d’un intent (cf. /services/risk-engine/preflight).
Card number (merchant)	Identifiant 8 caractères imprimé sur la carte physique marchand. L’utilisateur tape 6 chiffres ; le serveur préfixe avec MERCHANT_CARD_PREFIX (default 63).

Concepts d’authentification

Terme	Définition
PIN	Code numérique à 4-6 chiffres choisi par l’utilisateur. Hash bcrypt côté serveur, PBKDF2-SHA256 pour la vérification offline mobile.
OTP	One-Time Password à 6 chiffres envoyé par SMS pour vérifier un numéro de téléphone.
Firebase custom token	Token Firebase signé par le service auth, envoyé en Authorization: Bearer aux services downstream.
Device key (QR)	Clé AES-256 par appareil, utilisée pour signer les tokens QR. Voir /security/qr-code.
Biometric lock	Verrouillage local mobile par empreinte ou Face ID, géré par @nex/mobile-auth.

Concepts d’infrastructure

Terme	Définition
Orchestrator	Microservice central qui route les requêtes mobile/web vers les services backend. Voir /services/orchestrator/overview.
Review env	Environnement éphémère par MR, déployé via Docker Compose sur VM dédiée.
Doppler	Source de vérité des secrets ; synchronisé en K8s via External Secrets Operator.
Cluster nex-staging	Cluster EKS staging, namespace nex-staging, ingress dev.paywithnex.com.

Concepts compliance

Terme	Définition
KYC	Know Your Customer — vérification d’identité d’une personne physique.
KYB	Know Your Business — vérification d’une entité morale (un merchant).
AML / CFT	Anti-Money Laundering / Counter-Financing of Terrorism.
PEP	Politically Exposed Person — soumis à due diligence renforcée.
SAR	Suspicious Activity Report — déclaration de soupçon au régulateur.
Maker-checker	Séparation des tâches : l’initiateur d’une action ne peut pas être celui qui la valide.
Cantonnement (safeguarding)	Ségrégation des fonds clients sur un compte bancaire dédié.