메인 콘텐츠로 건너뛰기
POST
SERPRO를 통해 Receita Federal에서 CPF 상태(정상, 정지, 취소), 성명, 사회적 이름, 등록일을 반환합니다. 조회는 CPF와 생년월일을 기준으로 합니다. Didit은 이 서비스를 POST /v3/database-validation/로 제공하므로, 제출된 데이터를 공식 출처와 대조하고 정규화된 일치 결과를 받을 수 있습니다. 입력 형식: tax_number에는 브라질 CPF(정확히 11자리 숫자)를 입력합니다.

적용 범위

  • 적용 범위: ~ 100%
  • 국가: 브라질
  • 서비스 ID: bra_cpf
  • 데이터 영역: 신원
  • 카테고리: TaxRegistry

입력

  • 필수 입력: tax_number, date_of_birth
  • 선택 입력: first_name, last_name, vendor_data
  • 동의: 필요하지 않음
  • 워크플로 가용성: 워크플로에서 사용 가능
  • 적용 범위: ~ 100%
  • 가격: 성공한 쿼리당 $0.20
이 서비스가 허용하는 모든 문서에 조회 기준 식별자가 포함되어 있지는 않습니다. 문서에서 식별자가 추출되지 않으면 검사는 해당 없음으로 기록되며, 데이터베이스를 조회하지 않고 요금도 청구되지 않습니다. 일부 국가에서는 이런 경우가 실제 사용자의 상당수를 차지합니다. 이들을 포함하려면 설문 응답, Document AI 추출 필드, 또는 세션을 생성할 때 보내는 값에서도 식별자를 수집하여 데이터베이스 검증 단계에 매핑하십시오.

본문 파라미터

string
기본값:"BRA"
필수
이 데이터베이스 서비스의 ISO 3166-1 alpha-3 국가 코드입니다.예시: BRA
string
기본값:"bra_cpf"
필수
이 서비스 ID를 포함하는 배열입니다. 서비스를 고정하면 요청이 이 특정 데이터베이스로만 범위가 제한됩니다.예시: bra_cpf
string
기본값:"11111111111"
필수
세금 또는 납세자 식별 번호입니다.예시: 11111111111
string
기본값:"1990-01-01"
필수
YYYY-MM-DD 형식의 생년월일입니다.예시: 1990-01-01
string
검증할 이름입니다.예시: John
string
검증할 성입니다.예시: Doe
string
기본값:"user-1234"
이 사람에 대한 고정 사용자 참조값입니다(예: 내부 사용자 ID). Didit은 이 값을 사용해 단독 검사를 동일한 최종 사용자에게 연결하고 중복 탐지 노이즈를 줄입니다.예시: user-1234

입력 규칙 및 검증 참고 사항

  • 브라질 CPF(정확히 11자리 숫자)
  • tax_number에는 숫자만 포함되어야 합니다. 요청을 보내기 전에 공백, 하이픈 및 구두점을 제거하십시오.
  • tax_number는 정확히 11자여야 합니다.

호출 방법

반환 데이터

source_data에 표시되는 정확한 필드는 레지스트리가 반환하는 내용에 따라 달라집니다. bra_cpf의 생성된 예시는 현재 다음과 같은 정규화된 형식을 문서화합니다.
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • lgpd_minor
  • minor_under_16
  • minor_under_18
  • registration_date

요금 및 SLA

브라질 - CPF 상태 확인 쿼리는 Didit이 검증 출처로부터 확정된 결과를 받은 경우에만 청구됩니다.
  • 호출당 가격: $0.20 USD.
  • 청구: 성공한 쿼리당 청구됩니다. 레지스트리에 연결할 수 없는 경우, 필수 필드가 누락된 경우, 또는 요청이 출처에 도달하기 전에 거부된 경우에는 요금이 청구되지 않습니다.
  • 지연 시간: 일반적인 p95 < 2초.
  • 가용성: 분기별 Didit 측 99.9%. 다운스트림 데이터 소스의 가용성은 국가와 데이터셋에 따라 다릅니다.

계속 읽기

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