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

# Benutzer & Unternehmen: Entitäten bei Didit

> Benutzer und Unternehmen sind die zentralen Entitäten bei Didit. Jede bündelt KYC, Transaktionen, Dokumente, Biometrie und Risiko in einem Profil.

Didit ordnet alles, was in Ihrer Anwendung geschieht, um zwei zentrale Entitätstypen herum.

| Entität | Steht für | Verknüpft mit |
| - | - | - |
| **Benutzer** | Eine einzelne Person | Benutzerverifizierungs-Sitzungen (KYC), Gesichtsbiometrie, Transaktionen (als Antragsteller oder Gegenpartei), Sperrlisten |
| **Unternehmen** | Eine juristische Person (Kapitalgesellschaft, LLC, Einzelunternehmen, Fonds) | Unternehmensverifizierungs-Sitzungen (KYB), Organmitglieder, wirtschaftlich Berechtigte (UBOs), Transaktionen (als Antragsteller oder Gegenpartei), Sperrlisten |

Jede Verifizierungssitzung, jede Transaktion und jeder Sperrlisteneintrag kann einer Entität zugeordnet werden. Sobald die Zuordnung besteht, wird die Entität zu einem dauerhaften Profil, das Verlauf, Risikosignale und Compliance-Status über die Zeit hinweg zusammenführt.

## Entität und Sitzung

Eine **Entität** und eine **Sitzung** sind unterschiedliche Dinge.

| Konzept | Umfang | Lebensdauer | Beispiel |
| - | - | - | - |
| **Sitzung** | Ein Verifizierungsereignis | Einzelner Ablauf (Minuten bis Tage, solange sie in Prüfung ist) | Ein einzelner KYC-Versuch |
| **Entität** | Ein dauerhaftes Profil | Besteht, solange der Benutzer oder das Unternehmen auf Ihrer Plattform existiert | Die Kundin „Jane Doe“ mit 3 Benutzerverifizierungs-Sitzungen (KYC) über 2 Jahre |

Eine einzelne Entität kann viele Sitzungen haben, etwa erneute Verifizierungen, erneute Einreichungen, zusätzliche Prüfungen oder regelmäßige laufende Überwachung. Die Entität fasst die Ergebnisse zusammen.

## Automatische Erstellung oder manuelle Vorab-Erstellung

Entitäten werden auf drei Wegen erstellt:

**1. Automatisch aus einer Sitzung erstellt**

Wenn Sie eine Sitzung mit einer `vendor_data`-Kennung erstellen und keine passende Entität existiert, erstellt Didit die Entität automatisch. Dies ist der häufigste Weg.

```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "workflow_id": "wf_kyc_standard", "vendor_data": "user-42" }'
```

Eine Benutzer-Entität für `user-42` wird im Moment des Sitzungsstarts erstellt.

**2. Über die Management API vorab erstellt**

Erstellen Sie zuerst die Entität und starten Sie dann Sitzungen für diese Entität. Das ist nützlich, wenn Sie Risikosignale (Status, Tags, benutzerdefinierte Metadaten) vor der ersten Verifizierung hinterlegen möchten.

```bash theme={null}
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "vendor_data": "user-42", "display_name": "Jane Doe" }'
```

**3. In der Konsole erstellt**

Ihr Compliance-Team kann Benutzer oder Unternehmen direkt in der Business Console anlegen. Das ist hilfreich für manuelles Onboarding, Importe oder Behebungsprozesse.

## Wie Entitäten alles miteinander verknüpfen

Das Feld `vendor_data` ist der Verknüpfungsschlüssel. Wenn Sie `vendor_data` bei einer Sitzung oder Transaktion übergeben, ordnet Didit sie der passenden Entität zu.

```mermaid theme={null}
flowchart LR
    VD["vendor_data:<br/>user-42"] --> U[User entity]
    S1[User Verification (KYC) session #1] --> VD
    S2[User Verification (KYC) session #2] --> VD
    T1[Transaction #1] --> VD
    T2[Transaction #2] --> VD
    F[Face biometric] --> VD
    D[Documents] --> VD
    BL[Blocklist entry] --> VD
```

Weitere Informationen finden Sie im [Leitfaden zur Verknüpfung über `vendor_data`](https://docs.didit.me/de/entities/vendor-data-linking).

## Was Sie mit einer Entität tun können

Für jede Benutzer- oder Unternehmensentität können Sie Folgendes tun:

| Vorgang | Zweck |
| - | - |
| **Erstellen / Aktualisieren** | Profildaten der Entität festlegen oder ändern (Name, Land, benutzerdefinierte Metadaten) |
| **Status ändern** | Als `ACTIVE`, `FLAGGED` oder `BLOCKED` markieren. Die Durchsetzung gilt für künftige Sitzungen und Transaktionen. |
| **Biometrie hinzufügen** | Eine Gesichtsreferenz für 1:N-Suche, Duplikatserkennung oder Sperrung hochladen |
| **KYC- bzw. KYB-Verlauf prüfen** | Jede Sitzung abrufen, die mit der Entität verknüpft ist, mit den Ergebnissen je Funktion |
| **Transaktionsverlauf prüfen** | Jede Transaktion abrufen, bei der die Entität Antragsteller oder Gegenpartei ist |
| **Zur Sperrliste hinzufügen** | Künftige Sitzungen oder Transaktionen mit dieser Entität blockieren |
| **Importieren / Exportieren** | Entitäten per CSV in großer Menge hochladen oder für externe Compliance-Werkzeuge exportieren |
| **Löschen** | Die Entität löschen (der Verlauf wird aus Auditgründen beibehalten) |

Ausführliche Anleitungen finden Sie unter [Benutzer](https://docs.didit.me/de/entities/users/overview.md) und [Unternehmen](https://docs.didit.me/de/entities/businesses/overview.md).

## Beziehungen zwischen Benutzern und Unternehmen

Ein einzelner Benutzer kann mit einem oder mehreren Unternehmen verknüpft sein. Das ergibt sich bei KYB ganz natürlich:

* Ein Benutzer kann **Geschäftsführer** eines Unternehmens und **UBO** eines anderen sein.
* Die Benutzerverifizierungs-Sitzung (KYC) eines Benutzers kann über den Ablauf für [Schlüsselpersonen](https://docs.didit.me/de/business-verification/key-people.md) mit der Unternehmensverifizierungs-Sitzung (KYB) eines Unternehmens verknüpft werden.

Didit bewahrt diese Beziehungen. Wenn Sie eine Unternehmensentität prüfen, sehen Sie jeden verknüpften Benutzer. Wenn Sie eine Benutzerentität prüfen, sehen Sie jedes Unternehmen, mit dem diese Person verbunden ist.

## Lebenszyklus und Status

Jede Entität hat einen Status, der bestimmt, ob Didit Sperren für neue Aktivitäten durchsetzt:

| Status | Auswirkung |
| - | - |
| `ACTIVE` | Normal: Sitzungen und Transaktionen laufen wie durch Workflows und Regeln konfiguriert ab |
| `FLAGGED` | Sitzungen und Transaktionen sind erlaubt, werden aber automatisch zur manuellen Prüfung weitergeleitet |
| `BLOCKED` | Sitzungen und Transaktionen werden automatisch abgelehnt, und es können keine neuen Sitzungen erstellt werden |

Alle Übergänge und Webhook-Ereignisse finden Sie im vollständigen [Entitäts-Lebenszyklus](https://docs.didit.me/de/entities/lifecycle.md).

## Nächste Schritte

> [card] [Lebenszyklus](https://docs.didit.me/de/entities/lifecycle.md)
>
> Zustände, Übergänge und Lebenszyklusereignisse für jede Entität.

> [card] [Verknüpfung über vendor\_data](https://docs.didit.me/de/entities/vendor-data-linking.md)
>
> Wie `vendor_data` Sitzungen, Transaktionen und Entitäten miteinander verknüpft.

> [card] [Benutzer](https://docs.didit.me/de/entities/users/overview.md)
>
> Vertiefung zu Benutzerentitäten, Vorgängen und Abläufen in der Konsole.

> [card] [Unternehmen](https://docs.didit.me/de/entities/businesses/overview.md)
>
> Vertiefung zu Unternehmensentitäten, Vorgängen und Abläufen in der Konsole.

> [card] [Entitäts-Webhooks](https://docs.didit.me/de/entities/webhooks.md)
>
> Echtzeitereignisse für jede Änderung an einer Entität.

> [card] [Sperrliste](https://docs.didit.me/de/console/blocklist-users.md)
>
> Wie Sperrlisteneinträge mit Benutzer- und Unternehmensentitäten zusammenwirken.


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