Erreurs

Les pages de chaque parcours détaillent le moment où le code apparaît. Ce tableau les regroupe.

`id`	HTTP	Quand
`phone_already_in_use`	409	Onboarding : le téléphone a déjà un compte. Enchaînez avec un rattachement
`user_not_found`	404	Rattachement : aucun utilisateur pour ce téléphone. Utilisez l'onboarding
`no_owned_business`	409	L'utilisateur existe mais n'est Owner d'aucune entreprise
`already_linked`	409	Rattachement déjà en place. `extras` contient le `merchantBusinessId`
`not_linked`	404	Détachement, ou assignation de catalogue, sans rattachement live
`compliance_level_0_incomplete`	409	KYC alors que les champs niveau 0 sont incomplets
`kyc_required`	409	KYB avant un KYC `succeeded`
`fee_catalog_not_found`	404	Catalogue absent, qui ne vous appartient pas, ou supprimé
`fee_catalog_assignment_not_found`	404	Aucun catalogue assigné à retirer
`fee_catalog_still_assigned`	409	Suppression tableau de bord d'un catalogue encore assigné
`max_webhook_subscriptions_reached`	409	Un abonnement webhook actif existe déjà sur votre magasin dédié
`forbidden_action`	403	`storeId` d'un autre magasin avec une clé plateforme

Sans id dédié :

401 sur une vérification de conformité : le marchand n'est pas rattaché à votre Service Provider. Après un détachement, les clés plateforme que vous aviez créées répondent aussi 401.
403 à la création de clé : le merchantBusinessId n'est pas un marchand que vous avez intégré ou rattaché.
404 sur une vérification, une demande de rattachement ou un abonnement webhook : ressource inconnue, ou elle appartient à un autre Service Provider.
422 : valeur hors des données de référence, fourchette de revenu inversée, ou URL de webhook qui n'est pas en https.

Limitation de débit

Pour garantir la stabilité et la disponibilité de l'API, Jèko applique des limites de débit au niveau applicatif.

Les limites sont appliquées par entreprise, et non par clé API. La création de plusieurs clés API ne permet pas de contourner les limites.

Type de limite	Quota	Fenêtre de temps
Limite standard	500 requêtes	par minute
Limite burst	1 000 requêtes	par 5 minutes

En cas de dépassement, l'entreprise est bloquée 10 à 15 minutes. Pendant le blocage, les requêtes reçoivent 429 Too Many Requests.

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please retry after some time."
}

async function makeRequestWithRetry(url, options, maxRetries = 5) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const waitTime = Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, waitTime));
      continue;
    }

    return response;
  }

  throw new Error('Nombre maximum de tentatives dépassé');
}

Si vous avez besoin de limites plus élevées, contactez hello@jeko.africa.

Limitation de débit

On this page