Passer au contenu principal
Ce guide vous accompagne dans une vérification KYB complète en moins de 10 minutes. Vous allez créer un workflow, démarrer une session, transmettre le lien de vérification hébergé à votre contact dans l’entreprise, attendre le webhook et récupérer la décision finale.

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)
Enregistrez et copiez le workflow_id, que vous utiliserez à l’étape suivante.
2

Créer une session de vérification d'entreprise (KYB) via l'API

La réponse contient 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.
La décision comprend les données du registre, les personnes clés (UBO, actionnaires, dirigeants et représentants), les correspondances AML, les documents et les résultats par fonctionnalité. Consultez le schéma de réponse pour la référence complète du payload.
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 dans warnings[] 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.
Dernière modification le 7 novembre 2026