# 데이터베이스 검증 - 서비스 활성화와 과금 기준

Source: https://help.didit.me/ko/documents-coverage/database-validation
Updated: 2026-09-15

데이터베이스 검증은 추출된 정보를 공식 등록부와 백그라운드에서 대조합니다. 첫 충전 후 활성화되고, 등록부가 응답한 모든 조회는 불일치 포함 과금됩니다.

데이터베이스 검증은 공식 등록부를 상대로 **백그라운드에서** 실행되며, 사용자는 이를 전혀 보지
못합니다. 조직의 **첫 충전** 이후에만 활성화되고, 일부 서비스는 Didit이 활성화해 줄 때까지
**"온보딩이 필요합니다"**라고 표시되며, 등록부가 실제로 응답한 모든 조회는 **불일치를 포함해**
과금됩니다.

[Video: 정부 데이터베이스 검사 - Didit Academy](https://www.youtube.com/watch?v=OksmtyKHe48&t=18)

문서를 읽으면 그 위에 무엇이 인쇄되어 있는지 알 수 있습니다. 데이터베이스 검증은 공인된 출처가 그것에 동의하는지 알려 줍니다. 주민등록부, 세무 당국, 신용정보기관, 운전면허 데이터베이스 등입니다. 각 국가는 하나 이상의 **서비스**를 제공하며, 각 서비스마다 가격, 입력 항목, 동의 규칙이 다릅니다. [지원 국가 및 서비스](https://docs.didit.me/core-technology/database-validation/database-validation-supported-countries)와 [서비스별 가격](https://docs.didit.me/getting-started/database-validation-pricing)을 참고하세요.

## 문서 단계 이후에 조용히 실행됩니다

데이터베이스 검증 화면은 없습니다. 이 단계는 신분증에서 추출한 데이터(또는 세션 생성 시 전달한 데이터)를 등록부에 보내고 그 응답을 세션 보고서에 저장합니다. 여기서 두 가지가 따라옵니다.

- 신분증 단계에서 잘못된 번호나 이름을 추출했다면 등록부는 잘못된 값으로 조회되고, 검증은 실패하거나 판정 불가로 돌아옵니다. 먼저 추출 결과를 수정하세요. [잘못 읽힌 이름이나 항목 수정하기](https://help.didit.me/ko/verification-sessions/correct-extracted-data)를 참고하세요.
- 신분증이나 셀피처럼 **데이터베이스 검증을 사용자에게 "재제출"시킬 수는 없습니다.** 사용자가 다시 할 것이 없기 때문입니다. `DATABASE_VALIDATION` 재제출을 요청하면 해당 기능이 이 세션에서 재제출 가능한 단계가 아니라는 오류가 반환됩니다. 다시 실행하려면 수정된 데이터로 [독립 데이터베이스 검증 API](https://docs.didit.me/standalone-apis/database-validation)를 호출하세요. 이 호출은 다른 조회와 마찬가지로 건당 과금됩니다.

## 실행되지 않는 이유

이 순서대로 확인하세요. "데이터베이스 검증이 아무것도 하지 않았다"는 문의 대부분이 여기서 설명됩니다.

1. **조직이 한 번이라도 충전한 적이 있나요?**

   데이터베이스 검증(그리고 전화번호 검증)은 **첫 충전** 이후에만 활성화됩니다. 신규 계정 $10을 포함한 환영 크레딧은 인정되지 않습니다. 그 전까지 이 단계는 건너뛰어지고, 검증이 조용히 수행되지 않은 채 세션이 승인으로 돌아올 수 있으며, `POST /v3/database-validation/`를 직접 호출하면 **403**이 응답됩니다. [충전, 청구서 및 결제 수단](https://help.didit.me/ko/billing-credits/top-ups-invoices-and-payments)을 참고하세요.

2. **서비스에 온보딩이 필요합니다 표시가 있나요?**

   워크플로의 데이터베이스 검증 단계에서 일부 서비스는 **"온보딩이 필요합니다. 활성화하려면 Didit 지원팀에 문의하세요."**라고 표시됩니다. 서비스는 보이지만 Didit이 활성화할 때까지 조직에서는 비활성 상태입니다. 버그가 아니며 셀프서비스 스위치도 없습니다. 서비스와 국가를 명시해 지원 티켓을 열면 팀이 온보딩을 시작합니다.

3. **해당 국가가 구성되어 있나요?**

   워크플로에서 선택한 적 없는 국가로 API를 호출하거나, 활성화하지 않은 서비스를 독립 호출하면 해당 국가에 대해 "No database validation services configured"로 응답합니다. 단계에 서비스를 추가하거나 국가 페이지의 정확한 `service_id`를 전달하세요.

4. **잔액이 양수인가요?**

   데이터베이스 검증은 무료 요금제 크레딧으로 결제되지 않습니다. 잔액이 0이거나 음수이면 다른 유료 기능과 마찬가지로 `insufficient_credits`가 반환됩니다. ["크레딧 부족" 오류 해결](https://help.didit.me/ko/billing-credits/not-enough-credits)을 참고하세요.

## 제공자 온보딩이 필요한 서비스

일부 정부 출처는 스위치를 켜는 것만으로는 부족하고, Didit이 **귀하의** 조직을 제공자에 등록해야 합니다. 현재 해당되는 곳은 다음과 같습니다.

- **호주**(DVS: 운전면허증, 여권, 비자, Medicare 및 기타 DVS 서비스)
- **뉴질랜드**(DIA: 여권, 시민권, 출생 및 사망 기록, 운전면허증)
- **캐나다**(신용정보기관 및 FINTRAC 방식의 대조 서비스)

이 경우 지원팀이 제공자의 양식을 보내 드리고, 제공자가 계정용 자격 증명을 발급하며, 활성화까지 보통 **최대 2주**가 걸립니다. 호주와 뉴질랜드는 그동안 최소 서비스 계약(일회성 선불 금액, 현재 5,000 USD이며 만료되지 않는 크레딧으로 잔액에 들어감)도 요구해 왔습니다. 이 요건은 두 국가의 등록부 접근에만 적용되고 Didit의 다른 기능에는 해당되지 않으며, Didit이 호주 제도에서 자체 인증을 완료함에 따라 개정 중이므로, 이를 전제로 계획하기 전에 지원팀에 현재 조건을 문의하세요.

> **Note:** 일부 서비스는 조회를 보내기 전에 **최종 사용자의 명시적 동의**도 요구합니다(예: 뉴질랜드 DIA
> 여권 조회). 워크플로 단계에 해당 서비스가 표시되며, 검증이 실행되기 전에 귀하의 플로에서 동의를
> 수집해야 합니다.

## 과금 기준

**서비스별로, 등록부가 응답한 조회마다** 해당 서비스 페이지의 가격을 지불합니다. "등록부에 물었고 답이 왔다"로 읽어야 하며, "원하던 답이 왔다"가 아닙니다.

| 결과 | 과금? |
|---|---|
| 일치, 부분 일치, 불일치 | 예 |
| 판정 불가, 생체 이미지 사용 불가 | 예 |
| 잘못된 문서 형식, 잘못된 입력(등록부가 거부) | 예 |
| `REGISTRY_UNAVAILABLE`, `REGISTRY_ERROR`(등록부가 응답하지 않음) | 아니요 |
| 등록부에 도달하기 전에 거부된 요청(독립 API의 400, 또는 누락되거나 잘못된 항목으로 워크플로 단계가 건너뛰어짐) | 아니요 |

여러 서비스를 실행하면 한 세션에서 여러 건의 과금 조회가 발생할 수 있으며, 조회는 국가별이 아니라 서비스별로 한 번 과금됩니다. 전체 내역: [데이터베이스 검증 가격](https://docs.didit.me/getting-started/database-validation-pricing) 및 [결과 코드](https://docs.didit.me/core-technology/database-validation/database-validation-outcome-codes).

> **Warning:** **빈** 결과는 불일치가 아닙니다. 서비스가 `NO_MATCH` 결과 대신 아무것도 반환하지 않는다면,
> 흔한 원인은 첫 충전 규칙, 온보딩 대기 중인 서비스, 등록부 장애입니다. 연동을 디버깅하기 전에
> 이것들을 먼저 배제하세요. [API 오류와 그 의미](https://help.didit.me/ko/integration/api-errors)를 참고하세요.

## 돌아오는 것

각 서비스는 표준 결과 코드와 함께 출처가 허용하는 범위에서 등록부 자체 데이터를 반환합니다. 어떤 항목이 일치했는지, 등록부가 예/아니요 대신 점수를 매기는 경우의 일치 점수, 생체 서비스(아르헨티나 RENAPER, 나이지리아 BVN, 파나마)의 경우 등록부 초상 사진과의 얼굴 비교 결과입니다. 이 응답에서 Didit이 무엇을 저장할지는 해당 단계의 **반환된 데이터** 설정이 결정합니다. [검증이 반환할 데이터 선택하기](https://help.didit.me/ko/workflows/returned-data)와 [데이터베이스 검증 보고서](https://docs.didit.me/core-technology/database-validation/database-validation-report)를 참고하세요.

## 실서비스 전 테스트

샌드박스 애플리케이션은 실제 등록부에 도달하지 않고 크레딧도 소모하지 않습니다. `decline_database_no_match` 같은 샌드박스 시나리오로 연습하려는 결과를 강제할 수 있습니다. 샌드박스가 알려 줄 수 없는 것은 특정 서비스가 실서비스 조직에 프로비저닝되어 있는지 여부이며, 이는 첫 충전과 실제 호출이 필요합니다. [샌드박스에서 테스트하기](https://help.didit.me/ko/getting-started/sandbox-and-testing)를 참고하세요.