> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Didit vérifie les entreprises via registres, UBO, dirigeants et AML. Dès $2.00 par vérification selon pays et niveau, sans contrat.

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](https://docs.didit.me/fr/business-verification/business-profiles.md), 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é.

[Vérifier une entreprise (KYB), du début à la fin — Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?rel=0\&playsinline=1)

Nouveau sur la KYB de Didit ? Commencez par le [démarrage rapide](https://docs.didit.me/fr/business-verification/quickstart.md) pour un parcours complet en 10 minutes, puis lisez le [guide d'intégration](https://docs.didit.me/fr/business-verification/integration-guide.md) 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](https://docs.didit.me/fr/entities/businesses/overview.md).

## Fonctionnement

**1. 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 :

```bash theme={null}
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.

**2. 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](https://docs.didit.me/fr/getting-started/kyb-registry-pricing.md). 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.

**3. 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](https://docs.didit.me/fr/business-verification/key-people.md) et [Actionnariat](https://docs.didit.me/fr/business-verification/ownership.md).

**4. 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](https://docs.didit.me/fr/core-technology/aml-screening/overview.md) (score de correspondance et score de risque) que la vérification des utilisateurs

**5. 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.

**6. 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](https://docs.didit.me/fr/business-verification/business-profiles.md) 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](https://docs.didit.me/fr/entities/businesses/overview.md) 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](https://docs.didit.me/fr/integration/webhooks.md) 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](https://docs.didit.me/fr/getting-started/kyb-registry-pricing.md) |
| **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](https://docs.didit.me/fr/integration/webhooks.md) |

## 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

> [card] [Profils d'entreprise](https://docs.didit.me/fr/business-verification/business-profiles.md)
>
> Suivez les entreprises d'une session à l'autre grâce aux profils, aux étiquettes et aux opérations en masse.

> [card] [Données de l'entreprise](https://docs.didit.me/fr/business-verification/company-data.md)
>
> Consultations du registre, statut de l'entreprise et recoupement des données.

> [card] [Structure de l'actionnariat](https://docs.didit.me/fr/business-verification/ownership.md)
>
> Identification des UBO, actionnaires personnes morales et chaînes de détention.

> [card] [Dirigeants et administrateurs](https://docs.didit.me/fr/business-verification/officers.md)
>
> Identification des administrateurs, rôles et liaison KYC.

> [card] [Filtrage AML](https://docs.didit.me/fr/business-verification/aml.md)
>
> Contrôles AML au niveau de l'entreprise et des personnes.

> [card] [Documents](https://docs.didit.me/fr/business-verification/documents.md)
>
> Collecte de documents, demandes et vérification OCR.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.