Benutzer-KYC-Historie: Sitzungen & erneute Verifizierung

Jede KYC-Sitzung zur Benutzerverifizierung, die ein Benutzer je durchgeführt hat, bleibt dauerhaft mit seiner Benutzer-Entität verknüpft. Sie können den vollständigen Verlauf abrufen, einzelne Sitzungsergebnisse prüfen, eine erneute Verifizierung auslösen und Compliance-Berichte exportieren.

Alle Sitzungen eines Benutzers auflisten

Filtern Sie die Sitzungsliste nach vendor_data:

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"

Die Antwort enthält jede Sitzung, unabhängig von ihrem Status: genehmigt, abgelehnt, in Prüfung, abgebrochen oder abgelaufen.

Die Funktionsaggregationen verstehen

Die features-Map der Benutzer-Entität spiegelt den neuesten Status jeder Funktion über alle Sitzungen hinweg wider:

"features": {
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW"
}

Nutzen Sie dies als schnellen Weg, um die Frage „Ist der Benutzer gerade verifiziert?“ zu beantworten. Für den vollständigen Verlauf (alle Sitzungen, alle Funktionen, alle Ergebnisse) listen Sie die Sitzungen auf und prüfen jede Entscheidung.

Eine einzelne Sitzung prüfen

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

Die Entscheidung enthält:

Ergebnisse je Funktion (Ausweis, Liveness, Gesichtsabgleich, AML, Adressnachweis (POA), NFC usw.)
Extrahierte Dokumentdaten und Bilder (signierte URLs)
AML-Treffer mit Übereinstimmungswert und Risiko-Score
Geräte- und IP-Analyse sowie Gerätekontext
Notizen des Prüfers und manuelle Aktionen

Das vollständige Schema finden Sie unter Sitzung abrufen.

Erneute Verifizierung auslösen

Wenn ein Benutzer sich erneut verifizieren muss (z. B. bei einer jährlichen KYC-Erneuerung, Ablauf eines Dokuments oder einer auslöserbasierten erneuten Prüfung):

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_reverification",
    "vendor_data": "user-42"
  }'

Die neue Sitzung wird derselben Benutzer-Entität zugeordnet. Nach Abschluss aktualisiert sich die features-Map der Entität und spiegelt die neuen Ergebnisse wider.

Erneute Einreichung oder neue Sitzung

Szenario	Verwendung
Die Sitzung des Benutzers wurde wegen eines behebbaren Problems abgelehnt (unscharfer Ausweis, schlechte Beleuchtung)	Erneut einreichen: dieselbe Sitzung, neuer Upload
Vollständige erneute Verifizierung oder periodisches erneutes KYC	Erstellen Sie eine völlig neue Sitzung
Nachbesserung, ausgelöst durch eine Transaktionsregel	Die Transaktion erstellt automatisch eine Nachbesserungssitzung (Status `AWAITING_USER`)

Einen Compliance-Bericht exportieren

Für Audits, SARs oder Anfragen von Aufsichtsbehörden erzeugen Sie für jede Sitzung ein PDF:

curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o session-report.pdf

Um den gesamten Verlauf eines Benutzers in einer Datei abzudecken, laden Sie das PDF des Benutzerverlaufs herunter: eine Deckblattseite (Profilzusammenfassung, Funktionsstatus, Sitzungsindex), gefolgt vom vollständigen Bericht jeder berichtspflichtigen Sitzung, die älteste zuerst, begrenzt auf die 20 neuesten.

curl --fail https://verification.didit.me/v3/users/user-42/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o user-history.pdf

Es ist dasselbe Dokument, das die Konsole unter Users → [user] → Actions → Download PDF erzeugt. Für CSV-Massenexporte über viele Benutzer hinweg verwenden Sie den anwendungsweiten Export unter Review & Operations → Export PDF/CSV.

Eine Sitzung mit einem Dritten teilen

Wenn Sie die Verifizierung eines Benutzers mit einer Partner-App teilen möchten (z. B. bei einem Szenario mit wiederverwendbarem KYC), verwenden Sie:

POST /v3/session/{session_id}/share/ erzeugt ein teilbares Token.
POST /v3/session/import-shared/ importiert eine geteilte Sitzung auf der empfangenden Seite.

Das vollständige Muster finden Sie unter Wiederverwendbares KYC.

Historienbasierte Workflows

Nutzen Sie den Sitzungsverlauf, um Compliance-Entscheidungen besser zu steuern:

Schritte überspringen, wenn der Benutzer innerhalb von N Tagen bereits eine genehmigte Liveness-Prüfung hat.
Zusätzliche Prüfungen anfordern, wenn die neueste Sitzung des Benutzers abgelehnt wurde.
Markieren, wenn die Anzahl der Sitzungen eines Benutzers unerwartet stark ansteigt.
AML-Nachprüfungen überwachen im Rahmen der laufenden Überwachung.

Nächste Schritte

Datenmodell

Wie die Funktions-Map und die Zähler berechnet werden.

Sitzung abrufen

Vollständiges Schema der Sitzungsentscheidung.

Wiederverwendbares KYC

Verifizierte Daten über Anwendungen hinweg wiederverwenden.

Übersicht

Preise

Workflows & Verifizierung

Prüfung & Betrieb

Entitäten (Benutzer & Unternehmen)

Einstellungen & Anpassung

Sicherheit & Compliance

Didit Academy

Ressourcen

Benutzer-KYC-Historie: Sitzungen & erneute Verifizierung

Alle Sitzungen eines Benutzers auflisten

Die Funktionsaggregationen verstehen

Eine einzelne Sitzung prüfen

Erneute Verifizierung auslösen

Erneute Einreichung oder neue Sitzung

Einen Compliance-Bericht exportieren

Eine Sitzung mit einem Dritten teilen

Historienbasierte Workflows

Nächste Schritte

Datenmodell

Sitzung abrufen

Wiederverwendbares KYC

​Alle Sitzungen eines Benutzers auflisten

​Die Funktionsaggregationen verstehen

​Eine einzelne Sitzung prüfen

​Erneute Verifizierung auslösen

​Erneute Einreichung oder neue Sitzung

​Einen Compliance-Bericht exportieren

​Eine Sitzung mit einem Dritten teilen

​Historienbasierte Workflows

​Nächste Schritte

Datenmodell

Sitzung abrufen

Wiederverwendbares KYC

Alle Sitzungen eines Benutzers auflisten

Die Funktionsaggregationen verstehen

Eine einzelne Sitzung prüfen

Erneute Verifizierung auslösen

Erneute Einreichung oder neue Sitzung

Einen Compliance-Bericht exportieren

Eine Sitzung mit einem Dritten teilen

Historienbasierte Workflows

Nächste Schritte