Gesichtsabgleich 1:1-API: Selfie- und Ausweisabgleich

​

Wiederholungsversuche und umsetzbares Feedback

• Versuchsbudget – face_match_max_attempts steuert die Gesamtzahl der Gesichtsabgleich-Übermittlungen pro Sitzung. Standardwert ist 3 (ein erster Versuch plus zwei Wiederholungsversuche), konfigurierbar pro Workflow-Knoten (Bereich 1–3).
• Feedback bei Wiederholung – solange noch Versuche verbleiben, hält ein Fehler, der einen Wiederholungsversuch zulässt, den Benutzer im jeweiligen Schritt und gibt feedback_codes zurück (die Web- und Mobile-SDKs zeigen diese automatisch als Hilfestellungen an):
  {
    "detail": "Make sure your face matches your document photo, improve lighting and try again.",
    "error": "LOW_FACE_MATCH_SIMILARITY",
    "feedback_codes": ["LOW_FACE_MATCH_SIMILARITY"],
    "attempts_used": 1,
    "max_attempts": 3
  }
  
• Erschöpfung des Budgets – sobald das Versuchsbudget aufgebraucht ist, wird der berechnete Status angewendet (Declined oder In Review).

​

So funktioniert es

​

Dokumentanforderungen

​

Allgemeine Anforderungen

• Behördlich ausgestellt und innerhalb des konfigurierten Gültigkeitszeitraums gültig
• Physisch unbeschädigt (keine Schäden, Kratzer oder Flecken, die Details verdecken)
• Alle wesentlichen Angaben (vollständiger Name, Geburtsdatum, MRZ etc.) deutlich lesbar
• Konsistente Daten über alle eingereichten Dokumente hinweg

​

Bildanforderungen

• Originales Echtzeitfoto (keine Screenshots, Scans oder digitalen Kopien)
• Unterstützte Formate: JPG, JPEG, PNG, PDF
• Maximale Dateigröße: 5MB
• Farbbild, auf dem alle Dokumentecken sichtbar sind
• Frei von Blendungen, Schatten, digitaler Bearbeitung oder Manipulationen
• Physische Dokumente erforderlich (digitale Ausweise werden nur in ausgewählten Regionen unterstützt, in denen sie offiziell anerkannt sind)

​

Zusätzliche Einstellungen nach Land und Dokumenttyp

• Ablaufmodus: Wählen Sie, wie Dokumente mit abgelaufenem Ablaufdatum behandelt werden sollen.
  • Abgelaufene ablehnen: Liegt das Ablaufdatum des Dokuments vor dem heutigen Tag, wird es als abgelaufen markiert und abgelehnt.
  • Abgelaufene zulassen: Dokumente mit abgelaufenem Ablaufdatum werden weder markiert noch blockiert.
• Bevorzugtes Zeichenformat: Wählen Sie aus, wie extrahierte Namen und Felder normalisiert werden sollen.
  • Lateinische Schriftzeichen bevorzugen (A–Z): Beispiel: “Mohammed”
  • Ursprüngliches Schriftsystem bevorzugen (nicht-lateinisch): Beispiel: “محمد”
• Regionale Unterstützung und Untertypen: Aktivieren Sie Dokumente nach Region und legen Sie zulässige Untertypen fest, wenn ein Dokumenttyp viele Varianten umfasst.
  • Beispiel: Wählen Sie bei Führerscheinen aus den Vereinigten Staaten genau die Untertypen aus, die Sie akzeptieren (z. B. Arizona Commercial Driver License, Indiana Operator License (REAL ID), New York Enhanced Driver License usw.).
  • Verwenden Sie das Steuerelement “Akzeptierte Untertypen”, um schnell viele Varianten einzuschließen oder auszuschließen (z. B. “128 ausgewählt”).

Tipp: Diese Einstellungen gelten pro Land und Dokumenttyp, sodass Sie in bestimmten Märkten streng und in anderen permissiver vorgehen können.