> ## 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 UBO : extraction des bénéficiaires effectifs > Extrayez les UBO des registres : chaînes de propriété, pourcentages et filtrage AML. Dès $2.00 par vérification, avec Didit. Identifier qui détient et contrôle en définitive une entreprise est au cœur du KYB. Didit récupère la structure de l’actionnariat auprès du registre lorsque celui-ci est disponible, permet à l'administrateur de l'entreprise de la confirmer et de la compléter dans le parcours hébergé, puis exécute une vérification adaptée au rôle de chaque personne clé. ## Bénéficiaires effectifs (UBO) Un **bénéficiaire effectif ultime (UBO)** est une personne physique qui détient ou contrôle en définitive une entité juridique. Les UBO apparaissent dans la décision de session sous `key_people_checks[].registry.beneficial_owners[]` (issus du registre) et `key_people_checks[].submitted.parties[]` (soumis par l'utilisateur), avec les autres rôles, comme actionnaire ou dirigeant, dans la même liste. ## Données collectées pour chaque personne clé Le parcours hébergé collecte un ensemble de champs par défaut, auxquels s'ajoutent les champs personnalisés configurés dans le workflow. Les champs par défaut : | Champ | Personne | Entreprise | | - | :-: | :-: | | `name` ou `first_name` + `last_name` | ✅ obligatoire | ✅ obligatoire (`company_name`) | | `email` | ✅ obligatoire | ✅ obligatoire | | `nationality` / pays | ✅ obligatoire | ✅ obligatoire | | `role` (un ou plusieurs par partie) | ✅ obligatoire | ✅ obligatoire | | `ownership_percent` / `voting_percent` (par rôle) | facultatif | facultatif | | `date_of_birth` | facultatif | — | | `phone_number` | facultatif | — | | `position` (intitulé de poste en texte libre) | facultatif | — | | `registration_number` | — | facultatif | | `entity_type` | `person` | `company` | `entity_type` est défini automatiquement selon que la partie est une personne physique ou une entité morale. ### Champs personnalisés Les workflows peuvent exiger des champs supplémentaires par personne ou par entreprise, en nombre illimité. Ils se configurent dans la Business Console, sur le workflow KYB, et figurent dans l'objet `custom_fields` de chaque partie dans la réponse de décision. Utilisez les champs personnalisés pour des données telles que les déclarations sur l'origine du patrimoine, la résidence fiscale, les identifiants clients internes ou les informations propres à un secteur d'activité. ## Actionnaires de type société et détention en cascade Lorsqu'un actionnaire est lui-même une société (et non une personne physique), Didit enregistre : * Le nom de la société et son numéro d'immatriculation. * Le pourcentage de détention de cet actionnaire de type société. * Le pays de constitution. Vous pouvez ainsi remonter la chaîne à travers plusieurs niveaux jusqu’aux personnes physiques qui en sont les bénéficiaires ultimes. ### KYB imbriqué pour les UBO de type société Lorsque le workflow active le KYB imbriqué pour les UBO de type société, chaque partie de type société déclenche sa propre sous-session KYB enfant : la société est vérifiée selon le même processus que celui appliqué au niveau supérieur, et son résultat est remonté à la session parente. Désactivé par défaut ; à activer par workflow. ## Seuils de détention La plupart des juridictions considèrent comme UBO les personnes détenant ou contrôlant **25 % ou plus**. Le seuil est configurable par workflow : | Juridiction | Seuil UBO habituel | | - | - | | UE (AMLD) | 25 % de l’actionnariat ou du contrôle | | Royaume-Uni | 25% des actions ou des droits de vote | | États-Unis (CTA) | 25% de la propriété ou un contrôle substantiel | | Singapour | 25% des actions ou des droits de vote | Définissez-le depuis *Workflows → \[KYB workflow] → Risk → UBO threshold*. Votre workflow peut également signaler le cas ou l’orienter vers un examen lorsqu’aucun UBO n’atteint le seuil, ce qui est fréquent pour les sociétés cotées à actionnariat diffus. ## Droits de vote et droits économiques Les déclarations d’actionnariat distinguent deux types de contrôle : | Droit | Signification | | - | - | | **Pourcentage économique (actionnariat)** | Part de la valeur économique de la société ou des droits aux dividendes | | **Pourcentage de vote** | Part des droits de vote lors des décisions des actionnaires | Ces deux pourcentages sont généralement identiques, mais peuvent diverger lorsque la société émet des actions à deux catégories ou des actions de préférence. Didit enregistre les deux. Les règles et les seuils peuvent porter sur l'un ou l'autre : la plupart des juridictions exigent la déclaration d'un UBO lorsque *l'un ou l'autre* dépasse 25%. ## Participation effective à travers une chaîne Lorsque la détention passe par un actionnaire de type société, la participation effective d'une personne physique en aval se calcule en multipliant les pourcentages le long de la chaîne. ### Exemple : chaîne à 3 niveaux ``` Acme Corp (target) └─ 60% → Acme Holdings Ltd └─ 75% → Jane Doe (natural person) └─ 40% → John Smith (natural person) ``` UBO calculés : * **Jane Doe** : participation effective dans Acme Corp = 60% × 75% = **45%** (UBO). * **John Smith** : participation effective dans Acme Corp = **40%** (UBO). Avec un seuil UBO de 25%, Jane et John sont tous deux déclarés. Avec un seuil de 50%, aucun UBO n'atteint le seuil : Didit signale ce point comme un problème de transparence. ## Comment les paramètres de rôle déterminent la vérification Chaque rôle est configuré individuellement pour chaque workflow KYB : activé ou désactivé, nécessitant ou non un KYC, workflow KYC utilisé pour ce rôle, et possibilité pour l'utilisateur final de l'ignorer. Lorsqu'une personne clé est soumise : 1. Didit vérifie les rôles de la partie soumise par rapport aux paramètres de rôle du workflow. 2. Pour les rôles marqués comme nécessitant une vérification, une session de vérification enfant est démarrée : * **Parties personnes physiques** → session enfant de vérification des utilisateurs (KYC), utilisant soit le workflow KYC propre au rôle, soit le workflow par défaut. * **UBO de type société** (lorsque le KYB imbriqué est activé) → sous-session KYB enfant de vérification d'entreprise. 3. Pour les rôles marqués comme pouvant être ignorés, l'utilisateur final voit une option « passer la vérification » et peut la refuser ; les parties ignorées sont enregistrées mais ne bloquent pas la session parente. 4. Les parties en deçà du seuil de détention du workflow ne déclenchent pas de vérification individuelle, même si leur rôle l'exigerait. Configurez l'ensemble depuis *Workflows → \[KYB workflow] → Key People* dans la Business Console. ## Surveillance des actionnaires et des UBO > [!NOTE] > > La surveillance du registre est **bientôt disponible**. Aucun pays du catalogue retail de staging vérifié le 7 septembre 2026 n'a la surveillance activée. Le tarif configuré est de USD 2.00 par entreprise et par an ; un prix ne signifie pas que la fonctionnalité est disponible. Le comportement décrit ci-dessous correspond au service prévu après le déploiement. Une entreprise vérifiée au niveau **Actionnaires** ou **UBO** peut faire l'objet d'une **surveillance continue du registre**. Le registre transmet les modifications de statut de l'entreprise, des dirigeants, de l'actionnariat et de l'adresse du siège ; pour chaque modification, Didit : * fait repasser la session d'entreprise d’*Approuvée* à *En cours d’examen*, avec la modification enregistrée dans la session ; * envoie un [webhook](https://docs.didit.me/fr/business-verification/webhooks.md) `data.updated` avec `trigger: "kyb_registry_change"` ; * maintient à jour l'enregistrement de l'entreprise dans le registre. La surveillance n'est disponible **que dans les pays qui l'autorisent** : le fournisseur de registre doit proposer une surveillance pour cette juridiction. La liste complète figure dans le [tableau des pays de surveillance continue](https://docs.didit.me/fr/business-verification/supported-countries.md#surveillance-continue-du-registre). Une entreprise vérifiée au niveau Lite, ou située dans un pays absent de cette liste, n'est pas inscrite, et la page de l'entreprise indique la raison. Activez-la par workflow depuis *Workflows → KYB Registry Check → Advanced → Continuous registry monitoring*. Le coût est de **\$2.00 par entreprise et par an**, facturé à l'inscription et à chaque renouvellement annuel ; lorsque le portefeuille ne peut pas couvrir un renouvellement, la surveillance s'arrête pour cette entreprise au lieu de continuer sans paiement. Vous pouvez l'annuler à tout moment depuis la page de l'entreprise (*KYB Registry Check → Registry monitoring*). ## Rapprochement registre et données soumises par l'utilisateur La réponse présente les deux sources côte à côte sous `key_people_checks[]` : * `registry.officers[]` et `registry.beneficial_owners[]` : ce que le fournisseur a divulgué. * `submitted.parties[]` : ce que l'administrateur de l'entreprise a explicitement soumis dans le parcours, avec `source: "USER"`. Les analystes comparent visuellement les deux blocs dans la console pour repérer les UBO manquants, les parties supplémentaires non déclarées ou les pourcentages de détention qui ne correspondent pas. Il n'existe pas d'endpoint de comparaison automatique : vous pouvez effectuer le rapprochement de votre côté en faisant correspondre le nom, le rôle et, le cas échéant, la détention. ## Filtrage AML Chaque personne clé identifiée est automatiquement filtrée contre les listes de surveillance AML mondiales, côté registre comme côté données soumises. Consultez [Filtrage AML des entreprises](https://docs.didit.me/fr/business-verification/aml.md) pour savoir comment les contrôles AML au niveau de l'entreprise et au niveau de la personne se combinent. ## Prochaines étapes > [card] [Personnes clés](https://docs.didit.me/fr/business-verification/key-people.md) > > Le parcours Personnes clés de bout en bout. > [card] [Dirigeants et représentants](https://docs.didit.me/fr/business-verification/officers.md) > > Les rôles de gouvernance dans le modèle des personnes clés. > [card] [Évaluation des risques](https://docs.didit.me/fr/business-verification/risk-assessment.md) > > Ce qui détermine le résultat d'une vérification KYB. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.