Intégrer un marchand

business_onboarding ne crée que de nouveaux comptes. Si le téléphone appartient déjà à un utilisateur Jèko, la réponse est 409 phone_already_in_use : ouvrez une demande de rattachement.

Authentifiez-vous avec la clé de votre entreprise Service Provider. Voir Service Providers.

Données de référence

Avant d'intégrer un marchand, récupérez les valeurs acceptées :

• Localisations : GET /partner_api/service_providers/locations
  • Retourne les villes et municipalités disponibles, chacune avec un id et un name
  • Envoyez l'id dans business.city et business.municipality. La municipalité doit appartenir à la ville.
• Activités : GET /partner_api/service_providers/activities
  • Retourne les catégories et activités commerciales activées
  • Support multilingue via l'en-tête Accept-Language (fr par défaut, ou en)
  • Envoyez l'id dans business.category et business.categoryActivity. L'activité doit appartenir à la catégorie.

owner.city et owner.municipality décrivent l'adresse du propriétaire : c'est du texte libre, non vérifié contre le référentiel. Vous pouvez y mettre le name de la ville et de la municipalité, comme dans l'exemple ci-dessous.

Créer le marchand

POST /partner_api/service_providers/business_onboarding

L'appel crée l'utilisateur (si le numéro n'existe pas), l'entreprise, la configuration (accès API activé) et le membre Service Provider qui vous lie au marchand.

Requête :

{
  "owner": {
    "phone": "+22507012345",
    "firstName": "Jean",
    "lastName": "Dupont",
    "sex": "M",
    "birthDate": "1990-01-15",
    "birthPlace": "Abidjan",
    "nationality": "CIV",
    "countryOfResidence": "CIV",
    "city": "Abidjan",
    "municipality": "Cocody",
    "address": "123 Rue Principale"
  },
  "business": {
    "name": "Magasin de Jean",
    "category": "retail",
    "categoryActivity": "home_appliances",
    "address": "123 Rue Principale",
    "city": "abidjan",
    "municipality": "cocody",
    "estimatedRevenueLow": 2400000,
    "estimatedRevenueHigh": 5000000
  }
}

Réponse (201) :

{
  "business": {
    "id": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
    "name": "Magasin de Jean",
    "reference": "BIZ-2024-001"
  },
  "serviceProviderMemberId": "29f81706-03a6-492f-92ee-5f0b2e9b18e7"
}

Stockez business.id : c'est le merchantBusinessId des appels suivants.

Exemple

async function onboardMerchant(merchantData) {
  const response = await fetch('https://api.jeko.africa/partner_api/service_providers/business_onboarding', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-KEY': process.env.SERVICE_PROVIDER_API_KEY,
      'X-API-KEY-ID': process.env.SERVICE_PROVIDER_API_KEY_ID,
    },
    body: JSON.stringify(merchantData),
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`Échec de l'intégration : ${JSON.stringify(error)}`);
  }

  return await response.json();
}