API de vérification d'entreprise (KYB) : registre et UBO

La Vérification d’entreprise (KYB) de Didit vous permet de vérifier des entreprises et des entités juridiques avant de les intégrer à votre plateforme. Le système automatise la consultation des registres des sociétés, identifie les bénéficiaires effectifs et les dirigeants, contrôle toutes les parties au regard des listes de surveillance AML et collecte les documents justificatifs, le tout au sein d’un seul workflow. Chaque entreprise vérifiée est suivie sous la forme d’un profil d’entreprise, qui regroupe les résultats de toutes les sessions. Cette leçon de Didit Academy suit une vérification d’entreprise du début à la fin : le tableau de bord KYB, la vérification au registre, les actionnaires et les UBO, le filtrage AML, et ce que voit le représentant de l’entreprise de son côté. Nouveau sur la KYB de Didit ? Commencez par le démarrage rapide pour un parcours complet en 10 minutes, puis lisez le guide d’intégration pour les schémas de mise en production. Pour le modèle d’entité Business sous-jacent (liens avec les utilisateurs, listes de blocage, import et export), consultez Entreprises.

Fonctionnement

Créer une session d'entreprise

Lancez une vérification d’entreprise en créant une session avec un workflow KYB. Lorsque le type de workflow est KYB, Didit crée automatiquement une session d’entreprise :

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your-kyb-workflow-id",
    "vendor_data": "company-123"
  }'

Le type de session est déterminé par le workflow, sans champ supplémentaire à renseigner. Les workflows KYB créent automatiquement des sessions d’entreprise avec les fonctionnalités propres aux entreprises activées.

Consultation du registre des sociétés

Didit interroge les registres officiels des sociétés aux niveaux Lite, Shareholders ou UBOs, chacun facturé selon le pays. Consultez les tarifs des registres. Le niveau Lite récupère :

Donnée	Description
Nom de l’entreprise	Raison sociale telle qu’enregistrée
Numéro d’immatriculation	Numéro officiel d’immatriculation de l’entreprise
Pays	Pays de constitution
Statut	Actif, dissous, radié, etc.
Type d’entreprise	Ltd, LLC, PLC, SA, GmbH, etc.
Date de constitution	Date d’enregistrement de l’entreprise
Adresse officielle du siège social	Adresse officielle du siège social
Identifiant fiscal	Numéro d’identification fiscale (lorsqu’il est disponible)

Les données du registre sont recoupées avec les informations fournies afin de détecter les incohérences.

Personnes clés, UBO, actionnaires, dirigeants et représentants

Le système identifie chaque personne et chaque entité morale liée à l’entreprise dans le modèle unifié Personnes clés :

UBO : personnes physiques qui détiennent ou contrôlent l’entreprise en dernier ressort, avec leurs pourcentages de détention et de droits de vote
Actionnaires (personnes physiques et morales) : chacun avec son pourcentage de détention
Dirigeants, représentants, secrétaires, signataires autorisés et autres fonctions de direction : chacun avec son rôle spécifique
Niveaux de détention par des personnes morales : sociétés mères de la chaîne de détention, avec une KYB imbriquée facultative

Une même personne peut porter plusieurs rôles (par exemple, dirigeant et actionnaire). Chaque rôle est configuré individuellement dans le workflow : vous définissez les rôles qui nécessitent une vérification KYC, le workflow KYC à utiliser et si l’utilisateur final peut ignorer la vérification. En savoir plus dans Personnes clés et Actionnariat.

Filtrage AML

Toutes les parties identifiées sont automatiquement contrôlées au regard des listes mondiales de surveillance AML :

AML Entreprise : contrôle l’entreprise au regard des sanctions, de la presse négative et des listes de mesures coercitives réglementaires
AML personne : contrôle chaque personne clé (UBO, actionnaire, dirigeant, représentant, etc.) individuellement
Utilise le même système de double score de risque (score de correspondance et score de risque) que la vérification des utilisateurs

Collecte des documents

Collectez et vérifiez les documents justificatifs :

Type de document	Exemples
Certificat de constitution	Certificat de constitution de la société
Statuts	Statuts, acte constitutif
Justificatif de domicile	Factures de services publics, relevés bancaires à l’adresse enregistrée du siège
Registre des actionnaires	Registre officiel des actionnaires
États financiers	Comptes annuels, rapports d’audit
Attestations fiscales	Certificats d’immatriculation fiscale ou de conformité
Documents personnalisés	Tout document supplémentaire exigé par votre processus de conformité

Les analystes peuvent demander des documents supplémentaires à l’entreprise pendant l’examen.

Examen et décision

La session d’entreprise reçoit un statut global fondé sur l’ensemble des contrôles :

Statut	Signification
Approuvé	Tous les contrôles ont été validés : l’entreprise est vérifiée
En cours d’examen	Un ou plusieurs contrôles nécessitent un examen manuel
Refusé	Un contrôle critique a échoué (par exemple, entreprise dissoute ou entité sous sanctions)

Les analystes peuvent examiner toutes les données collectées dans la Business Console, ajouter des commentaires, demander des documents supplémentaires et prendre une décision finale.

Cycle de vie des sessions d’entreprise

Chaque vérification d’entreprise s’exécute dans une session d’entreprise qui suit sa progression selon les statuts suivants :

Statut	Description
`"Not Started"`	Session créée, mais la vérification n’a pas encore commencé
`"In Progress"`	La vérification est en cours : consultations du registre, filtrage AML ou collecte de documents en cours
`"Approved"`	Toutes les vérifications ont réussi : l’entreprise est vérifiée
`"Declined"`	Une vérification critique a échoué (par exemple, entreprise dissoute ou entité sous sanctions)
`"In Review"`	Une ou plusieurs vérifications nécessitent un examen manuel par un analyste
`"Resubmitted"`	Session précédemment refusée, soumise de nouveau avec des données mises à jour

Chaque session possède un session_id unique, un session_number séquentiel et un session_token pour le lien de vérification hébergé. Lorsqu’une session est créée avec un identifiant vendor_data, Didit la relie automatiquement au profil d’entreprise correspondant.

Statuts des fonctionnalités

La vérification d’entreprise suit le statut de chaque composant de manière indépendante :

Fonctionnalité	Description
Vérification du registre	Consultation du registre des sociétés et extraction des données
AML Entreprise	Filtrage AML au niveau de l’entreprise par rapport aux listes de sanctions et de surveillance
Documents	Collecte de documents, OCR et recoupement des informations
Personnes clés	Identification des bénéficiaires effectifs et des dirigeants, AML et KYC

Chaque fonctionnalité peut avoir l’un des statuts suivants : "Not Finished", "Approved", "Declined", "In Review" ou "Resub Requested". Le statut global de la session agrège les statuts individuels des fonctionnalités : la session n’est "Approved" que lorsque toutes les fonctionnalités requises sont validées.

Événements webhook

Les sessions d’entreprise génèrent les événements webhook suivants :

Événement	Déclencheur
`status.updated`	Statut de la session modifié. La charge utile contient `session_kind: "business"` pour les sessions KYB.
`data.updated`	Un réviseur a modifié les données du registre ou les personnes clés dans la console, ou le registre a signalé une modification. La charge utile contient `session_kind: "business"`. Suivez `status.updated` pour la progression.
`business.status.updated`	Le statut de l’entité Business liée a changé (`ACTIVE` / `FLAGGED` / `BLOCKED`).
`business.data.updated`	Les champs du profil ou les compteurs agrégés de l’entité Business liée ont changé.

Les charges utiles des webhooks incluent session_kind: "business" et le business_session_id afin de les distinguer des événements de vérification des utilisateurs. Consultez Webhooks pour la vérification de signature et les détails de livraison.

Fonctionnalités clés

Capacité	Description
Consultations automatisées du registre	Interrogation des registres officiels des entreprises dans les pays pris en charge, aux niveaux Lite, Shareholders ou UBOs, tarifées par pays
Identification des UBO	Extraction automatique des structures de bénéficiaires effectifs avec les pourcentages de détention
Contrôle des dirigeants	Identification et vérification des administrateurs, des secrétaires et des autres dirigeants
AML Entreprise	Filtrage de l’entreprise par rapport aux listes de sanctions et de surveillance
AML des personnes	Filtrage individuel de tous les UBO et dirigeants identifiés
Liaison KYC	Relie chaque personne identifiée à une session de vérification des utilisateurs (KYC) pour sa vérification d’identité
Collecte de documents	Demandes de documents structurées avec suivi des envois
Recoupement OCR	Extraction des données des documents envoyés et recoupement avec les données du registre
Profils d’entreprise	Création automatique des profils et agrégation des sessions pour chaque entreprise vérifiée
Statuts par fonctionnalité	Suivi indépendant des statuts du registre, de l’AML, des documents et des personnes clés
Évaluation des risques	Étiquettes d’avertissement sur chaque contrôle et actions de workflow qui transforment le statut de l’entreprise, les résultats AML et les conclusions sur l’actionnariat en un résultat
Webhooks	Recevez en temps réel les événements de cycle de vie des sessions et de mise à jour des données via les webhooks

Sessions d’entreprise et sessions utilisateur

Fonctionnalité	Session utilisateur	Session d’entreprise
Cible	Personne physique	Entreprise ou entité juridique
Type de session	`user` (par défaut)	`business`
Contrôles principaux	Vérification d’identité, détection du vivant, correspondance faciale, AML	Consultation du registre, UBO, dirigeants, AML de l’entreprise
Contrôles supplémentaires	Téléphone, e-mail, justificatif de domicile, NFC	Collecte de documents, AML des personnes, liaison KYC
Charges utiles des webhooks	Événements de session standard	Incluent `session_kind: "business"` et `business_session_id`

Étapes suivantes

Profils d'entreprise

Suivez les entreprises d’une session à l’autre grâce aux profils, aux étiquettes et aux opérations en masse.

Données de l'entreprise

Consultations du registre, statut de l’entreprise et recoupement des données.

Structure de l'actionnariat

Identification des UBO, actionnaires personnes morales et chaînes de détention.

Dirigeants et administrateurs

Identification des administrateurs, rôles et liaison KYC.

Filtrage AML

Contrôles AML au niveau de l’entreprise et des personnes.

Documents

Collecte de documents, demandes et vérification OCR.

Prise en main

Fonctionnalités

Profils d'entreprise

Référence

Console

API de vérification d'entreprise (KYB) : registre et UBO

Fonctionnement

Cycle de vie des sessions d’entreprise

Statuts des fonctionnalités

Événements webhook

Fonctionnalités clés

Sessions d’entreprise et sessions utilisateur

Étapes suivantes

Profils d'entreprise

Données de l'entreprise

Structure de l'actionnariat

Dirigeants et administrateurs

Filtrage AML

Documents

​Fonctionnement

​Cycle de vie des sessions d’entreprise

​Statuts des fonctionnalités

​Événements webhook

​Fonctionnalités clés

​Sessions d’entreprise et sessions utilisateur

​Étapes suivantes

Profils d'entreprise

Données de l'entreprise

Structure de l'actionnariat

Dirigeants et administrateurs

Filtrage AML

Documents

Fonctionnement

Cycle de vie des sessions d’entreprise

Statuts des fonctionnalités

Événements webhook

Fonctionnalités clés

Sessions d’entreprise et sessions utilisateur

Étapes suivantes