Primers passos
Integració / SDK
Verificació d'usuaris
Verificació d'empreses
Monitoratge de transaccions
Registre de canviscurl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cnh_facial_qrcode" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg" \
-F "cnh_qr_code_image=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"cnh_qrcode": "sample_value",
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇧🇷 Brasil
CNH Brasil amb QR i coincidència facial (Datavalid) API
Validació de la CNH del Brasil via codi QR i coincidència facial amb Didit. Des de $0.62 per verificació, sense contractes ni mínims.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cnh_facial_qrcode" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg" \
-F "cnh_qr_code_image=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"cnh_qrcode": "sample_value",
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
SERPRO Datavalid v4 pf-facial-qrcode decodifica el codi QR imprès als permisos de conduir CNH brasilers (físics o digitals, emesos des del maig de 2017), valida el CPF, el nom i la data de naixement amb la Receita Federal, i compara la selfie en directe amb el retrat de la CNH emmagatzemat a Senatran. Didit exposa aquest servei a través de
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 accepta el CPF brasiler (exactament 11 dígits).
Cobertura
- Cobertura: —
- País: Brasil
- Service ID:
bra_cnh_facial_qrcode - Domini de dades: Biomètric
- Categoria: Llicència de conducció
Entrades
| Camp | Obligatori | Exemple |
|---|---|---|
tax_number | Sí | 11111111111 |
selfie | Sí | @./selfie.jpg |
cnh_qr_code_image | Sí | data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB |
first_name | No | John |
last_name | No | Doe |
date_of_birth | No | 1990-01-01 |
vendor_data | No | user-1234 |
- Entrades obligatòries:
tax_number,selfie,cnh_qr_code_image - Entrades opcionals:
first_name,last_name,date_of_birth,vendor_data - Consentiment: Obligatori
- Disponibilitat al flux de treball: Disponible en el flux de treball
- Cobertura: —
- Preu: $0.62 per consulta satisfactòria
Paràmetres del cos
string
predeterminat:"BRA"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de bases de dades.Exemple:
BRAstring
predeterminat:"bra_cnh_facial_qrcode"
requerit
Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades concreta.Exemple:
bra_cnh_facial_qrcodeboolean
predeterminat:"true"
requerit
Consentiment explícit de l’usuari final per a aquest servei.Exemple:
truestring
predeterminat:"11111111111"
requerit
Número d’identificació fiscal o tributària.Exemple:
11111111111file
requerit
Fitxer d’imatge de selfie que cal pujar per a la validació biomètrica en bases de dades. Formats acceptats: JPEG, PNG o WebP.Exemple:
@./selfie.jpgstring
requerit
Valor de
cnh_qr_code_image que requereix aquest servei de bases de dades.Exemple: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABstring
Nom de pila a validar.Exemple:
Johnstring
Cognom a validar.Exemple:
Doestring
Data de naixement en format
YYYY-MM-DD.Exemple: 1990-01-01string
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 verificacions independents al mateix usuari final i reduir el soroll de detecció de duplicats.Exemple:
user-1234Regles d’entrada i notes de validació
- CPF brasiler (exactament 11 dígits)
tax_numberha de contenir només dígits; elimina els espais, els guionets i els signes de puntuació abans d’enviar la sol·licitud.tax_numberha de tenir exactament 11 caràcters.
Com fer la crida
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cnh_facial_qrcode" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg" \
-F "cnh_qr_code_image=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
Cada crida satisfactòria retorna HTTP 200. El camp outcome_code indica què ha passat realment, i distingeix, per exemple, una discrepància biomètrica real (BIOMETRIC_NO_MATCH) d’una selfie que no s’ha pogut llegir (BIOMETRIC_IMAGE_UNUSABLE). L’status mostrat és l’estat per defecte de la funcionalitat; les accions configurades de coincidència parcial o sense coincidència el poden substituir.MATCH: el registre ha confirmat la identitat i tots els camps verificats coincideixen.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"cnh_qrcode": "sample_value",
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
NO_MATCH: el registre no ha retornat cap coincidència per a les dades enviades.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
BIOMETRIC_NO_MATCH: la puntuació de coincidència facial és inferior al llindar d’acceptació: la selfie no correspon a la mateixa persona que la fotografia del registre.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
BIOMETRIC_IMAGE_UNUSABLE: la selfie no s’ha pogut processar (buida, sense cara, de baixa qualitat, o el registre no l’ha pogut llegir). Demana a l’usuari que torni a fer la selfie.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cnh_facial_qrcode",
"service_name": "Brazil - CNH QR code + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
Dades retornades
Els camps exactes que apareixen asource_data depenen del que retorni el registre. L’exemple generat per a bra_cnh_facial_qrcode documenta actualment aquesta estructura normalitzada:
cnh_qrcodedate_of_birthface_match_probabilityface_match_scorefirst_nameidentification_numberlast_namename_match_score
Preus i SLA
Brasil: les consultes de codi QR de la CNH + coincidència facial (Datavalid) només es facturen quan Didit rep un resultat concloent de la font de validació.- Preu per crida: $0.62 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 habitual inferior a 2 s.
- Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de les fonts externes varia segons el país i el conjunt de dades.
Continua llegint
Darrera modificació el 7 de novembre del 2026