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

# Vendor Users: Persistenter KYC-Datensatz

> Didit speichert Vendor Users als persistenten Identitätsdatensatz: KYC-Historie, Biometrie, Dokumente, Transaktionen, Sperrlistenstatus.

A **Benutzer-Entität** steht für eine einzelne Person (Ihr Kunde, Endbenutzer oder Antragsteller) und umfasst alle Verifizierungs-, Transaktions- und Compliance-Interaktionen, die diese Person auf Didit über Ihre Plattform hat.

Sobald ein Benutzer existiert, fließen alle Aktivitäten mit demselben `vendor_data` in dasselbe Profil. Sie erhalten so eine einheitliche Sicht auf Identität, Risiko und Compliance jeder Person.

## Was zu einem Benutzer gehört

| Kategorie | Felder / Objekte |
| - | - |
| **Identität** | `vendor_data`, `uuid`, `display_name`, `full_name`, `date_of_birth`, `portrait_image` |
| **Status** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Sitzungsaggregate** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, `features`-Map |
| **Verifizierte Kontaktdaten** | `approved_emails[]`, `approved_phones[]` |
| **Geografie** | `issuing_states[]` (aus verifizierten Ausweisdokumenten) |
| **Aktivität** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Biometrie** | Zugeordnete Gesichtsdaten (für Suche, Duplikaterkennung und Sperrliste) |
| **Dokumente** | Ausweisdokumente, Adressnachweise und Selfies aus Sitzungen |
| **Beziehungen** | Verknüpfte Unternehmens-Entitäten (wenn der Benutzer Geschäftsführer oder UBO von Unternehmen ist, die in Ihrer App verifiziert wurden) |
| **Metadaten** | Beliebiges JSON für Ihre eigenen Daten |

Details zu Typen, Indizes und Sonderfällen finden Sie im vollständigen [Benutzer-Datenmodell](https://docs.didit.me/de/entities/users/data-model.md).

## Wann ein Benutzer angelegt wird

**1. Automatisch: bei der ersten Sitzung mit einem neuen vendor\_data**

Der Regelfall. Sie rufen `POST /v3/session/` mit einem `vendor_data`-Wert auf, den Didit noch nie gesehen hat. Eine Benutzer-Entität wird im Status `ACTIVE` angelegt und mit dieser Sitzung verknüpft.

**2. Explizit: über POST /v3/users/create/**

Sie legen den Benutzer an, bevor eine Sitzung läuft. Nützlich, um Metadaten vorzubefüllen, einen Anfangsstatus festzulegen oder Kunden aus einer bestehenden Datenbank per Massen-Onboarding aufzunehmen.

**3. Über die Konsole**

Ein Compliance-Beauftragter legt den Benutzer auf der Benutzerseite an, zum Beispiel beim Onboarding eines manuell verifizierten Kunden.

## Was Sie tun können

| Operation | Vorgehensweise |
| - | - |
| [Benutzer auflisten](https://docs.didit.me/de/entities/users/operations.md#benutzer-auflisten) | `GET /v3/users/` mit Filtern (Status, Datum, Land) |
| [Benutzer abrufen](https://docs.didit.me/de/entities/users/operations.md#einen-benutzer-abrufen) | `GET /v3/users/{vendor_data}/` |
| [Benutzer anlegen](https://docs.didit.me/de/entities/users/operations.md#benutzer-erstellen) | `POST /v3/users/create/` |
| [Profil aktualisieren](https://docs.didit.me/de/entities/users/operations.md#benutzer-aktualisieren) | `PATCH /v3/users/{vendor_data}/` |
| [Status ändern](https://docs.didit.me/de/entities/users/operations.md#status-ändern) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [Benutzer löschen](https://docs.didit.me/de/entities/users/operations.md#benutzer-löschen-batch) | `POST /v3/users/delete/` (Batch) |
| [Gesichter hinzufügen / suchen](https://docs.didit.me/de/entities/users/faces-and-biometrics.md) | Konsole + Lists API für Sperrlisten |
| [Dokumente einsehen](https://docs.didit.me/de/entities/users/documents.md) | Über Sitzungsentscheidungen |
| [Zur Sperrliste hinzufügen](https://docs.didit.me/de/entities/users/blocklist.md) | Konsole + Lists API |
| [KYC-Verlauf prüfen](https://docs.didit.me/de/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Transaktionen prüfen](https://docs.didit.me/de/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Importieren / exportieren](https://docs.didit.me/de/entities/users/import-export.md) | Nur über die Konsole (CSV) |
| [In der Konsole verwalten](https://docs.didit.me/de/entities/users/console.md) | Vollständige Anleitung zur Benutzeroberfläche |

## Benutzer und Unternehmen

Ein einzelner Benutzer kann mit einer oder mehreren Unternehmens-Entitäten verknüpft sein, zum Beispiel wenn dieselbe Person Geschäftsführer einer Firma und UBO einer anderen ist. Didit behält diese Verknüpfungen automatisch bei, wenn [KYB](https://docs.didit.me/de/business-verification/overview.md) Personen aus Unternehmensregistern identifiziert.

## Beziehung Benutzer ↔ Sitzung

```mermaid theme={null}
flowchart LR
    U[User entity<br/>vendor_data = user-42]
    S1["User Verification (KYC) session #1<br/>(approved 2025-01)"]
    S2["User Verification (KYC) session #2<br/>(resubmit, in review)"]
    S3["User Verification (KYC) session #3<br/>(re-verification 2026-01)"]
    S1 --> U
    S2 --> U
    S3 --> U
```

Die Benutzer-Entität fasst den **neuesten** Stand jeder Funktion über alle Sitzungen hinweg zusammen. Eine fehlgeschlagene `aml`-Prüfung in der jüngsten Sitzung erscheint im Feld `features.aml` des Benutzers, auch wenn ältere Sitzungen genehmigt wurden.

## Nächste Schritte

> [card] [Datenmodell](https://docs.didit.me/de/entities/users/data-model.md)
>
> Alle Felder, Typen und Indizes.

> [card] [Operationen](https://docs.didit.me/de/entities/users/operations.md)
>
> Anlegen, aktualisieren, Status ändern, löschen.

> [card] [Gesichter und Biometrie](https://docs.didit.me/de/entities/users/faces-and-biometrics.md)
>
> Ein Gesicht für die Suche und zum Hinzufügen zu einer Sperrliste hinterlegen.

> [card] [Sperrliste](https://docs.didit.me/de/entities/users/blocklist.md)
>
> So funktioniert das Hinzufügen von Benutzern zu einer Sperrliste.

> [card] [KYC-Verlauf](https://docs.didit.me/de/entities/users/kyc-history.md)
>
> Jede Sitzung, die dem Benutzer zugeordnet ist.

> [card] [Konsole](https://docs.didit.me/de/entities/users/console.md)
>
> Vollständige Anleitung zur Benutzeroberfläche.


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