API Paiements

L'API Paiements gère les opérations de transferts monétaires aux bénéficiaires dans le cadre des cycles de paiement.

Vue d'ensemble

Endpoint	Méthode	Description
/api/paiements/by-beneficiaire	GET	Liste des paiements par bénéficiaire
/api/paiements/cycles	GET	Liste des cycles de paiement
/api/paiements/cycles	POST	Créer un nouveau cycle
/api/paiements/cycles/{id}/validate	POST	Valider un cycle
/api/paiements/cycles/{id}/paiements	GET	Liste des paiements d'un cycle
/api/paiements/cycles/{id}/execute	POST	Exécuter un cycle
/api/paiements/cycles/{id}/export-paiements-pdf	POST	Export PDF des paiements
/api/paiements/cycles/{id}/import-reconciliation	POST	Import réconciliation opérateur

Authentification

Tous les endpoints nécessitent une authentification JWT avec le header :

Authorization: Bearer <token>

Rôles requis

Endpoint	Rôle minimum
Liste paiements	ROLE_USER
Liste/Créer cycles	ROLE_TM_SPECIALIST
Valider cycle	ROLE_ADMIN
Exécuter cycle	ROLE_COORDINATEUR

Statuts des paiements

Statut	Description
brouillon	Paiement créé, non validé
en_attente	En attente de validation
valide_raf	Validé par le RAF
valide_coord	Validé par le Coordinateur
en_cours	Envoyé à l'opérateur
execute	Paiement réussi
echoue	Paiement échoué
rejete	Paiement rejeté
annule	Paiement annulé

Statuts des cycles

Statut	Description
preparation	Cycle en préparation
valide	Cycle validé
en_cours	Paiements en cours d'exécution
termine	Cycle terminé
archive	Cycle archivé