> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jeko.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestion des magasins

> Comprendre le rôle central des magasins dans l'écosystème JEKO et leur gestion

## Les magasins : éléments clés de l'écosystème JEKO

Les **magasins (stores)** sont des éléments fondamentaux de l'écosystème JEKO. Ils représentent les points de vente ou canaux de distribution d'une entreprise et servent de point central pour toutes les opérations financières.

### Concept de magasin

Dans l'écosystème JEKO, une **entreprise peut posséder plusieurs magasins**. Chaque magasin peut représenter :

* Un emplacement physique (boutique, restaurant, etc.)
* Une boutique en ligne
* Un canal de vente spécifique
* Toute autre entité commerciale distincte

### Rôle central dans les opérations financières

**Toutes les actions financières sont liées à un magasin** :

* **Pay-in (paiements entrants)** : Tous les paiements reçus sont crédités sur le compte du magasin associé
* **Pay-out (transferts sortants)** : Tous les transferts effectués sont débités du compte du magasin associé

Cela signifie que chaque transaction financière (paiement ou transfert) doit obligatoirement être associée à un magasin spécifique via son identifiant (`storeId`).

## Comptes des magasins

Chaque magasin possède **un compte unifié** qui peut gérer à la fois les opérations de pay-in et de pay-out :

* **Pay-in** : Le compte est crédité automatiquement lors des paiements réussis (paiements en magasin via Soundbox, liens de paiement, paiements en ligne)
* **Pay-out** : Le compte est débité automatiquement lors des transferts réussis vers des bénéficiaires

**Important** : Le compte du magasin doit être provisionné au préalable pour pouvoir effectuer des transferts (pay-out). Les fonds collectés via les pay-in peuvent être utilisés directement pour les pay-out.

## Gestion des magasins

### Caractéristiques d'un magasin

Chaque magasin dispose de :

* Sa propre configuration et paramètres
* Son historique de transactions indépendant
* Son compte unifié (gérant à la fois pay-in et pay-out)
* Son identifiant unique (`storeId`)

### Utilisation des magasins dans l'API

Les identifiants de magasin (`storeId`) sont **obligatoires** pour :

* Créer des demandes de paiement (`payment_requests`)
* Générer des liens de paiement (`payment_links`)
* Effectuer des transferts (`transfers`)
* Consulter les soldes et l'historique des transactions

## Opérations sur les magasins

### Récupérer la liste des magasins

Avant d'effectuer toute opération financière, vous devez récupérer la liste des magasins disponibles pour votre entreprise :

```bash theme={null}
curl -X GET "https://api.jeko.africa/partner_api/stores" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-KEY-ID: your_api_key_id_here"
```

**Réponse** : Liste de tous les magasins avec leurs identifiants, noms et configurations.

### Consulter le solde d'un magasin

Pour vérifier le solde disponible d'un magasin spécifique :

```bash theme={null}
curl -X GET "https://api.jeko.africa/partner_api/stores/{storeId}/balance" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-KEY-ID: your_api_key_id_here"
```

**Note** : Le solde retourné représente la somme des soldes disponibles de tous les portefeuilles associés au magasin.

## Bonnes pratiques

1. **Récupérer les magasins au démarrage** : Listez les magasins disponibles dès l'initialisation de votre intégration
2. **Valider les storeId** : Vérifiez que le `storeId` utilisé existe avant de créer des transactions
3. **Gérer plusieurs magasins** : Si votre entreprise a plusieurs magasins, assurez-vous de sélectionner le bon magasin pour chaque transaction
4. **Surveiller les soldes** : Consultez régulièrement les soldes des magasins pour garantir la disponibilité des fonds nécessaires pour les transferts