Lister les abonnements
Lister les abonnements
Aperçu
Lister les abonnements
Renvoie tous les abonnements de l'organisation du marchand authentifié. Les abonnements sont créés automatiquement lorsque les clients effectuent des paiements récurrents.
Quand utiliser cet endpoint
Utilisez cet endpoint quand vous devez exécuter GET /subscriptions (Lister les abonnements).
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 /subscriptions
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 |
|---|---|---|---|---|
pageSize | query | Non | — | Nombre d'éléments par page |
page | query | Non | — | Numéro de page |
Réponses
| Statut | Description |
|---|---|
200 | Liste des abonnements |
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/subscriptions?pageSize=1&page=1" \
-H "X-API-KEY: $LOMI_API_KEY"OpenAPI
- operationId:
SubscriptionsController_findAll - Operation:
GET /subscriptions
Schémas complets et Try it : référence API. Contrat machine : openapi.json à la racine des docs.