> ## 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.

# Unternehmensverifizierung (KYB) API: Register & UBO

> Didit verifiziert Unternehmen per Registerabgleich, UBO-Ermittlung, Geschäftsführer-Screening und AML. Ab $2.00 pro Verifizierung, ohne Verträge.

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](https://docs.didit.me/de/business-verification/business-profiles.md) 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.

[Ein Unternehmen verifizieren (KYB), von Anfang bis Ende – Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?rel=0\&playsinline=1)

Neu bei Didit KYB? Beginnen Sie mit dem [Schnellstart](https://docs.didit.me/de/business-verification/quickstart.md) für einen End-to-End-Durchlauf in 10 Minuten und lesen Sie danach den [Integrationsleitfaden](https://docs.didit.me/de/business-verification/integration-guide.md) für Muster im Produktivbetrieb. Das zugrunde liegende Unternehmensmodell (mit Verknüpfungen zu Benutzern, Sperrlisten sowie Import und Export) finden Sie unter [Unternehmen](https://docs.didit.me/de/entities/businesses/overview.md).

## So funktioniert es

**1. 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:

```bash theme={null}
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.

**2. Abfrage im Unternehmensregister**

Didit fragt offizielle Unternehmensregister auf der Stufe **Lite**, **Shareholders** oder **UBOs** ab. Jede Stufe wird pro Land berechnet, siehe [Registerpreise](https://docs.didit.me/de/getting-started/kyb-registry-pricing.md). 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.

**3. 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](https://docs.didit.me/de/business-verification/key-people.md) und [Eigentümerstruktur](https://docs.didit.me/de/business-verification/ownership.md).

**4. 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](https://docs.didit.me/de/core-technology/aml-screening/overview.md) (Übereinstimmungswert und Risiko-Score) wie die Benutzerverifizierung

**5. 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.

**6. 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](https://docs.didit.me/de/business-verification/business-profiles.md).

## 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](https://docs.didit.me/de/entities/businesses/overview.md) 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](https://docs.didit.me/de/integration/webhooks.md).

## 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](https://docs.didit.me/de/getting-started/kyb-registry-pricing.md) |
| **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](https://docs.didit.me/de/integration/webhooks.md) 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

> [card] [Unternehmensprofile](https://docs.didit.me/de/business-verification/business-profiles.md)
>
> Unternehmen über Sitzungen hinweg mit Profilen, Tags und Massenoperationen verfolgen.

> [card] [Unternehmensdaten](https://docs.didit.me/de/business-verification/company-data.md)
>
> Registerabfragen, Unternehmensstatus und Datenabgleich.

> [card] [Eigentumsstruktur](https://docs.didit.me/de/business-verification/ownership.md)
>
> UBO-Identifikation, Gesellschafter juristischer Personen und Eigentumsketten.

> [card] [Organmitglieder und Geschäftsführer](https://docs.didit.me/de/business-verification/officers.md)
>
> Identifizierung von Geschäftsführern, Rollen und KYC-Verknüpfung.

> [card] [AML-Screening](https://docs.didit.me/de/business-verification/aml.md)
>
> AML-Prüfungen auf Unternehmens- und Personenebene.

> [card] [Dokumente](https://docs.didit.me/de/business-verification/documents.md)
>
> Dokumentenerfassung, Anforderungen und OCR-Verifizierung.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.