Prérequis
- Une application Didit avec KYB activé. Créez-en une sur business.didit.me si nécessaire.
- Une clé API issue de Developer Settings → API Keys.
- Un endpoint de webhook accessible depuis Internet (pour le webhook de décision).
Étapes
1
Créer un workflow KYB dans la console
Rendez-vous dans Workflows → Create workflow. Choisissez Vérification d’entreprise comme type de workflow.Activez les fonctionnalités dont vous avez besoin :
- Consultation du registre des sociétés (obligatoire)
- AML de l’entreprise (recommandé)
- Personnes clés (obligatoire pour la plupart des secteurs réglementés)
- Documents (facultatif : choisissez les types de documents que vous exigerez)
workflow_id, que vous utiliserez à l’étape suivante.2
Créer une session de vérification d'entreprise (KYB) via l'API
session_id, session_number et url, c’est-à-dire le lien de vérification hébergé que vous transmettez au contact de l’entreprise. Le type de workflow (KYB) identifie automatiquement la session comme une session d’entreprise.3
Envoyer le lien à votre contact dans l'entreprise
Transmettez le
url à l’administrateur de l’entreprise par votre propre e-mail ou messagerie. Il l’ouvre, complète les données du registre, ajoute les personnes clés et les UBO, puis téléverse les documents.Vous pouvez personnaliser l’expérience hébergée avec votre identité visuelle, votre logo et votre domaine. Voir Marque blanche.4
Recevoir le webhook de statut
Lorsque l’entreprise termine le parcours et que le traitement KYB atteint un statut final, Didit envoie une requête POST avec un événement
status.updated à votre endpoint de webhook. Les événements de session d’entreprise contiennent session_kind: "business" dans data. Filtrez sur ce champ pour acheminer l’événement vers votre gestionnaire KYB.Vérifiez la signature HMAC X-Signature-V2 avant de faire confiance à l’événement (voir webhooks), puis déclenchez votre logique aval. Stockez le secret_shared_key de la destination (renvoyé lors de l’enregistrement du webhook) sous le nom DIDIT_WEBHOOK_SECRET dans votre fichier .env.Exemple de payload :5
Récupérer la décision (facultatif)
Le payload du webhook
status.updated contient déjà la décision complète. Vous n’avez besoin d’appeler cet endpoint que si vous ne vous êtes pas abonné aux webhooks, ou si vous souhaitez récupérer la décision plus tard à la demande.6
Agir selon la décision
Selon la valeur de
status :"Approved": intégrez l’entreprise."Declined": rejetez la demande et consignez les étiquettes contenues danswarnings[]de la décision."In Review": attendez la décision de l’analyste ; vous recevrez un nouveau webhook lorsqu’elle sera rendue.
Exemple Node.js
Ce qui se passe automatiquement
- Consultation du registre des sociétés dans 190+ juridictions.
- Extraction des UBO et des dirigeants à partir des données du registre.
- Filtrage AML au niveau de l’entreprise (sanctions, PEP, presse négative).
- Filtrage AML au niveau de chaque personne identifiée.
- OCR des documents et recoupement des informations.
- Création et agrégation du profil d’entreprise, indexées par
vendor_data.
Étapes suivantes
Guide d'intégration
Architecture de bout en bout, interrogation périodique ou webhooks, logique de nouvelle tentative.
Webhooks KYB
Tous les événements KYB et la structure de leurs payloads.
Statuts
Référence des statuts de session, de fonctionnalité et de registre.
Schéma de réponse
Le payload complet de la décision KYB.
Entités d'entreprise
Comment les profils s’agrègent d’une session à l’autre.