Vai al contenuto principale
POST
SERPRO Datavalid v4 pf-facial-qrcode decodifica il codice QR stampato sulle patenti di guida brasiliane CNH (fisiche o digitali, emesse dal maggio 2017), convalida CPF, nome e data di nascita presso la Receita Federal e confronta il selfie acquisito dal vivo con il ritratto della CNH conservato presso Senatran. 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: —
  • Paese: Brasile
  • ID servizio: bra_cnh_facial_qrcode
  • Dominio dei dati: Biometrico
  • Categoria: Patente di guida

Input

  • Input obbligatori: tax_number, selfie, cnh_qr_code_image
  • Input facoltativi: first_name, last_name, date_of_birth, vendor_data
  • Consenso: Obbligatorio
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: —
  • Prezzo: $0.62 per query riuscita

Parametri del body

string
predefinito:"BRA"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di validazione su database.Esempio: BRA
string
predefinito:"bra_cnh_facial_qrcode"
obbligatorio
Array che contiene questo ID servizio. Fissare il servizio mantiene la richiesta limitata a questo database specifico.Esempio: bra_cnh_facial_qrcode
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
obbligatorio
Valore di cnh_qr_code_image richiesto da questo servizio di validazione su database.Esempio: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB
string
Nome di battesimo 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 dovuto ai duplicati.Esempio: user-1234

Regole di input e note sulla 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 riportati in source_data dipendono da ciò che restituisce il registro. L’esempio generato per bra_cnh_facial_qrcode documenta attualmente questa struttura normalizzata:
  • cnh_qrcode
  • date_of_birth
  • face_match_probability
  • face_match_score
  • first_name
  • identification_number
  • last_name
  • name_match_score

Prezzi e SLA

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

Continua la lettura

Ultima modifica il 7 novembre 2026