Zum Hauptinhalt springen
Mit der Business Console kann Ihr Team Benutzerentitäten in großer Zahl verwalten, ohne Code zu schreiben. Es werden zwei Abläufe unterstützt: CSV-Import (Benutzer in großer Menge anlegen oder aktualisieren) und CSV-Export (die Benutzertabelle für externe Tools extrahieren).
Der Massenimport und -export dient hier nur dazu, Benutzerprofile zu erstellen oder zu aktualisieren. Historische KYC-Sitzungen, Dokumentwarnungen, Liveness-Nachweise und Entscheidungen von Anbietern werden dabei nicht neu angelegt. Für eine vollständige Migration von Sumsub, MetaMap, Veriff, Onfido, Persona oder einem anderen Anbieter siehe Daten von einem anderen Anbieter importieren.

Benutzer aus CSV importieren

Wann Sie das verwenden sollten

  • Erstmigration von einem anderen KYC-Anbieter: Übernehmen Sie Ihren bestehenden Benutzerbestand.
  • Migration von Gesichtsdaten eines Anbieters: Hängen Sie vertrauenswürdige Gesichtsbilder an die importierten Benutzerprofile an, nachdem die Zeilen angelegt wurden.
  • Massen-Onboarding einer Kundenliste eines Partners.
  • Nachträgliches Befüllen von Metadaten: Aktualisieren Sie Tags, Stufe oder interne Kennungen für viele Benutzer gleichzeitig.

Vorlagenspalten

Laden Sie die Vorlage unter Users → Import → Download template herunter. Spalten:

Import ausführen

1

CSV hochladen

Öffnen Sie Users → Import → Upload CSV und wählen Sie Ihre Datei aus.
2

Vorschau prüfen

Die Console validiert jede Zeile. Ungültige Zeilen werden mit Fehlergründen markiert (z. B. doppelter vendor_data oder ungültiger Ländercode).
3

Import starten

Didit verarbeitet die Zeilen asynchron. Sie können den Tab schließen; den Fortschritt sehen Sie unter Users → Import history.
4

Ergebnisse prüfen

Sobald der Import abgeschlossen ist, zeigt die Verlaufsansicht die Anzahl der angelegten, aktualisierten und übersprungenen Zeilen sowie einen herunterladbaren Fehlerbericht.

Aktualisieren oder anlegen

  • Wenn ein vendor_data noch nicht existiert, wird ein neuer Benutzer angelegt.
  • Wenn ein vendor_data bereits existiert, aktualisiert die Zeile den vorhandenen Benutzer (Profilfelder und Metadaten).
  • Aggregierte Zähler und verifizierte Felder (full_name, date_of_birth aus genehmigten Sitzungen) werden durch Importe niemals überschrieben.

Gesichter nach der Benutzererstellung importieren

Der CSV-Import legt die Benutzerzeile an oder aktualisiert sie. Gesichtsbilder sind in der CSV-Datei nicht enthalten. Um biometrische Gesichtsdaten von einem anderen Anbieter zu übernehmen, laden Sie jedes Gesicht hoch, nachdem der Ziel-Benutzer existiert:
1

Benutzer anlegen oder importieren

Verwenden Sie den CSV-Import in der Console oder rufen Sie POST /v3/users/create/ in einer Schleife auf.
2

didit_internal_id auslesen

Rufen Sie den Benutzer mit GET /v3/users/{vendor_data}/ ab. Die Antwort enthält didit_internal_id.
3

Gesicht hochladen

Das Gesicht muss ein gültiges Bild sein, nach der Dekodierung maximal 2 MB groß sein und ein erkennbares Gesicht enthalten. Didit speichert es im Profil und indexiert es für die Duplikaterkennung und die Gesichtssuche. Es wird nur dann in eine Gesichts-Sperrliste aufgenommen, wenn Sie zusätzlich den Endpoint Gesicht zu einer Liste hochladen verwenden.

Benutzer nach CSV exportieren

Wann Sie das verwenden sollten

  • Compliance-Prüfungen: Stellen Sie den vollständigen Benutzerbestand den Prüfern zur Verfügung.
  • Synchronisation mit dem Data Warehouse: regelmäßiger Export in Ihre BI-Tools.
  • SAR-Anfragen und Anfragen von Aufsichtsbehörden: Extrahieren Sie gefilterte Teilmengen von Benutzern.

Export ausführen

  1. Öffnen Sie Users → Export.
  2. Wenden Sie Filter an (Status, Land, Datumsbereich, Suche).
  3. Wählen Sie die Spalten aus. Standardmäßig sind alle Felder enthalten; Sie können Spalten entfernen, die Sie nicht benötigen.
  4. Senden Sie den Export ab. Didit erstellt den Export asynchron und sendet einen signierten Download-Link per E-Mail an den anfragenden Bediener.
Exporte enthalten nur Daten, die Ihre Rolle lesen darf. COMPLIANCE_OFFICER und höhere Rollen können die vollständige Tabelle exportieren; die Rollen DEVELOPER und READER haben eingeschränkte Exporte.

Leistungsmerkmale

Audit-Trail

Jeder Import und jeder Export wird im Audit-Log protokolliert:
  • Der Bediener, der ihn ausgelöst hat.
  • Zeilenanzahl (Importe) bzw. Momentaufnahme der Filter (Exporte).
  • Zeitstempel und Erfolgs- bzw. Fehlerstatus.

Nächste Schritte

API zum Anlegen von Benutzern

Programmatisches Anlegen für skriptgesteuerte Importe.

Benutzergesicht hochladen

Importierte Gesichtsbilder an Benutzerprofile anhängen.

Datenaufbewahrung

Wie lange importierte Daten gespeichert bleiben.

Audit-Logs

Import- und Export-Verlauf einsehen.
Zuletzt geändert am 7. November 2026