Zum Hauptinhalt springen
Die Datenbankvalidierung-API von Didit gleicht Identitätsdaten mit den maßgeblichen Personenstandsregistern, Steuerbehörden oder Wählerverzeichnissen des jeweiligen Landes ab – darunter RENAPER (Argentinien), Receita Federal (Brasilien), Tribunal Electoral (Panama), RENAPO (Mexiko), Junta Central Electoral (Dominikanische Republik), Registraduría Nacional (Kolumbien) und weitere. Jede Abfrage wird pro erfolgreichem Aufruf ab $0.05/check ohne monatliche Mindestbeträge abgerechnet. Die Ergebnisse werden aus den Resultaten der einzelnen Dienste abgeleitet: 1×1, wenn ein einzelnes Register eine vollständige Übereinstimmung liefert, und 2×2, wenn zwei unabhängige Register die Daten bestätigen. Auf dieser Seite wird beschrieben, wie diese Ergebnisse berechnet werden, welche Fuzzy-Matching-Schwellenwerte für Namen gelten und welche Entscheidungslogik die Parameter partialMatchAction und noMatchAction in Ihren Workflow-Regeln steuert.

​
1×1-Abgleich

Bei dieser Methode wird ein eingegebener Datenpunkt (typischerweise eine nationale Ausweisnummer oder eine ähnliche Kennung) mit unserer Datenbank abgeglichen. Wird eine direkte Übereinstimmung gefunden, bestätigen wir die Identität. Schlägt der erste Versuch jedoch fehl, können wir alternative vertrauenswürdige Datenquellen in einer Kaskade abfragen. Das bedeutet, dass wir die Validierung über aufeinanderfolgende Anbieter hinweg fortsetzen, bis wir entweder eine Übereinstimmung erzielen oder alle Optionen ausgeschöpft sind. Wichtig ist, dass eine teilweise Übereinstimmung den Prozess nicht stoppt – wir halten erst an, wenn wir eine vollständige und eindeutige Übereinstimmung finden oder feststellen, dass keine Übereinstimmung vorliegt. Die 1×1-Abgleichslogik erfordert den Abgleich der personenbezogenen Daten eines Benutzers mit einer Quelle, um das Ergebnis Vollständige Übereinstimmung für dessen Identität zu erhalten.* *Die relevanten Länderquellen werden überprüft, bis eine vollständige Übereinstimmung für die Identität erzielt wird. Wird keine vollständige Übereinstimmung gefunden, überprüft das System diese Quellen wiederholt auf eine teilweise Übereinstimmung mit der Identität des Benutzers.
Die obige 1×1-Tabelle und die nachfolgende 2×2-Tabelle beschreiben das allgemeine Modell, stellen jedoch keine Garantie dar, die für jeden Dienst gilt. Welche Felder ausschlaggebend sind, variiert je nach Dienst und den von Ihnen übermittelten optionalen Eingaben: Ein Register kann nur die Felder vergleichen, die es selbst führt und die Sie ihm bereitstellen, und das Ergebnis eines Dienstes wird von den Feldern bestimmt, die tatsächlich verglichen werden. Nicht jeder Dienst vergleicht die Ausweisnummer, und manche vergleichen sie nur dann, wenn Sie sie übermitteln. Beispielsweise erfordert Spanien – DNI/NIE-Verifizierung (esp_dni) Name, Geburtsdatum und Adresse und nimmt national_id als optionale Eingabe entgegen. Es vergleicht stets Name, Geburtsdatum und Adresse und gleicht zusätzlich die Ausweisnummer ab, wenn Sie national_id übermitteln.Ein Pflichtfeld ist nicht zwangsläufig ausschlaggebend, und ein optionales Feld kann es durchaus sein. Ein Pflichtfeld muss gesendet werden, damit die Anfrage akzeptiert wird, und ein in source_data aufgeführtes Feld enthält vom Register zurückgegebene Daten. Beides verrät Ihnen nicht, welche Felder über das Ergebnis entschieden haben. Die Antwortbeispiele auf der Seite des jeweiligen Dienstes veranschaulichen eine mögliche Antwort, sodass die Schlüssel des validation-Objekts dieses Dienstes keine vollständige Liste der von diesem Dienst verglichenen Felder darstellen. Die API-Referenzseite jedes Dienstes, die unter Unterstützte Länder und Dienste aufgeführt ist, listet dessen erforderliche und optionale Eingaben unter Eingaben auf.

​
2×2-Abgleich

Diese Methode erfordert den Abgleich von zwei eingegebenen Datenpunkten (z. B. Name + Geburtsdatum oder nationale ID + Telefonnummer) mit zwei entsprechenden Feldern in unserer Datenbank. Genau wie beim 1×1-Abgleich verfolgen wir einen Waterfall-Ansatz, bei dem mehrere Datenquellen nacheinander abgefragt werden. Wir durchlaufen jeden Schritt, bis wir eine vollständige Übereinstimmung für beide Datenfelder finden. Teilweise Übereinstimmungen oder Übereinstimmungen bei nur einem einzelnen Feld reichen nicht aus; der Validierungsprozess wird fortgesetzt, bis eine definitive Übereinstimmung in beiden Feldern erzielt wurde oder alle Quellen geprüft wurden. Die 2×2-Abgleichslogik erfordert den Abgleich der personenbezogenen Daten eines Benutzers mit zwei Quellen, um eine vollständige Übereinstimmung für seine Identität zu erhalten.* *Die Quellen der jeweiligen Länder werden überprüft, bis eine vollständige Übereinstimmung mit der Identität vorliegt. Wenn keine vollständige Übereinstimmung gefunden wird, überprüft das System diese Quellen anschließend wiederholt auf eine teilweise Übereinstimmung mit der Identität des Benutzers.

​
Abgleich nach Datenkategorien und Attributen

Im Folgenden sind die Szenarien aufgeführt, die zu einer Vollständigen Übereinstimmung bei den Datenkategorien Name, Geburtsdatum und ID führen. Eine Teilweise Übereinstimmung ist nur für die Kategorie Name möglich.

​
Abgleich der Kategorie „Name“

Eine Vollständige Übereinstimmung in der Kategorie „Name“ liegt vor, wenn eines der folgenden Szenarien für den Abgleich von Datenattributen erfüllt ist:
  • Verkettung des vollständigen Namens Vollständige Übereinstimmung (Vorname + Nachname kombiniert mit einem Ähnlichkeitsschwellenwert von 85%)
  • Vorname Vollständige Übereinstimmung + Nachname Vollständige Übereinstimmung
  • Vorname Vollständige Übereinstimmung + Mütterlicher Name Vollständige Übereinstimmung
  • Vorname Vollständige Übereinstimmung + Väterlicher Name Vollständige Übereinstimmung
Eine Teilweise Übereinstimmung in der Kategorie „Name“ liegt vor, wenn eines der folgenden Szenarien für den Abgleich von Datenattributen erfüllt ist:
  • Vorname Vollständige Übereinstimmung
  • Nachname Vollständige Übereinstimmung
  • Väterlicher Name Vollständige Übereinstimmung
  • Mütterlicher Name Vollständige Übereinstimmung
  • Mütterlicher Name Vollständige Übereinstimmung + Väterlicher Name Vollständige Übereinstimmung

​
Abgleich der Kategorie Geburtsdatum

Eine Vollständige Übereinstimmung in der Kategorie Geburtsdatum liegt nur dann vor, wenn das folgende Szenario für den Datenattributabgleich erfüllt ist:
  • Geburtsjahr Vollständige Übereinstimmung + Geburtsmonat Vollständige Übereinstimmung + Geburtstag Vollständige Übereinstimmung
Eine Teilweise Übereinstimmung ist in der Kategorie Geburtsdatum nicht möglich.

​
Abgleich der Kategorie ID

Eine Vollständige Übereinstimmung in der Kategorie ID liegt nur dann vor, wenn das folgende Szenario für den Datenattributabgleich erfüllt ist:
  • Identifikationsnummer Vollständige Übereinstimmung
Eine Teilweise Übereinstimmung ist in der Kategorie ID nicht möglich. Die Kategorie ID wird nur dann berücksichtigt, wenn der Dienst die Identifikationsnummer vergleicht. Einige Dienste vergleichen diese nie, und manche vergleichen sie nur, wenn Sie sie als Eingabe übermitteln.

​
Fuzzy-Matching für Datenattribute

Dies sind die Kriterien für das Fuzzy-Matching verschiedener Datenattribute im Abgleich mit Länderdatenquellen.
  • Namensdatenattribute Damit ein Datenattribut der Kategorie Name eine Vollständige Übereinstimmung erzeugt, muss es im Vergleich zu den Datensätzen in den Datenquellen eine Levenshtein-Zeichenähnlichkeit von mindestens 70% aufweisen. Bei der Verkettung des vollständigen Namens (Vorname + Nachname kombiniert) wird ein höherer Schwellenwert von 85% Ähnlichkeit angewendet. Wenn die Eingabe für das Namensattribut beispielsweise „Christophel“ lautet und der tatsächliche Name „Christopher“ ist, wird auf Basis der Fuzzy-Matching-Logik eine Vollständige Übereinstimmung zurückgegeben. Dieses System gilt für die Datenattribute First Name, Last Name, Paternal Name und Maternal Name.
  • Datenattribute für Geburtsdatum und Ausweis Bei Datenattributen innerhalb der Datenkategorien Geburtsdatum oder Ausweis setzen wir keinerlei Fuzzy-Matching ein. Für diese Felder ist eine exakte Übereinstimmung erforderlich.

​
Beispiele

Nachfolgend finden Sie Beispiele für Eingaben von Datenattributen, die die Kriterien der Fuzzy-Matching-Logik erfüllen und eine Vollständige Übereinstimmung generieren würden.

​
Siehe auch

  • Übersicht zur Datenbankvalidierung — wie die API durchgängig funktioniert, unterstützte Register, Preise.
  • Ergebniscodes — vollständige Liste der Anbieter-Antwortcodes (verstorben, minderjährig, Dokument nicht gefunden, biometrische Nichtübereinstimmung).
  • Warnungen — was wir anzeigen, wenn ein Dienst aufgrund fehlender Eingaben nicht ausgeführt werden kann.
  • Unterstützte Länder & Dienste — alle aktiven Register, erforderliche Felder und Preise pro Aufruf.
  • Berichte — monatliche Abrechnungsexporte pro Dienst.
Zuletzt geändert am 7. November 2026