Schlüsselpersonen im Unternehmen: UBOs & Geschäftsführer

​

Wer als Schlüsselperson gilt

​

Wie Schlüsselpersonen einem Unternehmen zugeordnet werden

• REGISTRY: aus einem offiziellen Register extrahiert.
• USER: vom Unternehmensadministrator während des KYB-Ablaufs hinzugefügt.

​

Eine Schlüsselperson mit einer User-Entität verknüpfen

• Für die Person eine Benutzerverifizierung (KYC)-Sitzung mit denselben vendor_data wie die User-Entität durchgeführt wird.
• Ein Analyst eine Person des Unternehmens manuell einem bestehenden User zuordnet.

​

Schlüsselpersonen einsehen

• Name, Rolle, Eigentumsanteil in % und Quelle (Register oder vom Nutzer ergänzt) jeder Person
• KYC-Status der verknüpften Users
• AML-Screening-Status je Person
• Zugehörige Dokumente (Ausweis des Geschäftsführers, UBO-Erklärung)

"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: Personen, die bei der Registerprüfung ermittelt wurden.
• submitted.parties: Personen, die der Unternehmensadministrator während des Schlüsselpersonen-Ablaufs hinzugefügt hat (source: USER).
• ubo_kyc_summary: Gesamtfortschritt des UBO-KYC-Prozesses.

​

Gesellschafter, die Unternehmen sind

​

Webhooks für Schlüsselpersonen

• data.updated (mit session_kind: "business"): Sitzungsdaten einschließlich der Schlüsselpersonen wurden aktualisiert.
• status.updated (mit session_kind: "business"): Der Sitzungsstatus hat sich dadurch geändert.

​

Nächste Schritte