Benutzer-Datenmodell: Schema für Benutzer beim Anbieter

Diese Seite dokumentiert jedes Feld einer Benutzerentität. Die Felder sind in fünf Gruppen unterteilt: Identität, Status, Sitzungsaggregate, Aktivitätszeitstempel und Metadaten.

Identitätsfelder

Feld	Typ	Beschreibung
`uuid`	UUID	Von Didit vergebener Primärschlüssel. Stabil und eindeutig.
`didit_internal_id`	string	Für Menschen lesbare interne Kennung (wird in API-Antworten ausgegeben).
`vendor_data`	string	Ihre Kennung für den Benutzer. Eindeutig pro Anwendung. Mehr erfahren.
`display_name`	string	Überschreibt den in der Konsole angezeigten Namen. Ist er nicht gesetzt, wird `full_name` oder `vendor_data` verwendet.
`full_name`	string	Vollständiger rechtlicher Name, übernommen aus dem Ausweisdokument der zuletzt genehmigten Benutzerverifizierungs-Sitzung (KYC).
`date_of_birth`	Datum (ISO 8601)	Übernommen aus der zuletzt genehmigten Benutzerverifizierungs-Sitzung (KYC).
`portrait_image`	URL	Signierte S3-URL für das Selfie aus der zuletzt genehmigten Liveness-Erkennung.

full_name, date_of_birth und portrait_image sind schreibgeschützt, wenn sie aus einer verifizierten Sitzung abgeleitet wurden. Sie können sie über die Konsole oder über PATCH /v3/users/{vendor_data}/ überschreiben. Manuelle Überschreibungen werden jedoch im Audit-Log markiert.

Status

Feld	Typ	Werte	Beschreibung
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	Steuert die Durchsetzung für künftige Sitzungen und Transaktionen. Siehe Lebenszyklus.

Felder für Sitzungsaggregate

Diese Felder werden von Didit berechnet und aktualisieren sich in Echtzeit, sobald Sitzungen abgeschlossen werden.

Feld	Typ	Beschreibung
`session_count`	int	Insgesamt jemals für diesen Benutzer erstellte Sitzungen
`approved_count`	int	Sitzungen, die mit `APPROVED` abgeschlossen wurden
`declined_count`	int	Sitzungen, die mit `DECLINED` abgeschlossen wurden
`in_review_count`	int	Derzeit `IN_REVIEW` befindliche Sitzungen
`issuing_states[]`	Array mit ISO-Ländercodes	Ausstellungsländer aller Ausweisdokumente, die über Sitzungen hinweg verifiziert wurden
`approved_emails[]`	Array mit Zeichenketten	Über die E-Mail-Verifizierung verifizierte E-Mail-Adressen
`approved_phones[]`	Array mit Zeichenketten	Über die Telefonverifizierung verifizierte Telefonnummern
`features`	Objekt	Neuester Status jeder Funktion über alle Sitzungen

Die `features`-Map

Jede Sitzung führt eine oder mehrere Funktionen aus (Ausweisverifizierung, Liveness-Erkennung, Gesichtsabgleich, AML, Adressnachweis (POA), NFC usw.). Die features-Map enthält den neuesten Status jeder Funktion für diesen Benutzer:

{
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW",
  "proof_of_address": "APPROVED",
  "nfc_verification": "NOT_FINISHED"
}

Funktionsstatus: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, EXPIRED, ABANDONED, RESUB_REQUESTED. Verwenden Sie die features-Map als schnellen Weg, um zu prüfen, ob ein Benutzer aktuell vollständig verifiziert ist, ohne alle Sitzungen durchzugehen.

Aktivitätszeitstempel

Feld	Typ	Aktualisiert bei
`first_session_at`	ISO-Zeitstempel	Erste Sitzung wurde erstellt
`last_session_at`	ISO-Zeitstempel	Letzte Sitzung wurde erstellt oder aktualisiert
`last_activity_at`	ISO-Zeitstempel	Jede Änderung: Sitzung, Transaktion, Status, Profil, Notizen, Tags
`created_at`	ISO-Zeitstempel	Datensatz wurde erstellt
`updated_at`	ISO-Zeitstempel	Datensatz wurde zuletzt aktualisiert

Metadaten

Feld	Typ	Beschreibung
`metadata`	Objekt (JSON)	Frei gestaltbares JSON, das Sie verwalten. Verwenden Sie es für interne Tags, Stufe, Registrierungsquelle usw.
`tags[]`	Array	In der Konsole bzw. über die API verwaltete Tags zum Filtern und Gruppieren

Metadaten haben kein Schema: Didit speichert alles, was Sie schreiben.

Beziehungen (nicht im Benutzerdatensatz gespeichert)

Beziehung	Zugriff
Sitzungen	`GET /v3/sessions?vendor_data=<value>`
Transaktionen (als Antragsteller)	`GET /v3/transactions/?vendor_data=<value>`
Transaktionen (als Gegenpartei)	In der Konsole die Transaktionsliste nach vendor_data der Gegenpartei filtern
Verknüpfte Unternehmen (Geschäftsführer / UBO)	Wird auf der Benutzerdetailseite in der Konsole angezeigt
Gesichtsbiometrie	Konsole und Lists API
Sperrlisten-Einträge	Lists API: Einträge nach den Kennungen des Benutzers filtern

Beispielantwort

{
  "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "didit_internal_id": "U-2026-00042",
  "vendor_data": "user-42",
  "display_name": "Jane Doe",
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "portrait_image": "https://<media-host>/...",
  "status": "ACTIVE",
  "session_count": 3,
  "approved_count": 2,
  "declined_count": 0,
  "in_review_count": 1,
  "issuing_states": ["US", "ES"],
  "approved_emails": ["jane@example.com"],
  "approved_phones": ["+14155550123"],
  "features": {
    "id_verification": "APPROVED",
    "liveness": "APPROVED",
    "face_match": "APPROVED",
    "aml": "IN_REVIEW"
  },
  "first_session_at": "2025-03-01T12:00:00Z",
  "last_session_at": "2026-04-10T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "tier": "premium" }
}

Nächste Schritte

Vorgänge

Erstellen, aktualisieren, Status ändern, löschen.

KYC-Verlauf

Alle Sitzungen abrufen, die mit dem Benutzer verknüpft sind.

API-Referenz

Schema von GET /v3/users//.

Übersicht

Preise

Workflows & Verifizierung

Prüfung & Betrieb

Entitäten (Benutzer & Unternehmen)

Einstellungen & Anpassung

Sicherheit & Compliance

Didit Academy

Ressourcen

Benutzer-Datenmodell: Schema für Benutzer beim Anbieter

Identitätsfelder

Status

Felder für Sitzungsaggregate

Die `features`-Map

Aktivitätszeitstempel

Metadaten

Beziehungen (nicht im Benutzerdatensatz gespeichert)

Beispielantwort

Nächste Schritte

Vorgänge

KYC-Verlauf

API-Referenz

​Identitätsfelder

​Status

​Felder für Sitzungsaggregate

​Die features-Map

​Aktivitätszeitstempel

​Metadaten

​Beziehungen (nicht im Benutzerdatensatz gespeichert)

​Beispielantwort

​Nächste Schritte

Vorgänge

KYC-Verlauf

API-Referenz

Identitätsfelder

Status

Felder für Sitzungsaggregate

Die `features`-Map

Aktivitätszeitstempel

Metadaten

Beziehungen (nicht im Benutzerdatensatz gespeichert)

Beispielantwort

Nächste Schritte