Перейти к основному содержанию
Поле document_subtype в отчёте о верификации личности определяет конкретный вариант документа, распознанный Didit, — например, водительское удостоверение Квинсленда в отличие от общего водительского удостоверения, или коммерческое водительское удостоверение США (CDL) в отличие от стандартного. На этой странице перечислены все значения, которые может возвращать это поле.
Ваш сценарий принимает только часть из них — то, что вы выбрали на шаге настройки документов в сценарии. Чтобы получить точный список разрешённых документов для вашего сценария, используйте endpoint получения сценария в Management API (documents_allowed в узле OCR), а не предполагайте, что все значения ниже включены для вас.

​
Шаблон именования

Каждое значение document_subtype имеет один из двух форматов:
  • Базовая категория — {CATEGORY}, для документов, которые Didit не требуется разделять по регионам (большинство паспортов, большинство национальных удостоверений личности), например PASSPORT_GENERIC, ID_CARD_GENERIC.
  • С префиксом региона — {REGION}_{CATEGORY}, для документов, формат или классификация которых действительно различаются в зависимости от штата, провинции или территории, например QUEENSLAND_DRIVER_LICENSE_GENERIC (Австралия) или CALIFORNIA_COMMERCIAL_DL (США). Префикс региона представляет собой название штата/провинции, в которой выдан документ, в верхнем регистре, где пробелы заменены на подчёркивания.
Документ получает подтип с префиксом региона только тогда, когда в реестре документов Didit есть отдельный, отдельно классифицированный вариант для этого региона. Отсутствие варианта с префиксом региона не означает, что данный тип документа не существует в этом регионе, — это означает, что Didit в настоящее время сообщает о нём в рамках базовой категории уровня страны (см. оговорку о CDL ниже для конкретного примера).

​
Все значения подтипов

В таблице ниже приведён полный перечень значений document_subtype, которые может возвращать отчёт, сгруппированных по семейству document_type. В неё уже включены варианты с префиксами регионов — например, как DRIVER_LICENSE_GENERIC (большинство стран), так и CALIFORNIA_DRIVER_LICENSE_GENERIC отображаются как отдельные строки в разделе «Водительское удостоверение». Код базовой категории не уникален для одной страны — он используется всеми странами, для записей документов которых в реестре нет регионального варианта. Например, ID_CARD_GENERIC охватывает национальные удостоверения личности примерно 170 стран. Выполняйте поиск кода только по группировке document_type и (при наличии) по префиксу региона, и никогда не предполагайте, что код однозначно сопоставлен с одной страной.

​
Водительские удостоверения США: стандартные против коммерческих (CDL)

Поле document_type имеет значение "Driver's License" как для стандартного водительского удостоверения, так и для коммерческого водительского удостоверения (CDL) — оно никогда их не разделяет. Различие полностью определяется значением document_subtype. В 48 из 51 штата и территории США, которые классифицирует Didit, CDL получает собственный подтип {STATE}_COMMERCIAL_DL, отличный от {STATE}_DRIVER_LICENSE_GENERIC этого штата. Рассматривать document_subtype, оканчивающийся на _COMMERCIAL_DL, как признак того, что «это CDL», является надёжным сигналом в этих штатах.
В настоящее время на Аляске, в округе Колумбия и на Гавайях нет отдельного подтипа CDL. CDL из одной из этих трёх юрисдикций возвращается со стандартным подтипом _DRIVER_LICENSE_GENERIC этой юрисдикции — его невозможно отличить от некоммерческого удостоверения только по полю document_subtype. Если вам требуется безошибочное определение CDL конкретно для этих трёх юрисдикций, свяжитесь с нами, чтобы зарегистрировать недостающие варианты документов, или примените дополнительную проверку (например, потребовав от водителя отдельно предоставить номер CDL/DOT для верификации).

​
extra_fields.dl_categories не является надёжным сигналом CDL

Некоторые удостоверения США также возвращают extra_fields.dl_categories — список букв классов (A, B, C, …), напечатанных на карте и прочитанных с помощью OCR. Не используйте это как сигнал CDL. На сегодняшний день это поле заполняется лишь для небольшого числа конфигураций водительских удостоверений США, значения букв классов различаются в зависимости от штата и не нормализованы по семантике «коммерческое / некоммерческое», а коды допусков или ограничений (в которых на многих удостоверениях фактически и указывается статус «коммерческое») в настоящее время вообще не передаются в отчёте. Поле document_subtype на сегодняшний день является единственным структурированным и надёжным сигналом для различия между стандартными и коммерческими удостоверениями.

​
Поддержание актуальности

О новых семействах document_type объявляется в ежемесячном списке изменений по мере их добавления. Добавления document_subtype — например, новый региональный вариант существующего типа документа — в настоящее время отдельно не анонсируются; реестр документов Didit растёт непрерывно по мере подключения новых форматов документов. В payload webhook для этого списка нет номера версии. Если вашей интеграции требуется распознавать подтипы, с которыми она ранее не сталкивалась, а не считать их набор фиксированным, обрабатывайте любое нераспознанное вашим кодом значение document_subtype как «не классифицировано, ручная проверка» вместо того чтобы выдавать ошибку, и периодически сверяйтесь с этой страницей или списком разрешённых подтипов вашего сценария через Management API.

​
Связанные материалы

Последнее изменение 7 ноября 2026 г.