Conformité

Après l'onboarding ou un rattachement, démarrez la vérification d'identité (KYC) puis, plus tard, la vérification entreprise (KYB). L'API renvoie une URL hébergée sur business.jeko.africa. Ce n'est pas une URL Danaya. Ouvrez cette page dans le navigateur du marchand (WebView, onglet, SMS).

Le statut terminal se suit par sondage GET. L'événement webhook COMPLIANCE_VERIFICATION_COMPLETED est un filtre d'abonnement valide, mais sa délivrance n'est pas encore en production.

Créer ou reprendre une vérification

POST /partner_api/service_providers/compliance_verifications

Requête :

{
  "type": "kyc",
  "merchantBusinessId": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
  "callbackUrl": "https://partner.example/return"
}

type vaut kyc ou kyb. callbackUrl est optionnel. S'il est présent, il doit être en https.

Réponse : 201 pour une nouvelle ligne, 200 si une vérification du même type est déjà pending ou submitted.

{
  "id": "fc86b752-c92e-44cb-a1c5-73d5ec256982",
  "type": "kyc",
  "status": "pending",
  "merchantBusinessId": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
  "url": "https://business.jeko.africa/compliance-verifications/fc86b752-c92e-44cb-a1c5-73d5ec256982",
  "callbackUrl": "https://partner.example/return"
}

Un second POST pendant qu'une ligne est ouverte renvoie la même ressource (200). callbackUrl n'est pas mis à jour.

La réponse Partner n'inclut jamais providerUrl ni expiresAt. L'URL Danaya n'existe que sur le GET public consommé par la page hébergée.

Suivre le statut

GET /partner_api/service_providers/compliance_verifications/{id}

Le GET renvoie le même corps. status passe de pending à submitted, puis à succeeded ou failed. Un id inconnu, ou une vérification d'un autre Service Provider, renvoie 404.

type: kyb n'est accepté qu'après un KYC succeeded.

`id` d'erreur	HTTP	Signification
`compliance_level_0_incomplete`	409	Les champs niveau 0 (owner et business) sont incomplets. Relancez l'onboarding avec tous les champs, ou complétez-les dans l'app
`kyc_required`	409	`type: kyb` avant un KYC `succeeded`
—	401	Marchand non rattaché à votre Service Provider
—	404	Vérification introuvable, ou elle appartient à un autre Service Provider

Ensuite, créez la clé plateforme.

Créer ou reprendre une vérification

Suivre le statut

On this page