Aller au contenu principal

Liste des paiements par bénéficiaire

Récupère l'historique des paiements pour un bénéficiaire spécifique.

Endpoint

GET /api/paiements/by-beneficiaire

Paramètres de requête

ParamètreTypeRequisDescription
beneficiaire.idUUIDOuiID du bénéficiaire
pageintNonNuméro de page (défaut: 1)
limitintNonNombre par page (défaut: 20, max: 100)

Exemple de requête

curl -X GET "https://api.pch-sig.org/api/paiements/by-beneficiaire?beneficiaire.id=550e8400-e29b-41d4-a716-446655440000&page=1&limit=10" \
-H "Authorization: Bearer <token>"

Réponse

{
"success": true,
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"montant": 25000,
"statut": "execute",
"methodePaiement": "mobile_money",
"datePaiement": "2025-03-15",
"referenceTransaction": "TXN-2025-001234",
"cycle": {
"id": "550e8400-e29b-41d4-a716-446655440002",
"nom": "Cycle Mars 2025"
},
"beneficiaire": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"nomComplet": "Mamadou Diallo"
}
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 45,
"pages": 5
}
}

Codes de réponse

CodeDescription
200Succès
401Non authentifié
500Erreur serveur