브라질 세금 등록 정보 확인 API (CPF/CNPJ) (KO)
CPF/CNPJ를 통해 브라질 세금 식별 정보를 실시간으로 검증하고, 결과 확인 시에만 요금을 부과합니다. 엔드포인트, 파라미터, 응답 스키마, 가격 및 통합 정보 제공.
브라질 사용자를 온보딩하려면 본인이 주장하는 신원을 확인해야 합니다. CPF/CNPJ 데이터베이스를 대상으로 검증합니다. 문서나 입력된 정보만으로는 데이터가 존재하는지 확인할 수 있을 뿐, 진위 여부나 신청자 본인에게 속하는지 알 수 없습니다. 브라질 세금 등록 정보 확인 (CPF/CNPJ)은 CPF/CNPJ와 대조하여 데이터를 확인함으로써 이러한 격차를 해소합니다. 이 가이드에서는 검증 내용, 정확한 기술 정보 및 통합 방법을 몇 분 만에 설명합니다.
주요 내용:
- 검증 내용 — 브라질 세금 등록 정보 확인 (CPF/CNPJ)은 CPF/CNPJ를 통해 세금 식별 정보를 검증합니다.
- 반환 값 — 승인/검토/거부 로직으로 바로 연결할 수 있는 정규화된
match_type와 필드별 결과입니다. - 중요한 이유 — 세금 ID 검증은 신청자를 검증 가능한 재정적 신원과 연결하여 위조 신원 및 1차 사기를 줄입니다.
- 사용 방법 — Didit의 데이터베이스 검증 엔드포인트로
POST요청을 보내거나, 노코드 워크플로우 모듈을 사용합니다. 결과에 따라 쿼리당 0.08달러가 부과되며, 결과는 몇 초 안에 제공됩니다.
브라질 세금 등록 정보 확인 (CPF/CNPJ) 검증 내용
CPF/CNPJ 데이터베이스를 대상으로 검증합니다. Didit은 이를 단일 엔드포인트를 통해 제공하므로, 제출된 데이터를 국가 세무 당국과 비교하고 구조화된 정규화된 결과를 받을 수 있습니다. (직접 파싱해야 하는 원시 레지스트리 덤프가 아닙니다.)
결정적인 응답은 일치하는 source_data와 필드별 validation 블록을 반환하므로, 위험 엔진은 명확하고 기계 판독 가능한 결과를 얻을 수 있습니다.
중요한 이유
세금 ID 검증은 신청자를 검증 가능한 재정적 신원과 연결하여 위조 신원 및 1차 사기를 줄입니다.
브라질의 규제 기업(핀테크, 암호화폐 플랫폼, 대출 기관, 마켓플레이스, 게임 운영자)의 경우, 권한 있는 소스를 통해 확인하면 신원이 소스에서 확인되었음을 입증하는 방어 가능하고 감사 가능한 기록을 생성할 수 있습니다. (단순히 양식이나 사진에서 캡처한 것과는 다름)
기술 정보
Didit은 통합 데이터베이스 검증 엔드포인트를 통해 이 서비스를 제공합니다. SDK가 필요 없는 단일 POST 요청입니다.
엔드포인트
POST /v3/database-validation/요청 파라미터
| 파라미터 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
issuing_state | string | Yes | ISO 3166-1 alpha-3 국가 코드. BRA를 사용합니다. |
services | string | Yes | 서비스 식별자. bra_tax_registration을 사용합니다. |
first_name | string | Yes | 이름. |
last_name | string | Yes | 성. |
date_of_birth | string | Yes | 생년월일. |
tax_number | string | Yes | 세금 번호. |
예시 요청
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_tax_registration" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "tax_number=1111111"예시 응답 (결정적인 일치)
{
"request_id": "req_01H...",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_tax_registration",
"service_name": "Brazil Tax Registration (CPF/CNPJ)",
"source_data": {
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"identification_number": true
}
},
"validation": {
"date_of_birth": "full_match",
"identification_number": "full_match"
}
}
]
}성능 및 요금
- 지연 시간: 일반적으로 몇 초 소요됩니다.
- 요금: 결정적인 쿼리당 0.08달러입니다. 소스 다운타임, 누락된 필드 또는 소스 전 거부의 경우 요금이 부과되지 않습니다. 결과가 확인된 경우에만 요금이 부과됩니다.
- 신뢰성: 99.9% 분기별 가동 시간 목표로 Didit의 인프라에서 실행됩니다.
사용 사례
- 핀테크 및 네오뱅크 — 브라질에서 지갑을 개설하거나 신용을 제공하기 전에 실제이고 검증된 계정 소유자를 확인합니다.
- 암호화폐 & Web3 — 권한 있는 소스 신원 증명으로 VASP 온보딩 요구 사항을 충족합니다.
- 대출 — 소스에서 확인된 데이터로 위조 신원 및 1차 사기를 줄입니다.
- 마켓플레이스 &긱 플랫폼 — 자체 보고 양식이 아닌 권한 있는 데이터에 대해 사용자를 검증합니다.
- iGaming — 브라질 플레이어에 대한 신원 및 자격 검사를 감사 가능한 기록으로 충족합니다.
Didit과 통합하는 방법
다음 두 가지 방법으로 브라질 세금 등록 정보 확인 (CPF/CNPJ)을 실행할 수 있습니다.
- 노코드 워크플로우. Didit Business Console에서 워크플로우 빌더를 열고 Database Validation 모듈을 추가하고 Brazil → Brazil Tax Registration Verification (CPF/CNPJ)을 선택한 다음 활성화합니다. 일치하는 사용자는 자동으로 라우팅됩니다. (엔지니어링 작업이 필요 없음)
- 직접 API. 위에서 표시된
/v3/database-validation/엔드포인트로services=bra_tax_registration을 사용하여POST요청을 보냅니다.match_type과 필드별validation블록을 읽어 승인/검토/거부 로직을 실행합니다.
모든 Didit 계정에는 매월 500회의 무료 검증이 포함되어 있으므로, 단일 쿼리에 대해 요금을 지불하기 전에 전체 흐름을 처음부터 끝까지 테스트할 수 있습니다.
자주 묻는 질문
브라질 세금 등록 정보 확인 (CPF/CNPJ) 검증은 무엇을 확인합니까?
제출된 데이터를 CPF/CNPJ와 검증하고, 세금 식별 정보가 권한 있는 소스에 존재하는지, 어떤 필드가 일치하는지 알려주는 정규화된 일치 결과를 반환합니다.
소스가 일시적으로 사용 불가능한 경우 어떻게 됩니까?
요금이 부과되지 않습니다. 요금은 결정적인 결과에 대해서만 적용됩니다. 소스 다운타임, 누락된 필드 및 소스 전 거부는 무료입니다.
검증 속도는 얼마나 빠릅니까?
데이터베이스 검증은 일반적으로 몇 초 안에 반환되므로 실시간 온보딩 흐름에 적합합니다.
SDK가 필요합니까?
아니요. 검증은 단일 HTTPS POST 요청으로 하나의 엔드포인트로 전송됩니다. Business Console의 노코드 워크플로우에 연결할 수도 있습니다.
시작할 준비가 되셨습니까?
오늘 브라질 세금 식별 정보를 검증하십시오.
- API 참조 읽기: 브라질 세금 등록 정보 확인 (CPF/CNPJ)
- 데이터베이스 검증 모두 보기: 데이터베이스 검증 가격 및 적용 범위
- 빌드 시작: 무료 Didit 계정 만들기 — 매월 500회 검증, 무료.