API KYB dirigeants et représentants : rôles clés

Les dirigeants, administrateurs et représentants ne constituent pas un concept distinct dans le modèle KYB de Didit : ils sont enregistrés dans les personnes clés, aux côtés des UBO et des actionnaires, avec un ou plusieurs rôles par personne. Une même personne peut être administrateur et actionnaire, ou représentant et signataire autorisé : la personne concernée porte la liste complète de ses rôles, et pas un seul.

Taxonomie complète des rôles

Chaque personne clé peut occuper un ou plusieurs de ces rôles :

Gouvernance / représentation

Rôle	Description
`director`	Membre du conseil d’administration exerçant des responsabilités de gouvernance
`non_executive_director`	Membre du conseil d’administration sans fonctions de gestion au quotidien
`chairman`	Président du conseil d’administration
`secretary`	Secrétaire de la société chargé des missions administratives et de conformité
`representative`	Représentant légal ou désigné de la société
`authorized_signatory`	Personne habilitée à signer au nom de la société
`trustee`	Trustee d’une structure détenant des participations dans la société
`company_officer`	Rôle général de dirigeant
`founder`	Membre fondateur de la société
`legal_advisor`	Conseil juridique mandaté par la société
`other`	Tout rôle ne figurant pas dans la taxonomie standard

Actionnariat / bénéficiaires

Rôle	Description
`ubo`	Bénéficiaire effectif ultime (UBO) : personne physique qui détient ou contrôle en dernier ressort la société
`shareholder`	Actionnaire inscrit (personne physique ou morale)
`beneficiary`	Bénéficiaire d’un trust ou d’une structure similaire
`settlor`	Constituant d’un trust
`protector`	Protecteur d’un trust
`investor`	Investisseur (hors structures formelles de détention du capital)

Une même personne peut porter les deux catégories : par exemple, un fondateur qui est aussi administrateur et UBO détient trois rôles sur le même enregistrement de personne clé.

Enregistrements à rôles multiples

Chaque enregistrement de personne clé comprend une liste de rôles, chacun assorti, le cas échéant, de ses pourcentages de détention ou de droits de vote. Voici à quoi ressemble un administrateur également actionnaire dans la réponse :

{
  "uuid": "...",
  "name": "Jane Doe",
  "first_name": "John",
  "last_name": "Doe",
  "entity_type": "person",
  "roles": [
    { "role": "director", "ownership_percent": null, "voting_percent": null },
    { "role": "shareholder", "ownership_percent": 15.0, "voting_percent": 15.0 }
  ],
  "kyc_status": "Approved",
  "kyc_session_url": "https://verify.didit.me/..."
}

Liaison KYC

Chaque personne clé peut être liée à une session individuelle de Vérification des utilisateurs (KYC). La liaison se fait automatiquement lorsque les paramètres de workflow du rôle exigent un KYC : le système crée la session KYC enfant, envoie à la personne son lien de vérification par e-mail (si cette option est activée) et met à jour le statut de la personne concernée. Voir Actionnariat → Comment les paramètres de rôle pilotent la vérification pour la logique de routage complète. Pour les valeurs de statut KYC adaptées au B2C et affichées pour chaque personne concernée (Approved, Declined, Pending), consultez le schéma de réponse.

Filtrage AML

Chaque personne clé identifiée est automatiquement filtrée par rapport aux listes de surveillance AML mondiales dans le cadre de la vérification de l’entreprise. Les correspondances PEP sont particulièrement pertinentes pour les rôles de gouvernance : les administrateurs et signataires de sociétés réglementées figurent souvent sur les listes de PEP. Voir Filtrage AML des entreprises.

Indicateur de vérification requise

Chaque personne concernée porte un indicateur requires_verification qui indique si le workflow exige un KYC pour cette personne :

Valeur	Signification
`true`	Le KYC doit être terminé pour cette personne avant que la session puisse être approuvée.
`false`	La personne est identifiée et soumise au filtrage AML, mais ne nécessite pas de KYC individuel.

Configurez les rôles qui nécessitent une vérification depuis Workflows → [KYB workflow] → Key People → per-role settings. Valeurs par défaut habituelles :

Administrateurs et UBO au-dessus du seuil du workflow → requires_verification: true.
Signataires autorisés et secrétaires → facultatif.
Administrateurs non exécutifs → facultatif.

Ignorer une personne clé

Si une personne ne peut pas être vérifiée (décédée, injoignable, ancienne), elle peut être marquée avec is_skipped: true, soit par l’utilisateur final dans le parcours hébergé (si les paramètres du rôle autorisent cette option), soit par un analyste depuis la console. Les personnes ignorées sont exclues de la condition de vérification, mais restent présentes dans la réponse à des fins d’audit.

Recoupement entre sources

Les données sur chaque personne clé peuvent provenir de trois sources, et la console les affiche côte à côte :

Données de registre : ce que le registre officiel a communiqué.
Données soumises par l’utilisateur : ce que l’administrateur de l’entreprise a confirmé ou ajouté dans le flux Personnes clés.
Documents téléversés : noms extraits par OCR à partir des statuts, des registres d’actionnaires ou des procurations.

Les incohérences apparaissent sous forme d’avertissements dans la décision de la session.

Effet sur l’entité Business

Lier une personne clé à une entité User via KYC crée une relation durable sur l’entité Business. Vous pouvez alors :

Consulter chaque entreprise pour laquelle la personne exerce un rôle de gouvernance ou d’actionnariat.
Propager les changements de statut d’un User (signalé, bloqué) vers les entreprises dans lesquelles il exerce en tant que personne clé.
Lancer une surveillance AML continue de chaque personne liée, indépendamment de toute session KYB spécifique.

Prochaines étapes

Personnes clés

Le flux complet des personnes clés.

Actionnariat

Identification des UBO et chaînes d’actionnariat.

AML

Filtrage AML des entreprises et des personnes.

Prise en main

Fonctionnalités

Profils d'entreprise

Référence

Console

API KYB dirigeants et représentants : rôles clés

Taxonomie complète des rôles

Gouvernance / représentation

Actionnariat / bénéficiaires

Enregistrements à rôles multiples

Liaison KYC

Filtrage AML

Indicateur de vérification requise

Ignorer une personne clé

Recoupement entre sources

Effet sur l’entité Business

Prochaines étapes

Personnes clés

Actionnariat

AML

​Taxonomie complète des rôles

​Gouvernance / représentation

​Actionnariat / bénéficiaires

​Enregistrements à rôles multiples

​Liaison KYC

​Filtrage AML

​Indicateur de vérification requise

​Ignorer une personne clé

​Recoupement entre sources

​Effet sur l’entité Business

​Prochaines étapes

Personnes clés

Actionnariat

AML

Taxonomie complète des rôles

Gouvernance / représentation

Actionnariat / bénéficiaires

Enregistrements à rôles multiples

Liaison KYC

Filtrage AML

Indicateur de vérification requise

Ignorer une personne clé

Recoupement entre sources

Effet sur l’entité Business

Prochaines étapes