Identification automatisée des bénéficiaires effectifs et des graphes de propriété (FR)
Identifiez les bénéficiaires effectifs avec leurs pourcentages de propriété, résolvez les couches de propriété d'entreprise imbriquées et cartographiez le graphe de contrôle complet de toute entreprise – inclus dans une session.

Chaque obligation KYB aboutit finalement à la même question : qui possède réellement cette entreprise ? Pas les directeurs de première ligne, pas la société holding sur l'extrait du registre — les personnes physiques dont les participations signifient qu'elles contrôlent et bénéficient ultimement de l'entreprise. L'identification de ces bénéficiaires effectifs (UBO) est la partie la plus difficile de la vérification d'entreprise, car la propriété suit rarement une ligne droite. Une entreprise est détenue par une autre entreprise, qui est détenue par un fonds, qui est détenu par deux individus et une troisième entité holding dans un autre pays. Démêler cela à la main, registre par registre, est lent et sujet aux erreurs.
L'API de vérification d'entreprise de Didit le fait automatiquement. La fonctionnalité Personnes Clés d'une session KYB extrait les UBO avec leurs pourcentages de propriété, retourne la liste complète des actionnaires, directeurs, dirigeants et représentants, et résout les couches de propriété d'entreprise imbriquées afin que vous voyiez qui contrôle l'entité en bas de la chaîne. L'extraction des Personnes Clés est gratuite dans le cadre d'une session KYB — la vérification complète de l'entreprise est de 2,00 $.
Ce guide explique comment fonctionne l'identification des UBO, ce que contient le graphe de propriété et comment l'intégrer.
Points clés à retenir
- Extraction automatisée des UBO. La fonctionnalité
kyb_key_peopleidentifie les bénéficiaires effectifs avec leurs pourcentages de propriété — pas de recherche manuelle dans les registres. - Le tableau complet du contrôle. Au-delà des UBO, vous obtenez les actionnaires, directeurs, dirigeants et représentants dans le même résultat.
- Propriété imbriquée résolue. Lorsqu'une entreprise est détenue par d'autres entreprises, Didit résout les couches de propriété d'entreprise pour trouver les personnes physiques en fin de chaîne.
- L'extraction des Personnes Clés est gratuite dans le cadre d'une session KYB. La vérification complète de l'entreprise — registre + UBO + dirigeants + AML d'entité — est de 2,00 $.
- En boucle fermée, unique à Didit. Chaque UBO identifié peut générer une session KYC liée sur la même API
/v3/, de sorte que vous ne nommez pas seulement les propriétaires — vous les vérifiez. - Statuts pour chaque fonctionnalité.
kyb_key_peoplerapporteNOT_FINISHED,APPROVED,DECLINED,IN_REVIEW,RESUB_REQUESTED, ouAWAITING_USER.
Ce que fait l'identification des UBO
Un UBO est une personne physique qui possède ou contrôle ultimement une entreprise, généralement au-dessus d'un seuil de propriété réglementaire. Le défi est que la propriété est stratifiée : les actionnaires immédiats de l'entreprise que vous intégrez sont souvent d'autres entités juridiques, pas des personnes. Pour trouver les véritables bénéficiaires effectifs, vous devez parcourir l'arbre de propriété — entreprise par entreprise, couche par couche — jusqu'à atteindre les individus.
La fonctionnalité kyb_key_people de Didit effectue cette recherche automatiquement. Elle retourne les personnes et entités connectées à l'entreprise, les classe par rôle, attache les pourcentages de propriété là où ils s'appliquent, et signale les propriétaires d'entreprise afin que les couches imbriquées soient explicites plutôt que cachées derrière un seul élément de ligne. Le résultat est un graphe de propriété que vous pouvez lire, pas une liste plate que vous devez interpréter.
Pourquoi c'est important
La transparence de la propriété effective est une pierre angulaire de la réglementation AML moderne. Les directives AML de l'UE exigent des entités assujetties qu'elles identifient et vérifient les bénéficiaires effectifs au-dessus du seuil de propriété ; le Corporate Transparency Act américain a créé un régime fédéral de déclaration de la propriété effective ; et la Recommandation 24 du GAFI promeut la même norme à l'échelle mondiale. Intégrer une entreprise sans savoir qui se cache derrière est précisément la lacune que les structures de sociétés écrans exploitent.
Le problème opérationnel est la stratification. Une liste d'actionnaires plate vous dit que l'entreprise est détenue par une autre entreprise — utile, mais pas la réponse que le régulateur attend. Résoudre cela en individus réels est là où la plupart des processus KYB manuels échouent, et où la résolution automatisée du graphe de propriété gagne sa place.
Détails techniques
L'identification des UBO s'exécute dans une session KYB créée via l'API unifiée /v3/.
curl -X POST https://verification.didit.me/v3/session/\
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "your_kyb_workflow_id",
"vendor_data": "corp_client_3310",
"callback": "https://yourapp.com/kyb/callback"
}'
Le bloc kyb_key_people dans le résultat retourne le graphe de contrôle, avec les propriétaires d'entreprise signalés pour que les couches imbriquées soient explicites :
{
"kyb_key_people": {
"status": "APPROVED",
"ubos": [
{ "name": "Laura Méndez", "ownership_percentage": 60.0, "is_corporate": false },
{ "name": "Northwind Holding GmbH", "ownership_percentage": 40.0, "is_corporate": true,
"owners": [
{ "name": "Thomas Berger", "ownership_percentage": 100.0, "is_corporate": false }
]
}
],
"directors": [ { "name": "Laura Méndez", "role": "DIRECTOR" } ],
"officers": [ { "name": "Sven Albrecht", "role": "SECRETARY" } ],
"representatives": [ { "name": "Laura Méndez", "role": "LEGAL_REPRESENTATIVE" } ]
}
}
Rôles retournés. UBO (avec pourcentage de propriété), actionnaires, directeurs, dirigeants et représentants — plus les couches de propriété d'entreprise, où un propriétaire d'entreprise porte ses propres propriétaires jusqu'à ce que la chaîne se résolve en individus.
Statut de la fonctionnalité. kyb_key_people rapporte NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED, ou AWAITING_USER.
Webhooks. Abonnez-vous à data.updated (session_kind: business) pour recevoir le graphe de propriété au fur et à mesure de son enrichissement, et à status.updated pour réagir aux changements de statut de la fonctionnalité.
Prix. L'extraction des Personnes Clés est gratuite dans le cadre d'une session KYB. La vérification complète de l'entreprise est de 2,00 $. L'exécution d'un KYC lié sur un UBO identifié est facturée aux tarifs standard de vérification d'utilisateur.
Lecture du graphe de propriété
Le graphe est construit pour être parcouru. Chaque entrée porte un rôle et, le cas échéant, un pourcentage de propriété. Les individus sont les feuilles ; les propriétaires d'entreprise sont des branches qui portent leurs propres owners. Une liste d'actionnaires de deux lignes — une personne, une entreprise — se développe en une structure réelle : la personne, plus tous ceux qui se cachent derrière l'entreprise, jusqu'aux individus qui en bénéficient ultimement.
C'est ce qui sépare l'identification des UBO d'un simple déversement d'actionnaires. Une liste d'actionnaires s'arrête à la première couche. Un graphe de propriété continue de se résoudre jusqu'à ce que chaque branche se termine par une personne physique, de sorte que les UBO que vous déclarez sont les personnes réelles, et non les sociétés holding qui les précèdent.
Cas d'utilisation
- Les places de marché qui intègrent des vendeurs professionnels identifient les propriétaires derrière chaque entité de vendeur avant d'autoriser les paiements.
- Les plateformes de fintech et bancaires qui ouvrent des comptes d'entreprise résolvent la chaîne de propriété complète pour satisfaire aux obligations de propriété effective.
- Les fournisseurs de prêts qui souscrivent des emprunteurs professionnels voient qui contrôle ultimement l'emprunteur — et donc qui est responsable.
- Les plateformes Crypto B2B qui intègrent des entités contreparties cartographient la propriété pour s'assurer qu'aucun individu sanctionné ne se cache derrière un voile corporatif.
Comment s'intégrer avec Didit
- Construire le workflow. Dans la Console d'entreprise, créez un workflow KYB avec
kyb_key_peopleactivé, et activez le KYC lié pour les UBO si vous souhaitez vérifier les propriétaires identifiés. - Créer la session.
POST /v3/session/avec votreworkflow_idKYB et une référencevendor_datapour votre enregistrement commercial interne. - Gérer les webhooks. Écoutez
data.updatedetstatus.updated(session_kind: business) pour recevoir et réagir au graphe de propriété. - Vérifier les propriétaires. Pour chaque UBO, générez une session KYC liée sur la même API
/v3/pour confirmer que l'individu nommé est bien celui qu'il prétend être.
Parce que tout est sur l'API unifiée /v3/, l'identification d'un UBO et la vérification de cet UBO sont un flux continu — et non deux outils déconnectés et un transfert manuel.
Questions fréquemment posées
Comment les bénéficiaires effectifs sont-ils identifiés ?
Automatiquement, par la fonctionnalité kyb_key_people d'une session KYB. Elle retourne les UBO avec les pourcentages de propriété et résout les couches de propriété d'entreprise imbriquées pour trouver les individus en fin de chaîne.
Gère-t-elle les entreprises détenues par d'autres entreprises ?
Oui. Les propriétaires d'entreprise sont signalés et portent leurs propres propriétaires, de sorte que Didit résout les couches imbriquées jusqu'à ce que la propriété atteigne des personnes physiques.
Combien coûte l'identification des UBO ?
L'extraction des Personnes Clés est gratuite dans le cadre d'une session KYB. La vérification complète de l'entreprise — registre, UBO, dirigeants et AML d'entité — est de 2,00 $. Le KYC lié sur un UBO est facturé aux tarifs standard de vérification d'utilisateur.
Quels rôles le résultat inclut-il ?
UBO (avec pourcentage de propriété), actionnaires, directeurs, dirigeants et représentants, plus les couches de propriété d'entreprise qui les relient.
Puis-je vérifier les UBO, et pas seulement les nommer ?
Oui. Chaque UBO identifié peut générer une session KYC liée sur la même API unifiée /v3/ — une vérification en boucle fermée unique à Didit.
Prêt à commencer ?
Lisez l'aperçu de la vérification d'entreprise dans la documentation, voyez comment cela s'intègre au reste de la plateforme sur la page produit de vérification d'entreprise, et consultez les prix transparents par appel sur la page des tarifs. Lorsque vous êtes prêt, commencez gratuitement — 500 vérifications KYC gratuites chaque mois, et la vérification d'entreprise à 2,00 $ par entreprise.