Zum Hauptinhalt springen
POST
SERPRO Datavalid v4 pf-facial prüft die CPF (Pflicht) gegen die Receita Federal und gleicht das Live-Selfie (Pflicht) mit dem im Senatran hinterlegten CNH-Porträt ab. Optional werden Name und Geburtsdatum geprüft. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Abgleichsergebnisse erhalten. Eingabeformat: tax_number nimmt die brasilianische CPF entgegen (genau 11 Ziffern).

Abdeckung

  • Abdeckung: ~50%
  • Land: Brasilien
  • Dienst-ID: bra_cpf_facial
  • Datenbereich: Biometrisch
  • Kategorie: NationalIDRegistry
Etwa 50% der erwachsenen Brasilianer können abgeglichen werden: Der Gesichtsabgleich stützt sich auf das im Senatran hinterlegte CNH-Porträt, daher können nur Führerscheininhaber (CNH) abgeglichen werden.

Eingaben

  • Pflichteingaben: tax_number, selfie
  • Optionale Eingaben: first_name, last_name, date_of_birth, vendor_data
  • Einwilligung: Erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~50%
  • Preis: $0.45 pro erfolgreiche Abfrage

Body-Parameter

string
Standard:"BRA"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: BRA
string
Standard:"bra_cpf_facial"
erforderlich
Array, das diese Dienst-ID enthält. Das Festlegen des Dienstes beschränkt die Anfrage auf genau diese Datenbank.Beispiel: bra_cpf_facial
Ausdrückliche Einwilligung des Endbenutzers für diesen Dienst.Beispiel: true
string
Standard:"11111111111"
erforderlich
Steuer- oder Fiskalidentifikationsnummer.Beispiel: 11111111111
file
erforderlich
Selfie-Bilddatei für die biometrische Datenbankvalidierung. Akzeptierte Formate: JPEG, PNG oder WebP.Beispiel: @./selfie.jpg
string
Zu validierender Vorname.Beispiel: John
string
Zu validierender Nachname.Beispiel: Doe
string
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und Störsignale bei der Duplikaterkennung zu reduzieren.Beispiel: user-1234

Eingaberegeln und Hinweise zur Validierung

  • Brasilianische CPF (genau 11 Ziffern)
  • tax_number darf nur Ziffern enthalten; entfernen Sie vor dem Senden der Anfrage Leerzeichen, Bindestriche und Satzzeichen.
  • tax_number muss genau 11 Zeichen lang sein.

So rufen Sie den Endpunkt auf

Zurückgegebene Daten

Welche Felder genau in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für bra_cpf_facial dokumentiert derzeit diese normalisierte Struktur:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • name_match_score

Preise und SLAs

Brasilien: Abfragen für den CPF- und Gesichtsabgleich (Datavalid) werden nur abgerechnet, wenn Didit ein eindeutiges Ergebnis der Validierungsquelle erhält.
  • Preis pro Aufruf: $0.45 USD.
  • Abrechnung: pro erfolgreiche Abfrage. Sie werden nicht belastet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischerweise p95 unter 2 s.
  • Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit; die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.

Über diese Quelle

Dies ist die offizielle Behördenquelle: SERPRO Datavalid, betrieben vom brasilianischen Bundesdienst für Datenverarbeitung. Die CPF wird mit der Receita Federal abgeglichen, und das Selfie wird mit dem Porträt verglichen, das für diese Person beim Senatran hinterlegt ist, dem nationalen Führerscheinregister. Da das Porträt aus dem CNH-Datensatz (Führerschein) stammt, ist nur für Personen mit einer CNH ein Gesichtsbild hinterlegt. Dadurch ist die Abdeckung auf etwa 50% der erwachsenen Bevölkerung begrenzt. Die Daten sind maßgeblich, fehlen aber für alle Brasilianerinnen und Brasilianer, die nie einen Führerschein hatten. Benötigen Sie eine breitere Abdeckung? Verwenden Sie stattdessen BRA - Unico IDCloud (CPF + selfie). Damit erreichen Sie rund 96% der erwachsenen Brasilianerinnen und Brasilianer über das private biometrische Register von Unico, und die Prüfung kostet $0.20 statt $0.45 bei dieser Quelle. Wählen Sie Datavalid, wenn Sie gezielt das staatliche Register als maßgebliche Quelle benötigen. Wählen Sie IDCloud, wenn Sie alle Personen verifizieren müssen.

Weiterlesen

Zuletzt geändert am 7. November 2026