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

# UBO-API: Ermittlung wirtschaftlich Berechtigter

> Didit ermittelt UBOs aus Unternehmensregistern mit Eigentümerketten, Anteilen und AML-Screening. Ab $2.00 pro Prüfung, je nach Land und Stufe.

## Wirtschaftlich Berechtigte (UBOs)

Zu ermitteln, wem ein Unternehmen letztlich gehört und wer es kontrolliert, ist der Kern von KYB. Didit ruft die Eigentümerstruktur, sofern verfügbar, aus dem Register ab, ermöglicht es dem Unternehmensadministrator, sie im gehosteten Ablauf zu bestätigen und zu ergänzen, und führt anschließend für jede Schlüsselperson eine rollenbasierte Verifizierung durch.

Ein **Ultimate Beneficial Owner (UBO)**, also ein **wirtschaftlich Berechtigter**, ist eine natürliche Person, die eine juristische Person letztlich besitzt oder kontrolliert. UBOs erscheinen in der Entscheidung der Sitzung unter `key_people_checks[].registry.beneficial_owners[]` (aus dem Register abgeleitet) und `key_people_checks[].submitted.parties[]` (vom Nutzer übermittelt). Weitere Rollen, etwa Gesellschafter oder Geschäftsführer, stehen in derselben Liste.

## Erfasste Daten zu jeder Schlüsselperson

Der gehostete Ablauf erfasst einen Standardsatz an Feldern sowie alle zusätzlichen benutzerdefinierten Felder, die im Workflow konfiguriert sind. Die Standardfelder sind:

| Feld | Person | Unternehmen |
| - | :-: | :-: |
| `name` oder `first_name` + `last_name` | ✅ erforderlich | ✅ erforderlich (`company_name`) |
| `email` | ✅ erforderlich | ✅ erforderlich |
| `nationality` / Land | ✅ erforderlich | ✅ erforderlich |
| `role` (eine oder mehrere pro Partei) | ✅ erforderlich | ✅ erforderlich |
| `ownership_percent` / `voting_percent` (pro Rolle) | optional | optional |
| `date_of_birth` | optional | – |
| `phone_number` | optional | – |
| `position` (freier Text für die Berufsbezeichnung) | optional | – |
| `registration_number` | – | optional |
| `entity_type` | `person` | `company` |

`entity_type` wird automatisch gesetzt, je nachdem, ob es sich bei der Partei um eine natürliche Person oder eine juristische Person handelt.

### Benutzerdefinierte Felder

Workflows können pro Person oder pro Unternehmen zusätzliche Felder verlangen, beliebig viele. Sie werden in der Business Console im KYB-Workflow konfiguriert und landen im Objekt `custom_fields` jeder Partei in der Entscheidungsantwort. Verwenden Sie benutzerdefinierte Felder für Angaben wie Erklärungen zur Herkunft von Vermögen, steuerliche Ansässigkeit, interne Kunden-IDs oder branchenspezifische Offenlegungen.

## Gesellschafter als juristische Personen und mehrstufige Eigentümerstrukturen

Ist ein Gesellschafter selbst ein Unternehmen und keine natürliche Person, erfasst Didit:

* Firmenname und Registernummer.
* Den Anteil am Eigentum, den dieser Gesellschafter hält.
* Das Land der Gründung.

So können Sie die Kette über mehrere Ebenen bis zu den letztlich wirtschaftlich berechtigten natürlichen Personen nachverfolgen.

### Verschachteltes KYB für juristische Personen als UBOs

Aktiviert der Workflow verschachteltes KYB für juristische Personen als UBOs, startet jede juristische Partei eine eigene untergeordnete KYB-Teilsitzung. Das Unternehmen wird nach demselben Verfahren geprüft, das Sie auf oberster Ebene einsetzen, und sein Ergebnis fließt in die übergeordnete Sitzung zurück. Diese Option ist standardmäßig deaktiviert und muss pro Workflow aktiviert werden.

## Schwellenwerte für Eigentumsanteile

Die meisten Rechtsordnungen stufen Personen ab **25 % oder mehr** als UBO ein. Der Schwellenwert ist pro Workflow konfigurierbar:

| Rechtsordnung | Üblicher UBO-Schwellenwert |
| - | - |
| EU (AMLD) | 25 % Eigentum oder Kontrolle |
| Vereinigtes Königreich | 25 % der Anteile oder Stimmrechte |
| USA (CTA) | 25 % Eigentum oder wesentliche Kontrolle |
| Singapur | 25 % der Anteile oder Stimmrechte |

Legen Sie ihn fest unter *Workflows → \[KYB-Workflow] → Risk → UBO threshold*. Ihr Workflow kann außerdem markieren oder zur Prüfung weiterleiten, wenn kein UBO den Schwellenwert erreicht. Das kommt bei breit gestreuten börsennotierten Unternehmen häufig vor.

## Stimmrechte und wirtschaftliche Rechte

Angaben zum Eigentum unterscheiden zwei Arten der Kontrolle:

| Recht | Bedeutung |
| - | - |
| **Wirtschaftlicher Anteil (Eigentum) in %** | Anteil am wirtschaftlichen Wert des Unternehmens bzw. an den Dividendenrechten |
| **Stimmrechte in %** | Anteil an der Stimmkraft bei Gesellschafterbeschlüssen |

Beide Werte sind meist gleich, können aber auseinanderfallen, wenn ein Unternehmen Aktien mit unterschiedlichen Klassen oder Vorzugskapital ausgibt. Didit erfasst beide Werte. Regeln und Schwellenwerte können eines der beiden prüfen. Die meisten Rechtsordnungen verlangen die UBO-Offenlegung, sobald *einer* der beiden Werte 25 % überschreitet.

## Wirksames Eigentum über eine Kette

Läuft das Eigentum über einen juristischen Gesellschafter, wird das wirksame Eigentum einer nachgelagerten natürlichen Person berechnet, indem die Prozentwerte entlang der Kette multipliziert werden.

### Beispiel: Kette mit drei Ebenen

```
Acme Corp (target)
  └─ 60% → Acme Holdings Ltd
              └─ 75% → Jane Doe (natural person)
  └─ 40% → John Smith (natural person)
```

Berechnete UBOs:

* **Jane Doe**: wirksames Eigentum an Acme Corp = 60 % × 75 % = **45 %** (UBO).
* **John Smith**: wirksames Eigentum an Acme Corp = **40 %** (UBO).

Bei einem UBO-Schwellenwert von 25 % werden sowohl Jane als auch John offengelegt. Bei einem Schwellenwert von 50 % erreicht keiner der beiden den Grenzwert. Didit kennzeichnet dies als Transparenzproblem.

## Wie Rollen-Einstellungen die Verifizierung steuern

Jede Rolle wird pro KYB-Workflow einzeln konfiguriert: aktiviert oder deaktiviert, ob sie KYC erfordert, welcher KYC-Workflow für diese Rolle verwendet wird und ob der Endbenutzer sie überspringen kann. Wird eine Schlüsselperson übermittelt, passiert Folgendes:

1. Didit prüft die Rollen der übermittelten Partei anhand der Rollen-Einstellungen des Workflows.
2. Für Rollen, die eine Verifizierung erfordern, wird eine untergeordnete Verifizierungssitzung gestartet:
   * **Personen** → untergeordnete Benutzerverifizierung (KYC)-Sitzung, entweder mit dem rollenspezifischen KYC-Workflow oder mit dem Standard-Workflow.
   * **Juristische Personen als UBOs** (wenn verschachteltes KYB aktiviert ist) → untergeordnete Unternehmensverifizierung (KYB)-Teilsitzung.
3. Für Rollen, die sich überspringen lassen, sieht der Endbenutzer die Option „Verifizierung überspringen“ und kann darauf verzichten bzw. die Verifizierung überspringen. Übersprungene Parteien werden erfasst, blockieren aber die übergeordnete Sitzung nicht.
4. Parteien unterhalb des Eigentumsschwellenwerts des Workflows lösen keine individuelle Verifizierung aus, auch wenn die Rolle sie sonst erfordern würde.

Konfigurieren Sie alles in der Business Console unter *Workflows → \[KYB-Workflow] → Key People*.

## Überwachung von Anteilseignern und UBOs

> [!NOTE]
>
> Die Registerüberwachung ist **demnächst verfügbar**. In keinem Land des am 7. September 2026 geprüften Staging-Retail-Katalogs ist die Überwachung aktiviert. Der konfigurierte Preis beträgt USD 2.00 pro Unternehmen und Jahr. Ein Preis bedeutet jedoch nicht, dass die Funktion verfügbar ist. Das folgende Verhalten beschreibt den geplanten Dienst nach der Einführung.

Ein Unternehmen, das auf der Stufe **Anteilseigner** oder **UBO** verifiziert wurde, kann einer **kontinuierlichen Registerüberwachung** unterliegen. Das Register meldet Änderungen des Unternehmensstatus, der Organmitglieder, der Eigentümerstruktur und der eingetragenen Adresse. Bei jeder Änderung führt Didit Folgendes aus:

* Die Unternehmenssitzung wird von *genehmigt* zurück auf *in Prüfung* gesetzt, und die Änderung wird in der Sitzung vermerkt.
* Es wird ein `data.updated`-[Webhook](https://docs.didit.me/de/business-verification/webhooks.md) mit `trigger: "kyb_registry_change"` gesendet.
* Der Registereintrag des Unternehmens wird aktuell gehalten.

Die Überwachung ist **nur in Ländern verfügbar, die sie zulassen**: Der Registeranbieter muss für die jeweilige Rechtsordnung eine Überwachung anbieten. Die vollständige Liste finden Sie in der [Tabelle der Länder mit kontinuierlicher Überwachung](https://docs.didit.me/de/business-verification/supported-countries.md#kontinuierliche-registerüberwachung). Ein Unternehmen, das auf der Stufe Lite verifiziert wurde, oder ein Unternehmen in einem Land außerhalb dieser Liste, wird nicht aufgenommen. Die Unternehmensseite zeigt den Grund an.

Aktivieren Sie die Überwachung pro Workflow unter *Workflows → KYB Registry Check → Advanced → Continuous registry monitoring*. Sie kostet **\$2.00 pro Unternehmen und Jahr** und wird bei der Aufnahme und bei jeder jährlichen Verlängerung abgerechnet. Kann das Wallet eine Verlängerung nicht decken, wird die Überwachung für dieses Unternehmen beendet, statt unbezahlt weiterzulaufen. Sie können die Überwachung jederzeit auf der Unternehmensseite kündigen (*KYB Registry Check → Registry monitoring*).

## Abgleich von Register und übermittelten Daten

Die Antwort zeigt beide Quellen unter `key_people_checks[]` nebeneinander:

* `registry.officers[]` und `registry.beneficial_owners[]`: Was der Anbieter offengelegt hat.
* `submitted.parties[]`: Was der Unternehmensadministrator im Ablauf ausdrücklich übermittelt hat, mit `source: "USER"`.

Analysten vergleichen die beiden Gruppen in der Konsole visuell, um fehlende UBOs, zusätzliche, nicht offengelegte Beteiligte oder Eigentumsprozentsätze, die nicht zusammenpassen, zu erkennen. Es gibt keinen automatisierten Diff-Endpoint. Sie können auf Ihrer Seite abgleichen, indem Sie nach Name, Rolle und gegebenenfalls Eigentumsanteil zuordnen.

## AML-Screening

Jede identifizierte Schlüsselperson wird automatisch gegen globale AML-Beobachtungslisten geprüft, sowohl auf Basis der Registerdaten als auch der übermittelten Daten. Unter [AML-Screening für Unternehmen](https://docs.didit.me/de/business-verification/aml.md) erfahren Sie, wie AML-Prüfungen auf Unternehmensebene und auf Personenebene zusammenwirken.

## Nächste Schritte

> [card] [Schlüsselpersonen](https://docs.didit.me/de/business-verification/key-people.md)
>
> Der Ablauf für Schlüsselpersonen von Anfang bis Ende.

> [card] [Organmitglieder & Vertreter](https://docs.didit.me/de/business-verification/officers.md)
>
> Governance-Rollen im Modell für Schlüsselpersonen.

> [card] [Risikobewertung](https://docs.didit.me/de/business-verification/risk-assessment.md)
>
> Was ein KYB-Ergebnis bestimmt.


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