> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.
# 데이터베이스 검증 API: 정부 등록부 KYC
> Didit의 정부 등록부 데이터베이스 검증 API는 가장 빠르고 경제적인 호출당 결제 솔루션입니다. 건당 $0.05부터 60+개국을 지원하며 사진 보유 시 생체 얼굴 대조도 지원합니다.
Didit의 **데이터베이스 검증**은 해당 국가의 공인 기관(신분증을 최초 발급한 국가 주민등록청, 세무 당국, 선거인 명부, 신용평가기관 또는 생체인식 등록부)을 통해 개인의 신원 데이터를 검증합니다. 각 검사는 필드별 일치 여부(`identification_number`, `first_name`, `last_name`, `date_of_birth` 및 해당 서비스에서 사용하는 주소 필드)와 함께 종합 결과, 그리고 가능한 경우 기본 레코드 세부 정보를 반환합니다.이는 합성 신원 사기에 대한 가장 강력한 방어책입니다. 도용된 실제 DNI나 CPF는 등록부 조회에 실패하며, 위조된 번호는 공식 데이터베이스에 아예 존재하지 않습니다. 등록부에 공식 사진이 보관되어 있는 국가(RENAPER를 통한 아르헨티나, Tribunal Electoral SIB / SIB Plus를 통한 파나마)에서는 데이터베이스 검증을 얼굴 대조와 결합할 수 있으므로, 번호가 유효할 뿐만 아니라 **카메라 앞에 서 있는 사람이 해당 번호의 소유자임**을 확인할 수 있습니다.
데이터베이스 검증 연동 프롬프트
\
\````# Goal
Integrate Didit Database Validation (verify identity data against authoritative national registries) into your app. Pick ONE mode.
\# Mode A — Session-based
Use this when Database Validation runs as a step in a hosted Didit flow. Fields are auto-fed into the registry lookup from the steps in front of it — ID Verification, NFC, Liveness, Phone/Email Verification, Proof of Address, Document AI or a Questionnaire. An ID Verification step is not required.
1\. Add the DATABASE_VALIDATION feature to the workflow (Business Console or POST /v3/workflows/). Optionally pin specific services per country.
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user (or mount the Web/Mobile SDK).
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.
Decision surface: `database_validations[]` array on the decision payload.
\# Mode B — Standalone API (server-to-server)
Use when you already have the identity data and want a one-shot registry check.
POST https://verification.didit.me/v3/database-validation/
multipart/form-data — x-api-key: YOUR_API_KEY
curl example (Brazil CPF):
\```bash
curl -X POST 'https://verification.didit.me/v3/database-validation/' \
-H "x-api-key: $DIDIT_API_KEY" \
-F "issuing_state=BRA" \
-F "identification_number=00000000191" \
-F "first_name=Jane" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-15" \
-F "vendor_data=user-1234"
\```
Returns: { request_id, database_validation: { match_type: "full_match"|"partial_match"|"no_match", validation_type, services_used, match_score, validations: [{ service, status, matched_fields, record_details }], warnings: [...] } }.
\# Important behaviour
\- Use `identification_number` (universal field) — Didit maps it to CPF/RUT/CURP/DNI/etc. by issuing_state.
\- Omit `services` to run the country's default service only. Pass `services=["bra_cpf"]` (etc.) to choose which services run — list several to run more than one.
\- Argentina (`arg_renaper`) and Panama (`pan_sib`) take an extra `selfie` (JPG/PNG/WebP up to 2 MB) and `gender` for biometric face-match against the registry photo.
\- Services flagged `requires_consent=true` in the catalog require `consent=true` (HTTP 400 otherwise).
\- Billing is **per successful service hit** — multi-service requests can produce multiple usage events.
\# Status / match_type
status: "Approved" | "In Review" | "Declined" (per the partial-match / no-match actions configured on the workflow)
match_type: "full_match" | "partial_match" | "no_match"
\# Warnings (LogWarningChoices.DATABASE_VALIDATION)
warnings[] risk codes include:
DATABASE_VALIDATION_NO_MATCH, DATABASE_VALIDATION_PARTIAL_MATCH, COULD_NOT_PERFORM_DATABASE_VALIDATION (biometric outcomes surface via per-service outcome_code, e.g. BIOMETRIC_NO_MATCH).
Full catalogue: /core-technology/database-validation/database-validation-warnings.
\# Failure modes to handle
\- HTTP 400 — service id not eligible for issuing_state, missing required field, missing consent for PAYGO services.
\- HTTP 502 with validation_errors[] — every selected upstream service failed; request is **not billed** and a COULD_NOT_PERFORM_DATABASE_VALIDATION log is written. Retry later or fall back to OCR-only.
\- match_type="no_match" — record not in registry; treat as synthetic identity per policy.
\- match_type="partial_match" — some fields match, others don't (e.g. DOB matches, name doesn't); route to review.
\# See also
\- Canonical schema: /reference/data-models#database-validation
\- Per-feature report: /core-technology/database-validation/database-validation-report
\- Risk catalogue: /core-technology/database-validation/database-validation-warnings
\- Outcome codes: /core-technology/database-validation/database-validation-outcome-codes
\- Full integration playbook: /integration/integration-prompt````
\
## Didit을 선택해야 하는 이유- **가장 경제적인 호출당 과금 체계.** 검사당 최저 **\$0.05**(도미니카 공화국)부터 가장 비용이 높은 전문 소스의 경우 최대 **\$7.00**까지 다양합니다. 가격은 국가별이 아닌 서비스별로 책정되며, 높은 도매 요금을 부과하는 등록부는 그에 맞게 가격이 책정됩니다(핀란드 주민등록증은 **\$2.10**). [서비스별 요금표](https://docs.didit.me/ko/getting-started/database-validation-pricing.md)에서 호출하려는 특정 서비스의 요금을 항상 확인하십시오. 월간 최소 비용, 플랫폼 수수료, 시트당 청구가 없으며 성공한 쿼리에 대해서만 비용이 청구됩니다.
- **가장 빠른 연동.** [회원가입](https://business.didit.me/) 후 콘솔에서 API 키를 발급받으면 몇 분 안에 `POST /v3/database-validation/`을 호출할 수 있습니다. 영업 상담, 조달 절차, 개념 증명(PoC) 서류 작업 없이 Didit은 완전한 셀프서비스 방식으로 제공됩니다.
- **공인 기관으로의 직접 조회.** 애그리게이터의 스크래핑이 아닌 RENAPER, Receita Federal (SERPRO), Tribunal Electoral, RENAPO, RENAP, RNP, RNPN, Junta Central Electoral, Registraduría Nacional, SEGIP, Servicio de Registro Civil, Tribunal Supremo de Elecciones, Dirección General de la Policía 등으로 직접 조회합니다.
- **등록부에 공식 사진이 등록되어 있는 경우 얼굴 대조 지원.** 추가 연동 작업 없이 OCR보다 높은 신뢰도를 제공합니다.
- **프로덕션 환경에 최적화된 지연 시간.** p95 기준 일반적으로 엔드투엔드 1.5초 미만이며 분기별 가동률 99.9%를 제공합니다.인증 결과를 확인하는 방법에 대한 Academy 강의는 11:05부터 데이터베이스 검증을 다루며, 완전 일치, 부분 일치, 일치 없음 결과를 보여줍니다.[데이터베이스 검증: 완전 일치, 부분 일치 및 일치 없음 — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=665\&rel=0\&playsinline=1)## 글로벌 서비스 지원강조 표시된 국가에 마우스를 올리면 해당 국가에서 지원하는 모든 데이터베이스 검증 서비스, 데이터 도메인(신원, 금융, 생체 인식, 주소, 통신, …) 및 호출당 가격을 확인할 수 있습니다. 활성화된 국가는 현재 즉시 프로덕션 환경에서 사용 가능하며, 그 외 국가는 고객의 요청에 따라 온디맨드로 연동됩니다.Live Database Validation coverageProduction-ready countries and the cheapest live service available in each.LIVEShow on-demand catalog countries ()
| 국가 |
\ISO3 |
\서비스 |
\설명 |
\가격 (USD) |
|---|
\
## 계속 읽기- [일치 방식](https://docs.didit.me/ko/core-technology/database-validation/database-validation-matching-methods.md) — 1×1 / 2×2 결과가 도출되는 방식과 이에 대응하는 방법.
- [결과 코드](https://docs.didit.me/ko/core-technology/database-validation/database-validation-outcome-codes.md) — 제공자 응답 코드(사망자, 미성년자, 문서 없음, 생체 인식 불일치 등)의 전체 목록과 세션 결정에 매핑되는 방식.
- [경고](https://docs.didit.me/ko/core-technology/database-validation/database-validation-warnings.md) — 데이터 누락으로 인해 서비스가 실행될 수 없을 때 표시되는 정보.
- [보고서](https://docs.didit.me/ko/core-technology/database-validation/database-validation-report.md) — 국가, 서비스 ID, 사용량, 단가 및 총비용이 포함된 서비스별 월간 결제 내역 내보내기.
- [지원 국가](https://docs.didit.me/ko/core-technology/database-validation/database-validation-supported-countries.md) — 현재 지원되는 모든 국가의 정적 테이블 뷰.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.