Lister les magasins
Retourne la liste des magasins pour l'entreprise authentifiée. **Pourquoi les magasins sont importants :** - Chez Jeko, les entreprises peuvent avoir plusieurs magasins (emplacements physiques, boutiques en ligne, etc.) - Toutes les opérations de paiement (demandes de paiement, liens de paiement) doivent être associées à un magasin spécifique - Chaque magasin a sa propre configuration, paramètres et historique de transactions - Les IDs de magasin sont requis pour créer des demandes de paiement et des liens de paiement **Cas d'usage :** - Obtenir les magasins disponibles avant de créer des opérations de paiement - Afficher les options de magasin dans l'interface de votre application - Valider les IDs de magasin avant d'effectuer des appels API de paiement **Authentification :** Nécessite les en-têtes de clé API.
Retourne la liste des magasins pour l'entreprise authentifiée.
Pourquoi les magasins sont importants :
- Chez Jeko, les entreprises peuvent avoir plusieurs magasins (emplacements physiques, boutiques en ligne, etc.)
- Toutes les opérations de paiement (demandes de paiement, liens de paiement) doivent être associées à un magasin spécifique
- Chaque magasin a sa propre configuration, paramètres et historique de transactions
- Les IDs de magasin sont requis pour créer des demandes de paiement et des liens de paiement
Cas d'usage :
- Obtenir les magasins disponibles avant de créer des opérations de paiement
- Afficher les options de magasin dans l'interface de votre application
- Valider les IDs de magasin avant d'effectuer des appels API de paiement
Authentification : Nécessite les en-têtes de clé API.
Clé API pour les requêtes de l'API Partenaire
In: header
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/partner_api/stores"[
{
"id": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
"name": "Laverie Jeko"
}
]{
"id": "unauthorized",
"message": "Unauthorized",
"extras": "Détails supplémentaires de l'erreur"
}{
"id": "forbidden_action",
"message": "Action interdite",
"extras": "Détails supplémentaires de l'erreur"
}{
"id": "internal_error",
"message": "Une erreur inattendue s'est produite",
"extras": "Détails supplémentaires de l'erreur"
}Obtenir un lien de paiement par ID GET
Récupère un lien de paiement par son ID avec le statut de disponibilité des paiements en temps réel. **Informations clés :** - Retourne la même structure que le point de terminaison de création - Le champ `canReceivePayments` reflète le statut actuel du lien - Utilisez ce point de terminaison pour vérifier si un lien peut accepter de nouveaux paiements avant de diriger les clients **Authentification :** - Nécessite les en-têtes de clé API `X-API-KEY` et `X-API-KEY-ID` **Contrôle d'accès :** - Ne retourne que les liens de paiement qui appartiennent à l'entreprise authentifiée **Cas d'usage :** - Vérifier la disponibilité du lien avant de le partager avec les clients - Vérifier le statut du lien de paiement dans votre application - Valider les liens à usage unique avant réutilisation
Obtenir le solde du magasin GET
Retourne le solde disponible total pour un magasin spécifique. Le solde représente la somme des soldes disponibles de tous les portefeuilles associés au magasin. **Informations sur le solde :** - Retourne le solde disponible total sur tous les portefeuilles pour le magasin - Solde disponible = solde total - solde bloqué - Le solde est retourné dans la devise du magasin - Le montant est en centimes (plus petite unité monétaire) **Cas d'usage :** - Vérifier le solde du magasin avant de créer des virements - Afficher les informations de solde dans les tableaux de bord - Surveiller le statut financier du magasin - Valider les fonds suffisants pour les opérations **Authentification :** Nécessite les en-têtes de clé API.