Authentification

Toutes les requêtes API nécessitent une authentification à l'aide de clés API. Vous devez inclure deux en-têtes avec chaque requête :

X-API-KEY : Votre clé API
X-API-KEY-ID : L'identifiant de votre clé API

Obtenir les clés API

Pour obtenir votre clé API et votre identifiant de clé API :

Connectez-vous au Dashboard Business à https://business.jeko.africa/
Naviguez vers Paramètres > API & Webhooks
Générez ou copiez vos identifiants API depuis cette section

Activer l'accès API

Générer vos clés ne suffit pas. L'accès à l'API est une étape à part, et tant qu'elle n'est pas faite vos appels sont rejetés, même avec des clés valides :

{
  "id": "business_not_enabled_for_api_access",
  "message": "This business account is not enabled for API access"
}

Le statut est 403. Un 401 voudrait dire que vos clés ou vos en-têtes sont en cause.

Avoir des clés ne veut pas dire avoir l'accès. Si votre premier appel répond 403 alors que vos en-têtes sont bons, c'est presque toujours ça.

Pour l'activer, faites vérifier votre boutique depuis l'application Jèko Business :

Ouvrez l'onglet Paramètres
Touchez l'encart qui affiche votre plafond de collecte, en haut de l'écran
Suivez le parcours de vérification

Le premier niveau suffit : dès qu'il est franchi, l'accès API est activé. Relancez votre appel, il passe. Aucune demande au support n'est nécessaire.

Si votre entreprise a été intégrée par un Service Provider, c'est déjà fait : l'accès API a été activé lors de votre intégration.

En cas de blocage, écrivez à hello@jeko.africa ou passez par le tchat sur jeko.africa.

Les plafonds de collecte

La vérification se fait par niveaux, et chaque niveau relève le montant que vous pouvez encaisser. Ce plafond est visible sur l'accueil de l'application et dans les paramètres de la boutique.

Ces plafonds valent aussi pour vos appels API. Une transaction refusée pour dépassement n'a rien à voir avec vos clés : montez d'un niveau de vérification pour relever la limite.

Exemple de requête

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"

Erreurs d'authentification

401 Unauthorized : Clé API invalide ou manquante
403 Forbidden : La clé API n'a pas la permission d'accéder à la ressource demandée
403 avec "id": "business_not_enabled_for_api_access" : les clés sont valides, mais l'accès API de votre entreprise n'est pas encore activé. Voir la section Activer l'accès API plus haut

Authentification