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.Kelyko.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. Quand ce statut devient succeeded ou failed pour un marchand rattaché, Kelyko envoie aussi COMPLIANCE_VERIFICATION_COMPLETED. Le corps est dans Événements. L'abonnement se crée dans Webhooks marchand.
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.kelyko.invalid/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.
Point d’attention.
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 plateforme, 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 plateforme |
| — | 404 | Vérification introuvable, ou elle appartient à un autre plateforme |
Ensuite, créez la clé plateforme.