Saltar al contenido principal
POST
SERPRO Datavalid v4 pf-facial-qrcode: decodifica el código QR impreso en las licencias de conducir brasileñas CNH (físicas o digitales, emitidas desde mayo de 2017), valida el CPF, el nombre y la fecha de nacimiento con la Receita Federal y compara la selfie en vivo con el retrato de la CNH almacenado en Senatran. Didit ofrece este servicio a través de POST /v3/database-validation/ para que puedas verificar los datos enviados con la fuente oficial y recibir resultados de coincidencia normalizados.

Cobertura

  • Cobertura: —
  • País: Brasil
  • ID del servicio: bra_cnh_facial_qrcode
  • Dominio de datos: Biométrico
  • Categoría: DriverLicence

Datos de entrada

  • Datos obligatorios: tax_number, selfie, cnh_qr_code_image
  • Datos opcionales: first_name, last_name, date_of_birth, vendor_data
  • Consentimiento: Obligatorio
  • Disponibilidad en flujos: Disponible en el flujo de verificación (workflow)
  • Cobertura: —
  • Precio: $0.62 por consulta exitosa

Parámetros del cuerpo

string
predeterminado:"BRA"
requerido
Código de país ISO 3166-1 alfa-3 de este servicio de base de datos.Ejemplo: BRA
string
predeterminado:"bra_cnh_facial_qrcode"
requerido
Array que contiene el ID de este servicio. Fijar el servicio limita la solicitud a esta base de datos concreta.Ejemplo: bra_cnh_facial_qrcode
Consentimiento explícito del usuario final para este servicio.Ejemplo: true
string
predeterminado:"11111111111"
requerido
Número de identificación tributaria o fiscal.Ejemplo: 11111111111
file
requerido
Archivo de imagen de la selfie que se debe subir para la validación en la base de datos biométrica. Formatos aceptados: JPEG, PNG o WebP.Ejemplo: @./selfie.jpg
string
requerido
Valor de cnh_qr_code_image que exige este servicio de base de datos.Ejemplo: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB
string
Nombre de pila que se va a validar.Ejemplo: John
string
Apellido que se va a validar.Ejemplo: Doe
string
Fecha de nacimiento en formato YYYY-MM-DD.Ejemplo: 1990-01-01
string
predeterminado:"user-1234"
Tu referencia estable de usuario para esta persona, como tu ID interno de usuario. Didit la usa para vincular las comprobaciones independientes al mismo usuario final y reducir el ruido en la detección de duplicados.Ejemplo: user-1234

Reglas de entrada y notas de validación

  • CPF brasileño (exactamente 11 dígitos)
  • tax_number debe contener solo dígitos; elimina los espacios, guiones y signos de puntuación antes de enviar la solicitud.
  • tax_number debe tener exactamente 11 caracteres.

Cómo invocarlo

Datos devueltos

Los campos exactos que aparecen en source_data dependen de lo que devuelva el registro. El ejemplo generado para bra_cnh_facial_qrcode documenta actualmente esta estructura normalizada:
  • cnh_qrcode
  • date_of_birth
  • face_match_probability
  • face_match_score
  • first_name
  • identification_number
  • last_name
  • name_match_score

Precios y SLA

Las consultas de Brasil - código QR de la CNH + coincidencia facial (Datavalid) solo se facturan cuando Didit recibe un resultado concluyente de la fuente de validación.
  • Precio por llamada: $0.62 USD.
  • Facturación: por consulta exitosa. No se te cobra cuando el registro no está disponible, cuando faltan campos obligatorios o cuando la solicitud se rechaza antes de llegar a la fuente.
  • Latencia: p95 típico < 2 s.
  • Disponibilidad: 99.9% por trimestre por parte de Didit; la disponibilidad de la fuente externa varía según el país y el conjunto de datos.

Continúa leyendo

Última modificación el 1 de noviembre de 2026