Vai al contenuto principale
POST
SERPRO Datavalid v4 pf-facial convalida il CPF (obbligatorio) presso la Receita Federal e confronta il selfie in tempo reale (obbligatorio) con la foto della CNH conservata presso Senatran. Facoltativamente verifica anche nome e data di nascita. Didit espone questo servizio tramite POST /v3/database-validation/, così puoi verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di confronto normalizzati. Formato di input: tax_number accetta il CPF brasiliano (esattamente 11 cifre).

Copertura

  • Copertura: ~50%
  • Paese: Brasile
  • ID servizio: bra_cpf_facial
  • Dominio dei dati: Biometrico
  • Categoria: NationalIDRegistry
Circa il 50% degli adulti brasiliani: il passaggio di confronto facciale si basa sulla foto della CNH conservata presso Senatran, quindi possono essere confrontate solo le persone titolari di patente di guida.

Input

  • Input obbligatori: tax_number, selfie
  • Input facoltativi: first_name, last_name, date_of_birth, vendor_data
  • Consenso: Obbligatorio
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: ~50%
  • Prezzo: $0.45 per query riuscita

Parametri del corpo

string
predefinito:"BRA"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: BRA
string
predefinito:"bra_cpf_facial"
obbligatorio
Array che contiene questo ID servizio. Specificare il servizio limita la richiesta a questo specifico database.Esempio: bra_cpf_facial
Consenso esplicito dell’utente finale per questo servizio.Esempio: true
string
predefinito:"11111111111"
obbligatorio
Numero di identificazione fiscale.Esempio: 11111111111
file
obbligatorio
File immagine del selfie da caricare per la validazione biometrica su database. Formati accettati: JPEG, PNG o WebP.Esempio: @./selfie.jpg
string
Nome da validare.Esempio: John
string
Cognome da validare.Esempio: Doe
string
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore nel rilevamento dei duplicati.Esempio: user-1234

Regole di input e note di validazione

  • CPF brasiliano (esattamente 11 cifre)
  • tax_number deve contenere solo cifre: rimuovi spazi, trattini e punteggiatura prima di inviare la richiesta.
  • tax_number deve essere lungo esattamente 11 caratteri.

Come effettuare la chiamata

Dati restituiti

I campi esatti esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per bra_cpf_facial documenta attualmente questa struttura normalizzata:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • name_match_score

Prezzi e SLA

Brasile: le query CPF + confronto facciale (Datavalid) vengono fatturate solo quando Didit riceve un risultato definitivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.45 USD.
  • Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: p95 tipico < 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

Informazioni su questa fonte

Si tratta della fonte governativa ufficiale: SERPRO Datavalid, gestita dal servizio federale brasiliano di elaborazione dati. Il CPF viene verificato con la Receita Federal, mentre il selfie viene confrontato con il ritratto custodito per quella persona presso la Senatran, il registro nazionale delle patenti di guida. Poiché il ritratto proviene dal registro della CNH (patente di guida), solo le persone in possesso di una CNH hanno un volto registrato. È questo che limita la copertura a circa il 50% della popolazione adulta: i dati sono autorevoli, ma mancano per tutti i brasiliani che non hanno mai conseguito una patente di guida. Hai bisogno di una copertura più ampia? Usa invece BRA - Unico IDCloud (CPF + selfie). Raggiunge circa il 96% degli adulti brasiliani tramite il registro biometrico privato di Unico, e costa $0.20 contro i $0.45 previsti qui. Scegli Datavalid quando ti serve in particolare il registro governativo come fonte di riferimento; scegli IDCloud quando devi verificare tutti.

Continua a leggere

Ultima modifica il 7 novembre 2026