메인 콘텐츠로 건너뛰기
POST
SERPRO Datavalid v4 pf-facial은 Receita Federal을 통해 CPF(필수)를 검증하고, 실시간 셀피(필수)를 Senatran에 보관된 CNH 사진과 대조합니다. 이름과 생년월일 검사는 선택 사항입니다. Didit은 POST /v3/database-validation/ 엔드포인트로 이 서비스를 제공하므로, 제출된 데이터를 공식 소스와 대조하고 정규화된 일치 결과를 받을 수 있습니다. 입력 형식: tax_number에는 브라질 CPF(정확히 11자리 숫자)를 입력합니다.

적용 범위

  • 적용 범위: ~50%
  • 국가: 브라질
  • 서비스 ID: bra_cpf_facial
  • 데이터 영역: 생체 정보
  • 카테고리: NationalIDRegistry
브라질 성인의 약 50%가 대상입니다. 얼굴 대조 단계는 Senatran에 보관된 CNH 사진에 의존하므로, 운전면허(CNH)를 가진 사람만 대조할 수 있습니다.

입력

  • 필수 입력: tax_number, selfie
  • 선택 입력: first_name, last_name, date_of_birth, vendor_data
  • 동의: 필수
  • 워크플로 사용 가능 여부: 워크플로에서 사용 가능
  • 적용 범위: ~50%
  • 가격: 성공한 쿼리 건당 $0.45

본문 파라미터

string
기본값:"BRA"
필수
이 데이터베이스 서비스의 ISO 3166-1 alpha-3 국가 코드입니다.예시: BRA
string
기본값:"bra_cpf_facial"
필수
이 서비스 ID를 포함하는 배열입니다. 서비스를 고정하면 요청이 이 정확한 데이터베이스로만 범위가 지정됩니다.예시: bra_cpf_facial
이 서비스에 대한 최종 사용자의 명시적 동의입니다.예시: true
string
기본값:"11111111111"
필수
세금 또는 재정 식별 번호입니다.예시: 11111111111
file
필수
생체 데이터베이스 검증을 위해 업로드할 셀피 이미지 파일입니다. 허용 형식: JPEG, PNG 또는 WebP.예시: @./selfie.jpg
string
검증할 이름입니다.예시: John
string
검증할 성입니다.예시: Doe
string
YYYY-MM-DD 형식의 생년월일입니다.예시: 1990-01-01
string
기본값:"user-1234"
이 사람을 나타내는 고정 사용자 참조값입니다(예: 내부 사용자 ID). Didit은 이 값을 사용해 독립 검사를 같은 최종 사용자에게 연결하고, 중복 탐지 노이즈를 줄입니다.예시: user-1234

입력 규칙 및 검증 참고 사항

  • 브라질 CPF(정확히 11자리 숫자)
  • tax_number에는 숫자만 입력해야 합니다. 요청을 보내기 전에 공백, 하이픈 및 구두점을 제거하세요.
  • tax_number는 정확히 11자여야 합니다.

호출 방법

반환 데이터

source_data에 노출되는 정확한 필드는 레지스트리가 반환하는 내용에 따라 달라집니다. bra_cpf_facial에 대해 현재 생성된 예시는 다음과 같은 정규화된 형식을 문서화합니다:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • name_match_score

요금 및 SLA

브라질 - CPF + 얼굴 대조(Datavalid) 쿼리는 Didit이 검증 소스로부터 확정적인 결과를 받은 경우에만 과금됩니다.
  • 건당 가격: $0.45 USD.
  • 과금: 성공한 쿼리 건당. 레지스트리에 연결할 수 없는 경우, 필수 필드가 누락된 경우, 또는 요청이 소스에 도달하기 전에 거부된 경우에는 과금되지 않습니다.
  • 지연 시간: 일반적인 p95 값은 2초 미만입니다.
  • 가용성: Didit 측 기준 분기당 99.9%입니다. 하위 소스의 가용성은 국가와 데이터 세트에 따라 다릅니다.

출처 정보

이 출처는 브라질 연방 데이터 처리 서비스가 운영하는 공식 정부 출처인 SERPRO Datavalid입니다. CPF는 Receita Federal의 기록과 대조하고, 셀피는 국가 운전면허 등록부인 Senatran에 보관된 해당 인물의 사진과 대조합니다. 사진은 CNH(운전면허증) 기록에서 가져오므로 CNH를 보유한 사람만 얼굴 정보가 등록되어 있습니다. 그래서 적용 범위가 성인 인구의 약 50%로 제한됩니다. 이 데이터는 공신력이 있지만, 운전면허를 한 번도 취득한 적이 없는 모든 브라질 국민에 대해서는 데이터가 없습니다. 더 넓은 적용 범위가 필요하신가요? 대신 BRA - Unico IDCloud (CPF + selfie)를 사용하십시오. Unico의 민간 생체 인식 등록부를 통해 브라질 성인의 약 96%에 도달할 수 있으며, 비용은 여기 $0.45 대비 $0.20입니다. 정부 등록부를 기준 데이터로 삼아야 할 때는 Datavalid를, 모든 사람을 확인해야 할 때는 IDCloud를 선택하십시오.

계속 읽기

마지막 수정일 2026년 11월 7일