Zum Hauptinhalt springen
Jede Benutzer- und Unternehmensentität in Didit durchläuft einen vorhersehbaren Lebenszyklus. Dieser Lebenszyklus ist der Schlüssel zur Gestaltung Ihrer Abläufe für Onboarding, laufende Überwachung und Behebung.

​
Lebenszyklusdiagramm

​
Status im Detail

Durch eine Statusänderung über PATCH /v3/users/{vendor_data}/update-status/ oder PATCH /v3/businesses/{vendor_data}/update-status/ wird ein Webhook (user.status.updated / business.status.updated) ausgelöst, damit nachgelagerte Systeme in Echtzeit reagieren können.

​
Phasen des Lebenszyklus

Erstellung

Eine Entität wird auf eine von drei Arten erstellt:
  • Automatisch erstellt, wenn Sie eine Sitzung mit einer neuen vendor_data starten. Die Entität wird im Status ACTIVE angelegt.
  • Vorab per API erstellt über POST /v3/users/create/ oder POST /v3/businesses/create/. Der Status ist standardmäßig ACTIVE.
  • In der Konsole erstellt durch einen Compliance-Beauftragten. Der Status beginnt mit ACTIVE, sofern der Beauftragte nichts anderes angibt.
Jede Entität erhält eine von Didit generierte uuid und eine kundeneigene vendor_data-Kennung.

Verifizierung

Sitzungen werden über vendor_data mit der Entität verknüpft. Jede Sitzung läuft über Ihren konfigurierten Workflow: Ausweisverifizierung, Liveness-Erkennung, Gesichtsabgleich, AML, Dokumente, Registerabfrage für KYB und so weiter.Abgeschlossene Sitzungen aktualisieren die aggregierten Zähler der Entität:
  • session_count, approved_count, declined_count, in_review_count
  • features-Map: der jeweils neueste Status jeder Funktion über alle Sitzungen (z. B. { "id_verification": "APPROVED", "aml": "IN_REVIEW" })
  • Profilfelder werden aus der neuesten genehmigten Sitzung übernommen (z. B. full_name, date_of_birth, portrait_image).

Aktive Nutzung

Sobald eine Entität eine oder mehrere genehmigte Sitzungen hat, können Sie:
  • Transaktionen einreichen, die sich über vendor_data im Transaktions-Payload auf die Entität beziehen
  • Laufende AML-Überwachung ausführen: periodische Neuprüfungen anhand von Sanktionslisten sowie Listen politisch exponierter Personen und negativer Medienberichte
  • Erneut verifizieren nach Zeitplan: neue Sitzungen für dieselbe vendor_data in regelmäßigen Abständen erstellen
  • Risikosignale aggregieren über Sitzungen und Transaktionen

Statusübergänge

Der Status einer Entität ändert sich automatisch oder manuell.Automatische Übergänge
  • ACTIVE → FLAGGED, wenn eine Transaktion den Prüfschwellenwert überschreitet oder eine Regel die Entität auf eine Beobachtungsliste setzt.
  • ACTIVE → BLOCKED, wenn eine Gesichtsbiometrie mit einem Eintrag der Sperrliste übereinstimmt.
Eine abgelehnte Sitzung setzt die Entität nicht auf die Sperrliste, daher bleibt ihr Status unverändert. Die Aufnahme einer abgelehnten Person auf die Sperrliste ist ein manueller Schritt: Fügen Sie den Eintrag über die Sperrlistenseite oder die Lists-API hinzu. Ein Eintrag vom Typ USER (die vendor_data) setzt den Status auf BLOCKED.Manuelle Übergänge erfolgen, wenn ein Analyst den Status in der Konsole ändert oder wenn Sie den Endpoint update-status aufrufen.Jeder Übergang löst einen Webhook user.status.updated oder business.status.updated aus.

Löschung

Entitäten werden über POST /v3/users/delete/ oder POST /v3/businesses/delete/ (Batch) gelöscht. Der Entitätsdatensatz wird dauerhaft entfernt. Beim Löschen eines Benutzers werden außerdem alle biometrischen Templates entfernt, die nach dem Löschen der Sitzung für ihn aufbewahrt wurden. Dadurch wird die Person bei der Duplikaterkennung und der Gesichtssuche nicht mehr als Übereinstimmung erkannt.Verifizierungssitzungen werden von diesen Endpoints nicht erfasst, ebenso wenig Transaktionen. Löschen Sie Sitzungen mit Sitzung löschen oder Sitzungen im Batch löschen. Transaktionen werden in der Konsole gelöscht.

​
Aktivitätszeitstempel

Entitäten erfassen Aktivitäten, damit Sie veraltete oder aktive Profile erkennen können: Verwenden Sie diese Zeitstempel, um inaktive Entitäten zu filtern, erneute Verifizierungen zu planen oder die laufende Überwachung auszulösen.

​
Ereignisse während des Lebenszyklus

Informationen zu den Payload-Strukturen und zur Zustellung finden Sie unter Entitäts-Webhooks.

​
Nächste Schritte

Verknüpfung von Vendor-Daten

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

Benutzervorgänge

Benutzer-Entitäten erstellen, aktualisieren, Status ändern und löschen.

Unternehmensvorgänge

Unternehmens-Entitäten erstellen, aktualisieren, Status ändern und löschen.
Zuletzt geändert am 7. November 2026