Positionnement

Epayment est l'orchestrateur de paiement du DPI partagé. Il émet des sessions de paiement, route les initiations vers les connecteurs adaptés, journalise les constatations et notifie les SI métiers. Les fonds ne transitent pas par la plateforme.

Orchestrateur, pas prestataire de services de paiement

Rôle	Epayment	Prestataire (PSP, opérateur MM, agence)
Création de session et avis	Oui	Non
Collecte du numéro de téléphone ou choix du canal	Non	Oui (checkout citoyen)
Détention ou transit des fonds	Non	Oui (compte marchand, compte État)
Signature HMAC des webhooks	Oui	Non
Calcul du montant dû métier	Non (reste dans le SI)	Non
Imputation budgétaire	Non	Non (Trésor, comptable public)

Epayment n'est ni établissement de paiement, ni agrégateur financier. Il constitue un registre d'orchestration et de constatation entre les SI métiers, le checkout citoyen et les connecteurs de paiement.

Périmètre fonctionnel

Dans le périmètre	Hors périmètre
POST /checkout/sessions (hosted, embed)	Appel direct à un PSP (MTN, Airtel, GIMAC)
Checkout citoyen (mobile money, carte, agence)	Collecte de données de paiement côté ministry
Émission de payment_ref pour paiement en agence	Décision d'engager un décaissement
Webhooks signés (checkout.completed, etc.)	Tenue du compte marchand ou de collecte
verify-completion (mode embed)	Compensation interbancaire
Tirage des créances ERP (portail citoyen)	Calcul de l'assiette fiscale
Confirmation de paiement vers l'ERP (POST /payment-confirmations)	Émission de monnaie électronique
Paiements en masse (disbursement) initiés par la régie	Stockage de données carte (PCI DSS)
Journal des communications externes	Comptabilité publique

Flux des fonds

Les fonds circulent entre l'usager, le prestataire de paiement et le compte de l'État. Epayment n'apparaît sur aucun segment financier : il échange des messages et produit des preuves.

Les traits épais matérialisent les flux financiers. Les flux d'information (sessions, webhooks, confirmations ERP) passent par Epayment sans mouvement de fonds.

Implications pour l'intégration

Responsabilité intégrateur	Responsabilité Epayment
Fournir order_id, montant, métadonnées métier	Orchestrer le checkout et les connecteurs
Exposer un endpoint webhook HTTPS	Signer et livrer les événements
Débloquer le dossier sur confirmation serveur	Émettre payment_ref et constater le paiement
Exposer l'ERP REST (régie) si portail citoyen	Tirer les créances et pousser les confirmations
Configurer les origines embed autorisées	Valider le parent iframe et le client_secret