Saltar al contingut principal
POST
SERPRO Datavalid v4 pf-facial: valida el CPF (obligatori) amb la Receita Federal i compara el selfie en directe (obligatori) amb el retrat de la CNH emmagatzemat a Senatran. Opcionalment, comprova el nom i la data de naixement. Didit exposa aquest servei mitjançant POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font oficial i rebre resultats de coincidència normalitzats. Format d’entrada: tax_number admet el CPF brasiler (exactament 11 dígits).

Cobertura

  • Cobertura: ~50%
  • País: Brasil
  • ID del servei: bra_cpf_facial
  • Àmbit de dades: Biomètric
  • Categoria: NationalIDRegistry
Aproximadament el 50% dels adults brasilers: el pas de coincidència facial depèn del retrat de la CNH que guarda Senatran, de manera que només es pot fer la coincidència dels titulars de permisos de conducció.

Entrades

  • Entrades obligatòries: tax_number, selfie
  • Entrades opcionals: first_name, last_name, date_of_birth, vendor_data
  • Consentiment: Obligatori
  • Disponibilitat al flux de treball: Disponible al flux de treball
  • Cobertura: ~50%
  • Preu: $0.45 per consulta satisfactòria

Paràmetres del cos

string
predeterminat:"BRA"
requerit
Codi de país ISO 3166-1 alfa-3 per a aquest servei de base de dades.Exemple: BRA
string
predeterminat:"bra_cpf_facial"
requerit
Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: bra_cpf_facial
Consentiment explícit de l’usuari final per a aquest servei.Exemple: true
string
predeterminat:"11111111111"
requerit
Número d’identificació fiscal o tributària.Exemple: 11111111111
file
requerit
Fitxer d’imatge del selfie que s’ha de pujar per a la validació biomètrica en bases de dades. Formats acceptats: JPEG, PNG o WebP.Exemple: @./selfie.jpg
string
Nom de pila que cal validar.Exemple: John
string
Cognoms que cal validar.Exemple: Doe
string
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID intern d’usuari. Didit l’utilitza per vincular les comprovacions independents al mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • CPF brasiler (exactament 11 dígits)
  • tax_number ha de contenir només dígits; elimina espais, guions i signes de puntuació abans d’enviar la sol·licitud.
  • tax_number ha de tenir exactament 11 caràcters.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a bra_cpf_facial documenta actualment aquesta forma normalitzada:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • name_match_score

Preus i SLA

Brasil: les consultes de CPF + coincidència facial (Datavalid) només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.45 USD.
  • Facturació: per consulta satisfactòria. No se’t cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
  • Latència: p95 típic inferior a 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font final varia segons el país i el conjunt de dades.

Sobre aquesta font

Aquesta és la font oficial del govern: SERPRO Datavalid, gestionat pel servei federal brasiler de processament de dades. El CPF es comprova amb la Receita Federal, i el selfie es compara amb el retrat que el Senatran, el registre nacional de permisos de conducció, té d’aquella persona. Com que el retrat procedeix del registre de la CNH (permís de conducció), només tenen una imatge facial registrada les persones que tenen una CNH. Això fa que la cobertura se situï al voltant del 50% de la població adulta: les dades són oficials, però falten per a tots els brasilers que mai no han tingut un permís de conducció. Necessites més cobertura? Utilitza BRA - Unico IDCloud (CPF + selfie). Arriba a un 96% aproximadament dels adults brasilers gràcies al registre biomètric privat d’Unico, i costa $0.20 en lloc dels $0.45 d’aquí. Tria Datavalid quan necessitis específicament el registre governamental com a font de referència; tria IDCloud quan necessitis verificar tothom.

Continua llegint

Darrera modificació el 7 de novembre del 2026