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"
}
}
]
}
🇧🇷 브라질
브라질 CNH QR 코드 + 얼굴 대조 (Datavalid) API
Didit으로 브라질 CNH QR 코드 및 얼굴 대조(Datavalid)를 통한 공인 데이터베이스 조회. 건당 과금 $0.62부터, 계약 및 최소 사용량 없음.
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는 2017년 5월 이후 발급된 브라질 CNH 운전면허증(실물 또는 디지털)에 인쇄된 QR 코드를 디코딩하고, CPF, 성명, 생년월일을 Receita Federal의 데이터와 대조하여 검증하며, 실시간 셀피를 Senatran에 저장된 CNH 사진과 대조합니다. Didit는
POST /v3/database-validation/을 통해 이 서비스를 제공하므로, 제출된 데이터를 공식 출처와 대조하여 정규화된 일치 결과를 받을 수 있습니다. 입력 형식: tax_number에는 브라질 CPF(정확히 11자리 숫자)를 입력합니다.
적용 범위
- 적용 범위: —
- 국가: Brazil
- 서비스 ID:
bra_cnh_facial_qrcode - 데이터 도메인: 생체 인식
- 카테고리: DriverLicence
입력
| 필드 | 필수 | 예시 |
|---|---|---|
tax_number | 예 | 11111111111 |
selfie | 예 | @./selfie.jpg |
cnh_qr_code_image | 예 | data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB |
first_name | 아니요 | John |
last_name | 아니요 | Doe |
date_of_birth | 아니요 | 1990-01-01 |
vendor_data | 아니요 | user-1234 |
- 필수 입력:
tax_number,selfie,cnh_qr_code_image - 선택 입력:
first_name,last_name,date_of_birth,vendor_data - 동의: 필수
- 워크플로 사용 가능 여부: 워크플로에서 사용 가능
- 적용 범위: —
- 가격: 성공한 쿼리당 $0.62
본문 파라미터
string
기본값:"BRA"
필수
이 데이터베이스 서비스의 ISO 3166-1 alpha-3 국가 코드입니다.예시:
BRAstring
기본값:"bra_cnh_facial_qrcode"
필수
이 서비스 ID를 포함하는 배열입니다. 서비스를 고정하면 요청 범위가 이 정확한 데이터베이스로 제한됩니다.예시:
bra_cnh_facial_qrcodeboolean
기본값:"true"
필수
이 서비스에 대한 최종 사용자의 명시적 동의입니다.예시:
truestring
기본값:"11111111111"
필수
납세자 또는 세금 식별 번호입니다.예시:
11111111111file
필수
생체 데이터베이스 검증을 위해 업로드할 셀피 이미지 파일입니다. 허용 형식: JPEG, PNG 또는 WebP.예시:
@./selfie.jpgstring
필수
이 데이터베이스 서비스에 필요한
cnh_qr_code_image 값입니다.예시: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABstring
검증할 이름입니다.예시:
Johnstring
검증할 성입니다.예시:
Doestring
YYYY-MM-DD 형식의 생년월일입니다.예시: 1990-01-01string
기본값:"user-1234"
내부 사용자 ID 등, 이 사람을 식별하는 고정 사용자 참조 값입니다. Didit는 이 값을 사용해 개별 검사를 같은 최종 사용자와 연결하고 중복 탐지 노이즈를 줄입니다.예시:
user-1234입력 규칙 및 검증 참고 사항
- 브라질 CPF(정확히 11자리 숫자)
tax_number에는 숫자만 포함되어야 합니다. 요청을 보내기 전에 공백, 하이픈 및 구두점을 모두 제거하세요.tax_number는 정확히 11자여야 합니다.
호출 방법
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"
성공한 모든 호출은 HTTP 200을 반환합니다. outcome_code 필드는 실제로 무슨 일이 일어났는지 알려 줍니다. 예를 들어 실제 생체 불일치(BIOMETRIC_NO_MATCH)와 읽을 수 없었던 셀피(BIOMETRIC_IMAGE_UNUSABLE)를 구분합니다. 표시되는 status는 기본 기능 상태이며, 설정한 부분 일치 / 불일치 작업에 따라 재정의될 수 있습니다.MATCH — 등록 기관이 신원을 확인했으며 확인된 모든 필드가 일치했습니다.{
"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 — 등록 기관이 제출된 데이터와 일치하는 결과를 반환하지 않았습니다.{
"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 — 얼굴 대조 점수가 허용 임계값보다 낮았습니다. 셀피 속 인물이 등록 사진의 인물과 같은 사람이 아닙니다.{
"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 — 셀피를 처리할 수 없습니다(비어 있음, 얼굴 없음, 품질 낮음, 또는 등록 기관이 읽을 수 없음). 사용자에게 셀피를 다시 촬영하도록 안내하세요.{
"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"
}
}
]
}
반환 데이터
source_data에 표시되는 정확한 필드는 등록 기관이 반환하는 값에 따라 달라집니다. bra_cnh_facial_qrcode의 생성된 예시는 현재 다음과 같은 정규화된 구조를 문서화합니다:
cnh_qrcodedate_of_birthface_match_probabilityface_match_scorefirst_nameidentification_numberlast_namename_match_score
요금 및 SLA
브라질: CNH QR 코드 + 얼굴 대조(Datavalid) 쿼리는 Didit가 검증 출처로부터 확정적인 결과를 받은 경우에만 과금됩니다.- 호출당 가격: $0.62 USD.
- 과금: 성공한 쿼리 단위로 과금됩니다. 등록 기관에 연결할 수 없는 경우, 필수 필드가 누락된 경우, 또는 요청이 출처에 도달하기 전에 거부된 경우에는 과금되지 않습니다.
- 지연 시간: 일반적인 p95 2초 미만.
- 가용성: Didit 측 분기별 99.9%. 하위 데이터 소스의 가용성은 국가와 데이터셋에 따라 다릅니다.
계속 읽기
마지막 수정일 2026년 11월 7일