Intégrer une nouvelle entreprise (API Fournisseur de services)

curl --request POST \
  --url https://api.jeko.africa/partner_api/service_providers/business_onboarding \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "owner": {
    "phone": "+22507012345",
    "firstName": "Jean",
    "lastName": "Dupont",
    "sex": "M"
  },
  "business": {
    "name": "Magasin de Jean",
    "category": "retail",
    "categoryActivity": "home_appliances",
    "city": "abidjan",
    "municipality": "cocody",
    "estimatedRevenueLow": 2400000,
    "estimatedRevenueHigh": 5000000
  }
}
'

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

Fournisseurs de services

Intégrer une nouvelle entreprise (API Fournisseur de services)

Intègre une nouvelle entreprise marchande au nom d’un fournisseur de services. Ce point de terminaison crée un nouvel utilisateur, une nouvelle entreprise et établit la relation de fournisseur de services.

Cas d’usage :

Les fournisseurs de services (comme Payme) peuvent intégrer des marchands via leur propre plateforme
Automatise le processus d’enregistrement des entreprises
Établit automatiquement la relation de fournisseur de services

Ce que fait ce point de terminaison :

Crée un nouveau compte utilisateur (si le numéro de téléphone n’existe pas)
Crée une nouvelle entreprise avec les informations fournies
Configure la configuration de l’entreprise (active l’accès API)
Crée un membre d’entreprise de fournisseur de services liant le fournisseur de services au marchand
Définit le code de parrainage si fourni

Notes importantes :

L’entreprise authentifiée doit être un fournisseur de services (vérifié via middleware)
Le numéro de téléphone doit être unique - si un utilisateur avec ce téléphone existe déjà, une erreur est retournée
L’entreprise de fournisseur de services est automatiquement liée à l’entreprise marchande
L’accès API est automatiquement activé pour la nouvelle entreprise marchande

Authentification : Nécessite les en-têtes de clé API. L’entreprise authentifiée doit être un fournisseur de services.

POST

partner_api

service_providers

business_onboarding

Intégrer une nouvelle entreprise (API Fournisseur de services)

curl --request POST \
  --url https://api.jeko.africa/partner_api/service_providers/business_onboarding \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "owner": {
    "phone": "+22507012345",
    "firstName": "Jean",
    "lastName": "Dupont",
    "sex": "M"
  },
  "business": {
    "name": "Magasin de Jean",
    "category": "retail",
    "categoryActivity": "home_appliances",
    "city": "abidjan",
    "municipality": "cocody",
    "estimatedRevenueLow": 2400000,
    "estimatedRevenueHigh": 5000000
  }
}
'

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

Authorizations

X-API-KEY

string

header

required

Clé API pour les requêtes de l'API Partenaire

Body

application/json

Schéma de requête pour l'intégration d'une nouvelle entreprise

owner

object

required

Informations sur le propriétaire (utilisateur)

Show child attributes

business

object

required

Informations sur l'entreprise

Show child attributes

Response

Entreprise intégrée avec succès

Schéma de réponse pour l'intégration d'entreprise

business

object

required

Informations sur l'entreprise créée

Show child attributes

serviceProviderMemberId

string<uuid>

required

Identifiant du membre d'entreprise de fournisseur de services liant le fournisseur de services au marchand

Example:

"29f81706-03a6-492f-92ee-5f0b2e9b18e7"

Lister les activités commerciales (API Fournisseur de services)

Créer une clé API pour une entreprise marchande (API Fournisseur de services)