Benutzer & Unternehmen: Entitäten bei Didit

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:

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.

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.

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

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" }'

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. Weitere Informationen finden Sie im Leitfaden zur Verknüpfung über vendor_data.

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 und Unternehmen.

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

Nächste Schritte

Lebenszyklus

Zustände, Übergänge und Lebenszyklusereignisse für jede Entität.

Verknüpfung über vendor_data

Wie vendor_data Sitzungen, Transaktionen und Entitäten miteinander verknüpft.

Benutzer

Vertiefung zu Benutzerentitäten, Vorgängen und Abläufen in der Konsole.

Unternehmen

Vertiefung zu Unternehmensentitäten, Vorgängen und Abläufen in der Konsole.

Entitäts-Webhooks

Echtzeitereignisse für jede Änderung an einer Entität.

Sperrliste

Wie Sperrlisteneinträge mit Benutzer- und Unternehmensentitäten zusammenwirken.

Übersicht

Preise

Workflows & Verifizierung

Prüfung & Betrieb

Entitäten (Benutzer & Unternehmen)

Einstellungen & Anpassung

Sicherheit & Compliance

Didit Academy

Ressourcen

Benutzer & Unternehmen: Entitäten bei Didit

Entität und Sitzung

Automatische Erstellung oder manuelle Vorab-Erstellung

Wie Entitäten alles miteinander verknüpfen

Was Sie mit einer Entität tun können

Beziehungen zwischen Benutzern und Unternehmen

Lebenszyklus und Status

Nächste Schritte

Lebenszyklus

Verknüpfung über vendor_data

Benutzer

Unternehmen

Entitäts-Webhooks

Sperrliste

​Entität und Sitzung

​Automatische Erstellung oder manuelle Vorab-Erstellung

​Wie Entitäten alles miteinander verknüpfen

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

​Beziehungen zwischen Benutzern und Unternehmen

​Lebenszyklus und Status

​Nächste Schritte

Lebenszyklus

Verknüpfung über vendor_data

Benutzer

Unternehmen

Entitäts-Webhooks

Sperrliste

Entität und Sitzung

Automatische Erstellung oder manuelle Vorab-Erstellung

Wie Entitäten alles miteinander verknüpfen

Was Sie mit einer Entität tun können

Beziehungen zwischen Benutzern und Unternehmen

Lebenszyklus und Status

Nächste Schritte