document_subtype 코드 레퍼런스: 전체 목록

신분증 인증 보고서의 document_subtype은 Didit이 인식한 구체적인 문서 변형을 식별합니다. 예를 들어 일반 운전면허증 대비 퀸즐랜드 운전면허증, 또는 표준 운전면허증 대비 미국 상업용 운전면허증(CDL) 등이 있습니다. 이 페이지에서는 해당 필드가 반환할 수 있는 모든 값을 나열합니다.

​

명명 패턴

모든 document_subtype 값은 다음 두 가지 형태 중 하나입니다.

• 기본 카테고리 — {CATEGORY} 형태로, Didit에서 지역별로 구분할 필요가 없는 문서(대부분의 여권, 대부분의 주민등록증/국가 신분증)에 사용됩니다(예: PASSPORT_GENERIC, ID_CARD_GENERIC).
• 지역 접두사 포함 — {REGION}_{CATEGORY} 형태로, 주(state), 도/지방(province) 또는 영토(territory)에 따라 형식이나 분류가 실질적으로 다른 문서에 사용됩니다(예: 호주의 QUEENSLAND_DRIVER_LICENSE_GENERIC 또는 미국의 CALIFORNIA_COMMERCIAL_DL). 지역 접두사는 발급 주/도 이름을 대문자로 표기하고 공백을 밑줄로 대체한 형태입니다.

문서는 Didit의 문서 레지스트리에 해당 지역에 대해 별도로 분류된 고유 변형이 있을 때만 지역 접두사가 붙은 하위 유형을 갖습니다. 지역 접두사가 붙은 변형이 없다고 해서 해당 지역에 해당 문서 유형이 존재하지 않는다는 의미는 아니며, Didit이 현재 이를 국가 수준의 기본 카테고리로 대신 보고한다는 의미입니다(구체적인 예는 아래의 CDL 관련 주의사항 참조).

​

모든 하위 유형 값

아래 표는 보고서가 반환할 수 있는 document_subtype 값의 전체 목록이며, document_type 패밀리별로 그룹화되어 있습니다. 여기에는 지역 접두사가 붙은 변형도 이미 포함되어 있습니다. 예를 들어 DRIVER_LICENSE_GENERIC(대부분의 국가)과 CALIFORNIA_DRIVER_LICENSE_GENERIC은 모두 Driver’s License 아래에 별도의 행으로 표시됩니다. 기본 카테고리 코드는 단일 국가에만 고유한 것이 아니며, 해당 문서의 레지스트리 항목에 지역별 변형이 없는 모든 국가에서 공유됩니다. 예를 들어 ID_CARD_GENERIC은 약 170개국의 국가 신분증을 포괄합니다. 코드가 단일 국가에 매핑된다고 가정하지 말고, 항상 document_type 그룹과 (존재하는 경우) 지역 접두사로 코드를 조회하십시오.

​

미국 운전면허증: 표준 대 상업용(CDL)

표준 운전면허증과 상업용 운전면허증(CDL) 모두 document_type은 "Driver's License"이며, 이를 구분하지 않습니다. 구별은 전적으로 document_subtype에서 이루어집니다. Didit이 분류하는 51개 미국 주 및 영토 중 48개에서는 CDL에 해당 주의 {STATE}_DRIVER_LICENSE_GENERIC과 구분되는 고유한 {STATE}_COMMERCIAL_DL 하위 유형이 부여됩니다. 해당 주에서는 _COMMERCIAL_DL로 끝나는 document_subtype을 “CDL 문서”로 취급하는 것이 신뢰할 수 있는 신호입니다.

​

extra_fields.dl_categories는 신뢰할 수 있는 CDL 신호가 아닙니다

일부 미국 면허증에서는 OCR을 통해 읽은 카드에 인쇄된 등급 문자(A, B, C, …) 목록인 extra_fields.dl_categories도 생성됩니다. 이를 CDL 신호로 사용하지 마십시오. 현재 이 필드는 소수의 미국 운전면허증 구성에 대해서만 채워지며, 등급 문자의 의미는 주마다 다르고 상업용/비상업용 의미 체계로 표준화되어 있지 않습니다. 또한 배서 또는 제한 코드(많은 면허증에서 “상업용”이 실제로 표기되는 부분)는 현재 보고서에 전혀 노출되지 않습니다. 현재로서는 document_subtype만이 표준 면허와 상업용 면허를 구분할 수 있는, 구조화된 신뢰할 수 있는 유일한 신호입니다.

​

최신 상태 유지하기

새로운 document_type 패밀리는 출시될 때 월간 변경 로그를 통해 공지됩니다. 예를 들어 기존 문서 유형의 새로운 지역 변형과 같은 document_subtype 추가 사항은 현재 개별적으로 공지되지 않습니다. 새로운 문서 형식이 온보딩됨에 따라 Didit의 문서 레지스트리는 지속적으로 확장됩니다. 이 목록에 대해 webhook payload에 버전 번호는 제공되지 않습니다. 연동 시스템에서 하위 유형 집합이 고정되어 있다고 가정하지 않고 이전에 본 적 없는 하위 유형을 감지해야 하는 경우, 코드에서 인식하지 못하는 모든 document_subtype 값을 오류로 처리하기보다는 “미분류, 수동 검토”로 처리하고 이 페이지나 Management API를 통해 워크플로의 허용 하위 유형 목록을 주기적으로 다시 확인하십시오.

​

관련 항목

• 신분증 인증 보고서 — 맥락에서의 document_type / document_subtype 필드.
• 지원되는 신분증 문서 — Didit이 지원하는 국가 및 문서 유형.
• 데이터 모델 — 신분증 인증 — 표준 필드 스키마.