Personnes clés KYB : UBO et dirigeants

​

Qui est considéré comme personne clé

​

Comment les personnes clés se rattachent à un Business

• REGISTRY : extraite d’un registre officiel.
• USER : ajoutée par l’administrateur de l’entreprise pendant le parcours KYB.

​

Lier une personne clé à une entité User

• Une session de vérification des utilisateurs (KYC) est exécutée pour cette personne avec le même vendor_data que l’entité User.
• Un analyste associe manuellement une personne de l’entreprise à un User existant.

​

Consulter les personnes clés

• Le nom, le rôle, le pourcentage de détention et la source (registre ou ajout par l’utilisateur) de chaque personne
• Le statut KYC des Users liés
• Le statut de filtrage AML de chaque personne
• Les documents associés (pièce d’identité du dirigeant, déclaration UBO)

"key_people_checks": [
  {
    "status": "Approved",
    "node_id": "feature_kyb_key_people",
    "registry": {
      "officers": [
        { "uuid": "...", "name": "Jane Doe", "role": "director", "kyc_status": "Approved", "kyc_session_url": "..." }
      ],
      "beneficial_owners": [
        { "uuid": "...", "name": "John Smith", "roles": ["ubo"], "ownership_min_shares": 40, "kyc_status": "Pending" }
      ]
    },
    "submitted": {
      "parties": [
        { "uuid": "...", "entity_type": "person", "name": "Alice Chen", "role": "ubo", "ownership_percent": 35.0, "source": "USER", "requires_verification": true, "kyc_session_status": "Not Started", "kyc_session_url": "..." }
      ]
    },
    "ubo_kyc_summary": { "total": 2, "approved": 1, "flagged": 0, "pending": 1 }
  }
]

• registry.officers / registry.beneficial_owners : personnes identifiées lors de la vérification dans le registre.
• submitted.parties : personnes ajoutées par l’administrateur de l’entreprise pendant le parcours Personnes clés (source: USER).
• ubo_kyc_summary : progression globale de la vérification KYC des UBO.

​

Actionnaires personnes morales

​

Webhooks des personnes clés

• data.updated (avec session_kind: "business") : les données de la session, y compris les personnes clés, ont été mises à jour.
• status.updated (avec session_kind: "business") : le statut de la session a changé en conséquence.

​

Étapes suivantes