Zum Hauptinhalt springen
Jedes Dokument, das ein Benutzer während der Verifizierung hochlädt, ist dauerhaft mit seiner Benutzerentität verknüpft. Diese Seite erklärt, welche Daten erfasst werden, wie Sie sie abrufen und wie Sie zusätzliche Dokumente manuell hochladen.

​
Was Didit erfasst

Unterstützte Dokumenttypen deckt die vollständige Matrix aus Land und Dokumenttyp ab (14,000+ Dokumente in 220+ Ländern).

​
Dokumente abrufen

Dokumente sind der Sitzung zugeordnet, in der sie erfasst wurden, nicht direkt dem Benutzer. Um alle Dokumente eines Benutzers aufzulisten:
1

Sitzungen des Benutzers auflisten

2

Entscheidung jeder Sitzung abrufen

Jede Sitzungsentscheidung enthält URLs zu den erfassten Dokumenten.
Prüfen Sie in der Antwort die Felder id_verification.document_images, proof_of_address.document_images und liveness.images.
3

Signierte URLs verwenden

Bild-URLs in der Antwort sind kurzlebige signierte URLs. Speichern Sie sie clientseitig für die Dauer der Nutzung, oder rufen Sie die Entscheidung erneut ab, wenn sie ablaufen.

​
PDF-Bericht erstellen

Für einen lesbaren Export aller für eine Sitzung erfassten Daten, einschließlich aller Dokumente, verwenden Sie: GET /v3/session/{session_id}/generate-pdf/ Gibt ein PDF mit Sitzungsdetails, Funktionsergebnissen und eingebetteten Dokumentbildern zurück. Nützlich für Compliance-Audits, SAR-Anhänge und behördliche Einreichungen.

​
Dokumente aus der Konsole hochladen

Compliance-Beauftragte können zusätzliche Dokumente zu einem Benutzer oder einer aktiven Sitzung hochladen:
  1. Navigieren Sie zu Users → [user] → Documents → Upload document.
  2. Wählen Sie einen Dokumenttyp (ID, POA, benutzerdefiniert).
  3. Laden Sie eine Datei hoch. Für unterstützte Typen läuft OCR automatisch.
  4. Das Dokument wird der neuesten Sitzung zugeordnet (oder Sie erstellen eine Korrektursitzung).
Die Upload-Oberfläche für Dokumente ist nur in der Konsole verfügbar. Es gibt keinen öffentlichen API-Endpoint, um Dokumente direkt einem Benutzer zuzuordnen. Verwenden Sie Sitzungen als Einstiegspunkt für jede Dokumenterfassung.

​
Querprüfung von Dokumenten

Erfasst eine Sitzung mehrere Dokumenttypen, gleicht Didit sie miteinander ab:
  • ID ↔ Liveness: Das Gesicht im Ausweis stimmt mit dem Selfie aus der Liveness-Erkennung überein.
  • ID ↔ POA: Der Name im Adressnachweis stimmt mit dem Namen überein, der aus dem Ausweis extrahiert wurde.
  • ID ↔ NFC: MRZ- bzw. visuelle Daten stimmen mit den NFC-Chipdaten überein.
Inkonsistenzen werden als Warnungen in der Sitzungsentscheidung angezeigt und können so konfiguriert werden, dass sie eine manuelle Prüfung auslösen.

​
Dokumentenüberwachung und erneute Verifizierung

Für Anwendungsfälle, die eine laufende Gültigkeitsprüfung von Dokumenten erfordern (z. B. abgelaufene Ausweise):
  • Das Ablaufdatum des Dokuments wird bei jedem verifizierten Ausweis nachverfolgt. Fragen Sie in der Sitzungsentscheidung das Feld expiration_date ab.
  • Dokumentüberwachung ist standardmäßig aktiviert und läuft automatisch: Es muss nichts aktiviert werden. Wenn das Ablaufdatum des Ausweises verstreicht, wechselt eine Sitzung mit dem Status "Approved" zu "Kyc Expired", das Ergebnis der Ausweisverifizierung erhält eine DOCUMENT_EXPIRED-Warnung, und ein status.updated-Webhook wird ausgelöst. Vor dem Ablaufdatum wird keine Warnung gesendet.
  • Deaktivieren: Setzen Sie in den Einstellungen der ID-Verifizierung für das betreffende Land und den Dokumenttyp Expiration mode auf Allow expired. Reject expired ist der Standardmodus und der Modus, in dem überwacht wird. Ein Dokument, das im Modus Allow expired akzeptiert wurde, wird nie überwacht.
  • Erneute Verifizierung: Starten Sie eine neue Sitzung mit demselben vendor_data, um die Dokumente zu aktualisieren.

​
Geolokalisierung von Dokumenten

Die Geolokalisierungsprüfung des ID-Dokuments vergleicht den IP-Standort des Einreichenden mit dem Ausstellungsland des Ausweises. Die Ergebnisse werden der Sitzungsentscheidung beigefügt.

​
Datenschutz und Aufbewahrung

  • Alle Dokumente sind im Ruhezustand verschlüsselt.
  • Der Zugriff auf Bilder erfolgt über kurzlebige signierte URLs.
  • Die Aufbewahrung richtet sich nach der Richtlinie zur Datenaufbewahrung der Anwendung.
  • Benutzer haben das Recht, eine Löschung zu verlangen. Bei einer Löschung werden Bilder, OCR-Extrakte und NFC-Daten entfernt.

​
Nächste Schritte

Ausweisverifizierung

Wie die Ausweiserfassung und OCR funktionieren.

Adressnachweis

Erfassung von POA-Dokumenten.

Entscheidung der Sitzung

Referenz zu GET /v3/session//decision/.
Zuletzt geändert am 7. November 2026