Subventions - batch disbursement

Régie paie un lot de bénéficiaires (subventions, indemnités) via Epayment ; lignes chargées depuis l'ERP.

Acteurs

Acteur	Rôle
ERP métier	Prépare le lot (batch_ref, lignes bénéficiaires)
Officer régie	Crée le batch, lance exécution
Approbateurs régie	Circuit de validation (1 à N niveaux)
Epayment	Pull lignes, orchestration des versements
PSP disburse	Mobile money ou autres canaux payout

Prérequis

• Capacité bulk disbursement activée.
• ERP expose GET /disbursements?batch_ref= ou procédure CSV documentée.
• Credentials ERP et mapping chemins configurés.
• Comptes approbateurs et règles de validation définis.
• Connecteur disburse opérationnel (sandbox puis live).

Séquence

Étapes métier

1. ERP prépare lot avec batch_ref stable.
2. Officer régie : créer batch source erp_fetch, référence = batch_ref ERP.
3. Epayment : GET /disbursements?batch_ref= sur ERP.
4. Preview lignes, circuit validation.
5. Exécution : versement ligne par ligne.
6. Rapport : succès, échecs, retry unitaire.
7. Export compta / rapprochement Trésor.

ERP minimum

GET /disbursements?batch_ref=SUB-2026-Q1

{
  "items": [
    {
      "line_ref": "LINE-0001",
      "beneficiary_ref": "BEN-8842",
      "beneficiary_name": "Marie Nguema",
      "amount_minor": 75000,
      "currency": "XAF",
      "payment_method": "MOBILE_MONEY",
      "payout": { "phone_e164": "+242061234567" }
    }
  ]
}

Alternative

Upload CSV ou Excel si l'ERP ne expose pas encore GET disbursements. Même workflow validation et exécution.

Chemins d'échec

Scénario	Signal	Action
batch_ref déjà importé	disbursement.reference_taken	Utiliser référence ERP distincte ou clôturer batch existant
Ligne PSP en échec	Statut ligne failed dans rapport Epayment	Retry unitaire ; pas de double paiement sur line_ref déjà succeeded
Transition batch invalide	disbursement.invalid_transition, disbursement.concurrent_state_change	Rafraîchir état batch ; respecter ordre validation → exécution

Critères d'acceptation

• [ ] Pull ERP retourne lignes conformes au schéma (line_ref, amount_minor, payout).
• [ ] Circuit approbation bloque exécution tant que non approuvé.
• [ ] Lignes succeeded traçables par line_ref et beneficiary_ref.
• [ ] Échec PSP isolé sur la ligne ; lot continue sur les autres lignes.
• [ ] disbursement.reference_taken empêche double import du même batch_ref.

Références

• Paiements en masse
• Contrat REST
• Recette ERP