Lister les demandes de paiement
Lister les demandes de paiement
Aperçu
Lister les demandes de paiement
Renvoie toutes les demandes de l'organisation avec pagination et filtres optionnels (statut, client).
Quand utiliser cet endpoint
Utilisez cet endpoint quand vous devez exécuter GET /payment-requests (Lister les demandes de paiement).
Authentification
Les routes marchandes nécessitent une clé API dans l’en-tête X-API-KEY (voir Aperçu de l’intégration). Utilisez une clé test avec https://sandbox.api.lomi.africa et une clé live avec https://api.lomi.africa.
Point de terminaison
GET /payment-requests
URLs de base :
https://sandbox.api.lomi.africahttps://api.lomi.africa
Requête
Paramètres de chemin
Aucun paramètre de chemin au-delà du motif d’URL.
Paramètres de requête
| Nom | Emplacement | Obligatoire | Schéma | Description |
|---|---|---|---|---|
offset | query | Non | — | Décalage pour la pagination |
limit | query | Non | — | Nombre maximal de résultats |
customerId | query | Non | — | Filtrer par ID client |
status | query | Non | — | Filtrer par statut |
Réponses
| Statut | Description |
|---|---|
200 | Liste paginée de demandes |
401 | Clé API invalide ou manquante |
Erreurs
Les erreurs suivent le format JSON standard (code de statut et message lisible par machine). Validez les entrées avant appel ; 401 indique une clé manquante/invalide, 404 une ressource introuvable pour cette organisation, 429 une limitation de débit. Pour les retries sûrs sur les créations, envoyez une clé d’idempotence quand votre flux le permet.
Exemple
curl -sS -X GET "https://sandbox.api.lomi.africa/payment-requests?offset=1&limit=1" \
-H "X-API-KEY: $LOMI_API_KEY"OpenAPI
- operationId:
PaymentRequestsController_findAll - Operation:
GET /payment-requests
Schémas complets et Try it : référence API. Contrat machine : openapi.json à la racine des docs.