Unternehmensverifizierung (KYB) API: Register & UBO

Mit der Unternehmensverifizierung (KYB) von Didit können Sie Unternehmen und juristische Personen verifizieren, bevor Sie sie in Ihre Plattform aufnehmen. Das System automatisiert Abfragen in Unternehmensregistern, ermittelt wirtschaftlich Berechtigte und Organmitglieder, prüft alle Beteiligten gegen AML-Beobachtungslisten und erfasst Nachweisdokumente, und das alles in einem einzigen Workflow. Jedes verifizierte Unternehmen wird als Unternehmensprofil geführt, das die Ergebnisse aus allen Sitzungen zusammenfasst. Diese Lektion der Didit Academy begleitet eine Unternehmensverifizierung von Anfang bis Ende: das KYB-Dashboard, die Registerabfrage, Gesellschafter und UBOs, das AML-Screening und das, was der Unternehmensvertreter auf seiner Seite sieht. Neu bei Didit KYB? Beginnen Sie mit dem Schnellstart für einen End-to-End-Durchlauf in 10 Minuten und lesen Sie danach den Integrationsleitfaden für Muster im Produktivbetrieb. Das zugrunde liegende Unternehmensmodell (mit Verknüpfungen zu Benutzern, Sperrlisten sowie Import und Export) finden Sie unter Unternehmen.

So funktioniert es

Eine Unternehmenssitzung erstellen

Starten Sie eine Unternehmensverifizierung, indem Sie eine Sitzung mit einem KYB-Workflow erstellen. Wenn der Workflow-Typ KYB ist, erstellt Didit automatisch eine Unternehmenssitzung:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your-kyb-workflow-id",
    "vendor_data": "company-123"
  }'

Der Sitzungstyp wird durch den Workflow bestimmt, zusätzliche Felder sind nicht nötig. KYB-Workflows erstellen automatisch Unternehmenssitzungen mit aktivierten unternehmensspezifischen Funktionen.

Abfrage im Unternehmensregister

Didit fragt offizielle Unternehmensregister auf der Stufe Lite, Shareholders oder UBOs ab. Jede Stufe wird pro Land berechnet, siehe Registerpreise. Lite liefert:

Daten	Beschreibung
Firmenname	Rechtlich eingetragener Name
Registrierungsnummer	Offizielle Registrierungsnummer des Unternehmens
Land	Land der Gründung
Status	Aktiv, aufgelöst, von Amts wegen gelöscht usw.
Unternehmenstyp	Ltd, LLC, PLC, SA, GmbH usw.
Gründungsdatum	Datum der Eintragung des Unternehmens
Eingetragene Adresse	Offizieller Sitz des Unternehmens
Steuernummer	Steueridentifikationsnummer (sofern verfügbar)

Die Registerdaten werden mit den übermittelten Angaben abgeglichen, um Inkonsistenzen zu erkennen.

Schlüsselpersonen – UBOs, Gesellschafter, Geschäftsführer und Vertreter

Das System ermittelt jede natürliche und juristische Person, die mit dem Unternehmen verbunden ist, im einheitlichen Modell Schlüsselpersonen:

UBOs – natürliche Personen, die das Unternehmen letztlich besitzen oder kontrollieren, mit ihren Eigentums- und Stimmrechtsanteilen
Gesellschafter (natürliche und juristische Personen), jeweils mit ihrem Eigentumsanteil
Geschäftsführer, Vertreter, Sekretäre, zeichnungsberechtigte Personen und weitere Organrollen, jeweils mit ihrer spezifischen Rollenkennzeichnung
Ebenen der Unternehmenseigentümerstruktur: Muttergesellschaften in der Eigentumskette, optional mit verschachteltem KYB

Eine Person kann mehrere Rollenkennzeichnungen tragen (zum Beispiel Geschäftsführer und Gesellschafter). Jede Rolle wird einzeln im Workflow konfiguriert: welche Rollen eine KYC-Prüfung benötigen, welchen KYC-Workflow sie verwenden und ob der Endbenutzer die Verifizierung überspringen kann. Mehr dazu unter Schlüsselpersonen und Eigentümerstruktur.

AML-Screening

Alle ermittelten Beteiligten werden automatisch gegen globale AML-Beobachtungslisten geprüft:

Unternehmens-AML: prüft die Gesellschaft gegen Sanktionslisten, negative Medienberichte und Listen regulatorischer Durchsetzungsmaßnahmen
Personen-AML: prüft jede Schlüsselperson (UBO, Gesellschafter, Geschäftsführer, Vertreter usw.) einzeln
Verwendet dasselbe Zwei-Score-Risikosystem (Übereinstimmungswert und Risiko-Score) wie die Benutzerverifizierung

Dokumentenerfassung

Erfassen und verifizieren Sie Nachweisdokumente:

Dokumenttyp	Beispiele
Gründungsurkunde	Bescheinigung der Unternehmensgründung
Satzung	Gesellschaftsvertrag, Memorandum of Association
Adressnachweis	Versorgungsrechnungen und Kontoauszüge für die eingetragene Adresse
Gesellschafterliste	Offizielles Verzeichnis der Gesellschafter
Finanzberichte	Jahresabschlüsse, Prüfungsberichte
Steuerbescheinigungen	Bescheinigungen über die steuerliche Registrierung oder Compliance
Benutzerdefinierte Dokumente	Zusätzliche Dokumente, die Ihr Compliance-Prozess erfordert

Analysten können im Prüfungsprozess zusätzliche Dokumente vom Unternehmen anfordern.

Prüfen und entscheiden

Die Unternehmenssitzung erhält einen Gesamtstatus auf Grundlage aller Prüfungen:

Status	Bedeutung
Genehmigt	Alle Prüfungen bestanden, das Unternehmen ist verifiziert
In Prüfung	Eine oder mehrere Prüfungen erfordern eine manuelle Prüfung
Abgelehnt	Eine kritische Prüfung ist fehlgeschlagen (z. B. aufgelöstes Unternehmen, sanktionierte Einheit)

Analysten können alle erhobenen Daten in der Business Console einsehen, Kommentare hinzufügen, zusätzliche Dokumente anfordern und eine endgültige Entscheidung treffen.

Lebenszyklus der Unternehmenssitzung

Jede Unternehmensverifizierung läuft in einer Unternehmenssitzung, die den Fortschritt anhand der folgenden Status verfolgt:

Status	Beschreibung
`"Not Started"`	Sitzung erstellt, die Verifizierung hat aber noch nicht begonnen
`"In Progress"`	Die Verifizierung läuft: Registerabfragen, AML-Screening oder Dokumentenerfassung sind in Arbeit
`"Approved"`	Alle Prüfungen bestanden: Das Unternehmen ist verifiziert
`"Declined"`	Eine kritische Prüfung ist fehlgeschlagen (z. B. aufgelöstes Unternehmen, sanktionierte Einheit)
`"In Review"`	Eine oder mehrere Prüfungen erfordern eine manuelle Prüfung durch einen Analysten
`"Resubmitted"`	Zuvor abgelehnte Sitzung wurde mit aktualisierten Daten erneut eingereicht

Jede Sitzung hat eine eindeutige session_id, eine fortlaufende session_number und einen session_token für den gehosteten Verifizierungslink. Wenn eine Sitzung mit einer vendor_data-Kennung erstellt wird, verknüpft Didit sie automatisch mit dem entsprechenden Unternehmensprofil.

Status der Funktionen

Die Unternehmensverifizierung verfolgt den Status jeder Komponente unabhängig voneinander:

Funktion	Beschreibung
Registerprüfung	Abfrage des Unternehmensregisters und Datenextraktion
Unternehmens-AML	AML-Screening auf Unternehmensebene gegen Sanktions- und Beobachtungslisten
Dokumente	Dokumentenerfassung, OCR und Kreuzprüfung
Schlüsselpersonen	Identifizierung wirtschaftlich Berechtigter und Organmitglieder, AML und KYC

Jede Funktion kann folgende Status haben: "Not Finished", "Approved", "Declined", "In Review" oder "Resub Requested". Der Gesamtstatus der Sitzung ergibt sich aus den einzelnen Funktionsstatus. Die Sitzung hat den Status "Approved" nur dann, wenn alle erforderlichen Funktionen bestanden sind.

Webhook-Ereignisse

Unternehmenssitzungen erzeugen die folgenden Webhook-Ereignisse:

Ereignis	Auslöser
`status.updated`	Der Sitzungsstatus hat sich geändert. Die Payload enthält für KYB-Sitzungen `session_kind: "business"`.
`data.updated`	Ein Prüfer hat Registerdaten oder Schlüsselpersonen in der Konsole bearbeitet, oder das Register hat eine Änderung gemeldet. Die Payload enthält `session_kind: "business"`. Den Fortschritt verfolgen Sie über `status.updated`.
`business.status.updated`	Der Status der verknüpften Unternehmensentität hat sich geändert (`ACTIVE` / `FLAGGED` / `BLOCKED`).
`business.data.updated`	Die Profilfelder oder aggregierten Zähler der verknüpften Unternehmensentität haben sich geändert.

Webhook-Payloads enthalten session_kind: "business" und die business_session_id, um sie von Ereignissen der Benutzerverifizierung zu unterscheiden. Details zur Signaturprüfung und Zustellung finden Sie unter Webhooks.

Wichtigste Funktionen

Funktion	Beschreibung
Automatisierte Registerabfragen	Abfrage offizieller Unternehmensregister in unterstützten Ländern auf der Stufe Lite, Shareholders oder UBOs, mit Preisen pro Land
UBO-Identifikation	Automatische Extraktion der Eigentumsstrukturen wirtschaftlich Berechtigter mit Prozentanteilen
Prüfung von Organmitgliedern	Identifizierung und Verifizierung von Geschäftsführern, Sekretären und anderen Organmitgliedern
Unternehmens-AML	Das Unternehmen gegen Sanktions- und Beobachtungslisten prüfen
Personen-AML	Alle ermittelten wirtschaftlich Berechtigten und Organmitglieder einzeln prüfen
KYC-Verknüpfung	Jede ermittelte Person zur Identitätsprüfung mit einer Sitzung der Benutzerverifizierung (KYC) verknüpfen
Dokumentenerfassung	Strukturierte Dokumentenanforderungen mit Verfolgung der Uploads
OCR-Abgleich	Daten aus hochgeladenen Dokumenten extrahieren und mit Registerdaten abgleichen
Unternehmensprofile	Automatische Profilerstellung und Aggregation der Sitzungen für jedes verifizierte Unternehmen
Status auf Funktionsebene	Unabhängige Statusverfolgung für Register, AML, Dokumente und Schlüsselpersonen
Risikobewertung	Warn-Tags zu jeder Prüfung und Workflow-Aktionen, die Unternehmensstatus, AML-Ergebnisse und Befunde zur Eigentümerstruktur in ein Ergebnis überführen
Webhooks	Ereignisse zum Sitzungslebenszyklus und zu Datenaktualisierungen in Echtzeit über Webhooks empfangen

Unternehmenssitzungen im Vergleich zu Benutzersitzungen

Merkmal	Benutzersitzung	Unternehmenssitzung
Ziel	Einzelperson	Unternehmen oder juristische Person
Sitzungsart	`user` (Standard)	`business`
Kernprüfungen	Ausweisverifizierung, Liveness, Gesichtsabgleich, AML	Registerabfrage, UBO, Organmitglieder, Unternehmens-AML
Zusätzliche Prüfungen	Telefon, E-Mail, Adressnachweis, NFC	Dokumentenerfassung, Personen-AML, KYC-Verknüpfung
Webhook-Payloads	Standard-Sitzungsereignisse	Enthalten `session_kind: "business"` und `business_session_id`

Nächste Schritte

Unternehmensprofile

Unternehmen über Sitzungen hinweg mit Profilen, Tags und Massenoperationen verfolgen.

Unternehmensdaten

Registerabfragen, Unternehmensstatus und Datenabgleich.

Eigentumsstruktur

UBO-Identifikation, Gesellschafter juristischer Personen und Eigentumsketten.

Organmitglieder und Geschäftsführer

Identifizierung von Geschäftsführern, Rollen und KYC-Verknüpfung.

AML-Screening

AML-Prüfungen auf Unternehmens- und Personenebene.

Dokumente

Dokumentenerfassung, Anforderungen und OCR-Verifizierung.

Erste Schritte

Funktionen

Unternehmensprofile

Referenz

Konsole

Unternehmensverifizierung (KYB) API: Register & UBO

So funktioniert es

Lebenszyklus der Unternehmenssitzung

Status der Funktionen

Webhook-Ereignisse

Wichtigste Funktionen

Unternehmenssitzungen im Vergleich zu Benutzersitzungen

Nächste Schritte

Unternehmensprofile

Unternehmensdaten

Eigentumsstruktur

Organmitglieder und Geschäftsführer

AML-Screening

Dokumente

​So funktioniert es

​Lebenszyklus der Unternehmenssitzung

​Status der Funktionen

​Webhook-Ereignisse

​Wichtigste Funktionen

​Unternehmenssitzungen im Vergleich zu Benutzersitzungen

​Nächste Schritte

Unternehmensprofile

Unternehmensdaten

Eigentumsstruktur

Organmitglieder und Geschäftsführer

AML-Screening

Dokumente

So funktioniert es

Lebenszyklus der Unternehmenssitzung

Status der Funktionen

Webhook-Ereignisse

Wichtigste Funktionen

Unternehmenssitzungen im Vergleich zu Benutzersitzungen

Nächste Schritte