데이터베이스 검증 - 서비스 활성화와 과금 기준
데이터베이스 검증은 추출된 신원 정보를 정부 또는 공인 등록부와 대조합니다. 서비스에 "온보딩이 필요합니다"라고 표시되는 이유, 403이나 빈 응답이 돌아오는 이유, 어떤 조회가 과금되는지 설명합니다.
데이터베이스 검증은 공식 등록부를 상대로 백그라운드에서 실행되며, 사용자는 이를 전혀 보지 못합니다. 조직의 첫 충전 이후에만 활성화되고, 일부 서비스는 Didit이 활성화해 줄 때까지 **"온보딩이 필요합니다"**라고 표시되며, 등록부가 실제로 응답한 모든 조회는 불일치를 포함해 과금됩니다.
문서를 읽으면 그 위에 무엇이 인쇄되어 있는지 알 수 있습니다. 데이터베이스 검증은 공인된 출처가 그것에 동의하는지 알려 줍니다. 주민등록부, 세무 당국, 신용정보기관, 운전면허 데이터베이스 등입니다. 각 국가는 하나 이상의 서비스를 제공하며, 각 서비스마다 가격, 입력 항목, 동의 규칙이 다릅니다. 지원 국가 및 서비스와 서비스별 가격을 참고하세요.
#문서 단계 이후에 조용히 실행됩니다
데이터베이스 검증 화면은 없습니다. 이 단계는 신분증에서 추출한 데이터(또는 세션 생성 시 전달한 데이터)를 등록부에 보내고 그 응답을 세션 보고서에 저장합니다. 여기서 두 가지가 따라옵니다.
- 신분증 단계에서 잘못된 번호나 이름을 추출했다면 등록부는 잘못된 값으로 조회되고, 검증은 실패하거나 판정 불가로 돌아옵니다. 먼저 추출 결과를 수정하세요. 잘못 읽힌 이름이나 항목 수정하기를 참고하세요.
- 신분증이나 셀피처럼 데이터베이스 검증을 사용자에게 "재제출"시킬 수는 없습니다. 사용자가 다시 할 것이 없기 때문입니다.
DATABASE_VALIDATION재제출을 요청하면 해당 기능이 이 세션에서 재제출 가능한 단계가 아니라는 오류가 반환됩니다. 다시 실행하려면 수정된 데이터로 독립 데이터베이스 검증 API를 호출하세요. 이 호출은 다른 조회와 마찬가지로 건당 과금됩니다.
#실행되지 않는 이유
이 순서대로 확인하세요. "데이터베이스 검증이 아무것도 하지 않았다"는 문의 대부분이 여기서 설명됩니다.
- 조직이 한 번이라도 충전한 적이 있나요?
데이터베이스 검증(그리고 전화번호 검증)은 첫 충전 이후에만 활성화됩니다. 신규 계정 $10을 포함한 환영 크레딧은 인정되지 않습니다. 그 전까지 이 단계는 건너뛰어지고, 검증이 조용히 수행되지 않은 채 세션이 승인으로 돌아올 수 있으며,
POST /v3/database-validation/를 직접 호출하면 403이 응답됩니다. 충전, 청구서 및 결제 수단을 참고하세요. - 서비스에 온보딩이 필요합니다 표시가 있나요?
워크플로의 데이터베이스 검증 단계에서 일부 서비스는 **"온보딩이 필요합니다. 활성화하려면 Didit 지원팀에 문의하세요."**라고 표시됩니다. 서비스는 보이지만 Didit이 활성화할 때까지 조직에서는 비활성 상태입니다. 버그가 아니며 셀프서비스 스위치도 없습니다. 서비스와 국가를 명시해 지원 티켓을 열면 팀이 온보딩을 시작합니다.
- 해당 국가가 구성되어 있나요?
워크플로에서 선택한 적 없는 국가로 API를 호출하거나, 활성화하지 않은 서비스를 독립 호출하면 해당 국가에 대해 "No database validation services configured"로 응답합니다. 단계에 서비스를 추가하거나 국가 페이지의 정확한
service_id를 전달하세요. - 잔액이 양수인가요?
데이터베이스 검증은 무료 티어에 포함되지 않습니다. 잔액이 0이거나 음수이면 다른 유료 기능과 마찬가지로
insufficient_credits가 반환됩니다. "크레딧 부족" 오류 해결을 참고하세요.
#제공자 온보딩이 필요한 서비스
일부 정부 출처는 스위치를 켜는 것만으로는 부족하고, Didit이 귀하의 조직을 제공자에 등록해야 합니다. 현재 해당되는 곳은 다음과 같습니다.
- 호주(DVS: 운전면허증, 여권, 비자, Medicare 및 기타 DVS 서비스)
- 뉴질랜드(DIA: 여권, 시민권, 출생 및 사망 기록, 운전면허증)
- 캐나다(신용정보기관 및 FINTRAC 방식의 대조 서비스)
이 경우 지원팀이 제공자의 양식을 보내 드리고, 제공자가 계정용 자격 증명을 발급하며, 활성화까지 보통 최대 2주가 걸립니다. 호주와 뉴질랜드는 그동안 최소 서비스 계약(일회성 선불 금액, 현재 5,000 USD이며 만료되지 않는 크레딧으로 잔액에 들어감)도 요구해 왔습니다. 이 요건은 두 국가의 등록부 접근에만 적용되고 Didit의 다른 기능에는 해당되지 않으며, Didit이 호주 제도에서 자체 인증을 완료함에 따라 개정 중이므로, 이를 전제로 계획하기 전에 지원팀에 현재 조건을 문의하세요.
일부 서비스는 조회를 보내기 전에 최종 사용자의 명시적 동의도 요구합니다(예: 뉴질랜드 DIA 여권 조회). 워크플로 단계에 해당 서비스가 표시되며, 검증이 실행되기 전에 귀하의 플로에서 동의를 수집해야 합니다.
#과금 기준
서비스별로, 등록부가 응답한 조회마다 해당 서비스 페이지의 가격을 지불합니다. "등록부에 물었고 답이 왔다"로 읽어야 하며, "원하던 답이 왔다"가 아닙니다.
| 결과 | 과금? |
|---|---|
| 일치, 부분 일치, 불일치 | 예 |
| 판정 불가, 생체 이미지 사용 불가 | 예 |
| 잘못된 문서 형식, 잘못된 입력(등록부가 거부) | 예 |
REGISTRY_UNAVAILABLE, REGISTRY_ERROR(등록부가 응답하지 않음) | 아니요 |
| 등록부에 도달하기 전에 거부된 요청(독립 API의 400, 또는 누락되거나 잘못된 항목으로 워크플로 단계가 건너뛰어짐) | 아니요 |
여러 서비스를 실행하면 한 세션에서 여러 건의 과금 조회가 발생할 수 있으며, 조회는 국가별이 아니라 서비스별로 한 번 과금됩니다. 전체 내역: 데이터베이스 검증 가격 및 결과 코드.
빈 결과는 불일치가 아닙니다. 서비스가 NO_MATCH 결과 대신 아무것도 반환하지 않는다면,
흔한 원인은 첫 충전 규칙, 온보딩 대기 중인 서비스, 등록부 장애입니다. 연동을 디버깅하기 전에
이것들을 먼저 배제하세요. API 오류와 그 의미를 참고하세요.
#돌아오는 것
각 서비스는 표준 결과 코드와 함께 출처가 허용하는 범위에서 등록부 자체 데이터를 반환합니다. 어떤 항목이 일치했는지, 등록부가 예/아니요 대신 점수를 매기는 경우의 일치 점수, 생체 서비스(아르헨티나 RENAPER, 나이지리아 BVN, 파나마)의 경우 등록부 초상 사진과의 얼굴 비교 결과입니다. 이 응답에서 Didit이 무엇을 저장할지는 해당 단계의 반환된 데이터 설정이 결정합니다. 검증이 반환할 데이터 선택하기와 데이터베이스 검증 보고서를 참고하세요.
#실서비스 전 테스트
샌드박스 애플리케이션은 실제 등록부에 도달하지 않고 크레딧도 소모하지 않습니다. decline_database_no_match 같은 샌드박스 시나리오로 연습하려는 결과를 강제할 수 있습니다. 샌드박스가 알려 줄 수 없는 것은 특정 서비스가 실서비스 조직에 프로비저닝되어 있는지 여부이며, 이는 첫 충전과 실제 호출이 필요합니다. 샌드박스에서 테스트하기를 참고하세요.