Верификация личности: документ, база данных, кошелёк

Верификация личности представляет собой одну функцию с тремя методами. Вы выбираете, какие методы разрешены для страны; конечный пользователь получает те из них, которые применимы к выбранной им стране, а сессия фиксирует, какой именно метод сформировал результат.

Метод	Что делает пользователь	Уровень достоверности
Съёмка документа	Фотографирует свой паспорт, ID-карту, водительское удостоверение или вид на жительство	Документальный
Проверка без документа	Вводит свой национальный идентификационный номер и несколько личных данных, которые сверяются с государственным или иным авторитетным источником	Сопоставление данных
Кошелёк	Выполняет вход с помощью государственной или банковской цифровой идентичности, такой как MitID, BankID или itsme	Криптографический

Съёмка документа остаётся без изменений. Всё, что вы уже настраиваете через documents_allowed — допустимые типы, подтипы, правила съёмки, пороги, предупреждения — продолжает работать точно так же, как и раньше, а сценарий, в котором методы не указаны, использует только съёмку документа.

Как работает каждый метод

Съёмка документа

То, что описано в остальной части этого раздела: пользователь фотографирует документ, Didit считывает его, проверяет подлинность и возвращает извлечённые поля. Доступно во всех странах, поддерживаемых Didit, по цене $0.15 за проверку. Начните с раздела Обзор Верификации личности.

Проверка без документа

Пользователь вводит свой национальный идентификационный номер и несколько личных данных, а Didit сверяет их с авторитетным источником для этой страны. Фотографировать документ при этом не требуется. В большинстве стран таким источником является государственный реестр, но не во всех: в Канаде, Франции, Индонезии, Нидерландах, Норвегии, Сингапуре, Великобритании и США вместо него используются данные кредитных бюро, финансовых сервисов, коммунальных служб или записи о регистрации по месту жительства. Поскольку происхождение данных и применимый режим согласия зависят от источника, точный источник указан для каждой страны в таблице ниже и на странице Проверка без документа — без обобщений. Если источник возвращает фотографию — на сегодняшний день это Южная Африка, Нигерия, Аргентина и Панама, во всех четырёх случаях это государственные реестры — у пользователя также запрашивается селфи. Для этого селфи выполняется пассивная проверка живости, после чего проводится сравнение лиц с фотографией из реестра, причём всё это в рамках одной проверки и включено в её стоимость. Если источник возвращает только данные, сопоставлять лицо не с чем, поэтому селфи не запрашивается; при необходимости добавьте шаги Проверка живости и Сравнение лиц в качестве отдельных шагов сценария. Полный список полей запроса, правил форматирования и режимов согласия для каждой страны приведён на странице Проверка без документа.

Кошелёк

Пользователь выполняет вход с помощью цифрового удостоверения личности, которое у него уже есть, например, национального eID или банковской цифровой идентичности. Кошелёк аутентифицирует пользователя и передаёт подписанные атрибуты личности в Didit. В зависимости от кошелька пользователь может ввести личный идентификационный код или номер телефона; фотография документа для проверки через кошелёк не требуется. Процесс входа зависит от кошелька: переход в приложение, QR-код или код сравнения, подтверждаемый на телефоне пользователя. Smart-ID и Mobile-ID используют код сравнения. Атрибуты для каждого кошелька, доступность в продакшне и семантика ошибок описаны на странице Цифровые кошельки удостоверения личности.

Уровни достоверности

Каждый результат Верификации личности содержит уровень достоверности, зависящий от метода, с помощью которого он был получен. Этот уровень объективно описывает, что именно было подтверждено, а не является рейтингом:

Уровень	Значение в сессии	Что это означает
Документальный	`documentary`	Физический документ был сфотографирован, распознан и проверен на подлинность.
Сопоставление данных	`data_match`	Указанные пользователем данные совпали с записью в запрашиваемом источнике. Сам документ не проверялся.
Криптографический	`cryptographic`	Поставщик цифровой идентификации аутентифицировал пользователя и подписал переданные атрибуты.

Уровни достоверности предназначены для администраторов. Они отображаются в payload сессии, в консоли и в файлах экспорта. Конечные пользователи никогда не видят уровень достоверности, цену или название источника, к которому выполнялся запрос.

Настройка методов по странам

Методы настраиваются в ключе methods конфигурации функции Верификации личности (OCR) с привязкой к кодам стран по стандарту ISO 3166-1 alpha-3. Если опустить этот ключ, опустить страну или опустить метод внутри страны, для этой страны будет доступна только съёмка документа.

{
  "feature": "OCR",
  "config": {
    "methods": {
      "ZAF": {
        "document": { "enabled": true },
        "id_lookup": {
          "enabled": true,
          "max_attempts": 2,
          "skip_liveness_and_face_match": true,
          "on_partial_match": "fallback_to_document",
          "on_no_match": "fallback_to_document",
          "on_provider_error": "fallback_to_document"
        },
        "wallet": { "enabled": false, "providers": [], "on_failure": "fallback_to_document" }
      },
      "DNK": {
        "document": { "enabled": true },
        "id_lookup": { "enabled": true, "on_no_match": "decline" }
      }
    }
  }
}

Обе приведённые выше страны имеют статус available для проверки в опубликованном каталоге. В примере кошельки отключены, чтобы конфигурация не зависела от того, включён ли кошелёк в вашей среде. Сценарий, в котором активирован кошелёк со статусом Скоро появится, будет отклонён вместе со всей остальной конфигурацией в этом запросе на сохранение. Когда в каталоге кошелёк получает статус available для страны, блок кошелька для этой страны выглядит следующим образом:

{
  "DNK": {
    "document": { "enabled": true },
    "wallet": { "enabled": true, "providers": ["mitid"], "on_failure": "fallback_to_document" }
  }
}

Сверяйтесь с каталогом перед отправкой. Предварительное условие: кошелёк имеет статус «Доступен» для этой страны, как указано на странице Цифровые кошельки удостоверения личности. Два правила, которые API проверяет при сохранении:

Доступность определяется сервером. Метод или кошелёк, который каталог возможностей не помечает как available для данной страны, отклоняется. Сначала проверьте каталог — на вкладке Страны в консоли или с помощью MCP-инструмента didit_workflow_get_id_verification_methods_catalog.
Кошельки задаются белым списком, а не приоритетом. Массив providers определяет, какие кошельки могут быть предложены в стране. Порядок передачи не имеет значения и нормализуется; выбор делает конечный пользователь.

Полный справочник полей с описанием значений по умолчанию и валидации доступен на странице Конфигурации функций сценария.

Резервный переход: что происходит, если метод без использования документов не сработал

Дальнейшие действия определяют четыре переключателя. Каждый из них принимает значение либо fallback_to_document (перенаправить пользователя на захват документа), либо decline (завершить сессию с отклоненной Верификацией личности); параметр wallet.on_failure также поддерживает значение retry, описанное ниже. По умолчанию для всех четырех переключателей установлено значение fallback_to_document.

Переключатель	Срабатывает, когда
`id_lookup.on_partial_match`	Реестр ответил, но некоторые поля не совпали.
`id_lookup.on_no_match`	Реестр ответил и не нашел совпадающей записи.
`id_lookup.on_provider_error`	Не удалось связаться с реестром или он не ответил.
`wallet.on_failure`	Вход через кошелек был отменен, время ожидания входа истекло или вход завершился сбоем.

Параметр wallet.on_failure также принимает третье значение, retry, для страны, где поддерживается только кошелек (захват документов отключен):

Значение	Незавершенный вход в систему
`fallback_to_document`	Перенаправляет пользователя на захват документа.
`decline`	Завершает сессию с отклоненной Верификацией личности.
`retry`	Оставляет пользователя на шаге кошелька с сообщением «вход через не завершен» и одной основной кнопкой «Попробовать снова». Документ не предлагается, сессия никогда не отклоняется по этой причине и остается открытой, пока пользователь не завершит процесс или пока не истечет ее срок действия.

Вариант retry доступен только для кошельков: переключатели поиска по базам принимают fallback_to_document или decline, так как при ответе реестра «нет совпадений» повторять попытку бессмысленно. Это значение отклоняется в сочетании с document.fallback_only, для которого требуется сбой, ведущий к захвату документа. Вход через кошелек, данные которого не прошли проверки вашего сценария (возраст, совпадение имени и т. д.), считается подтвержденным входом: решение принимают правила сценария, а wallet.on_failure не применяется. Вход с подлинным, но неприемлемым token (неверный уровень доверия, недействительная подпись, отсутствие обязательных клеймов) считается сбоем и обрабатывается в соответствии с wallet.on_failure. Параметр id_lookup.max_attempts (от 1 до 5, по умолчанию 1) определяет, сколько попыток поиска с полученным ответом дается пользователю до срабатывания переключателя. Номер, не прошедший проверку формата на стороне клиента, не отправляется в реестр и не расходует попытку: пользователю просто предлагается исправить его. Резервный переход от кошелька или поиска к захвату документа возможен только в том случае, если для этой страны включен захват документов и принимается хотя бы один тип документа. Если захват документов отключен или для страны не поддерживается ни один тип документов, сессия отклоняется при неудачном входе или отсутствии совпадения при поиске, даже если в переключателе указано fallback_to_document. Исключение составляет wallet.on_failure: retry, при котором сессия никогда не отклоняется: пользователь остается на шаге кошелька. Резервный переход в этом случае выполнить некуда. Какой метод дал результат: fallback_from Поле verification_method всегда указывает метод, давший подтвержденный результат: wallet, id_lookup или document. Поле fallback_from объясняет, почему шаг верификации личности не был завершен методом без использования документов, в обоих случаях:

Выполнен резервный переход. Пользователь перенаправлен на захват документа. Последующая проверка документа содержит verification_method: "document" и fallback_from с указанием метода, который не сработал, например { "method": "wallet", "reason": "cancelled", "action": "fallback_to_document" }. Сессия, верифицированная с помощью кошелька, имеет verification_method: "wallet" и fallback_from: null.
Отклонение. Переключатель установлен в decline либо нет доступных документов для резервного перехода. Отклоненная Верификация личности содержит поле fallback_from со значением "action": "decline".

Параметр method принимает значение wallet или id_lookup, а reason указывает на исход, приведший к завершению (cancelled, timeout, no_match, provider_error и т. д.). Эти же поля передаются в решении по сессии и в webhook status.updated. Реестр, который не отвечает (таймаут или сбой в работе), является исключением: он никогда не приводит к автоматическому отклонению пользователя. Плата за такой поиск не взимается и попытка не расходуется; пользователю предлагается повторить попытку. После трех неотвеченных запросов на шаге применяется правило id_lookup.on_provider_error: decline отклоняет сессию, а fallback_to_document перенаправляет пользователя на захват документа. Если для этого переключателя задано значение fallback_to_document, но в стране нет доступных документов для резервного перехода, поиск остается открытым, и пользователь может продолжать попытки; сессия не отклоняется.

Предложение захвата документов только в качестве резервного варианта

По умолчанию для страны, где наряду с захватом документов предлагается кошелек или поиск по базам данных, все методы отображаются рядом на первом экране. Установите document.fallback_only в значение true, чтобы оставить захват документов включенным для страны, но не предлагать его сразу. Пользователи начинают с доступного для страны кошелька или поиска по базам данных. Если настроен один кошелек, пользователь сразу попадает на этот кошелек. На шаг захвата документа направляются только те пользователи, чей вход через кошелек завершился сбоем, был отменен или истек по таймауту, либо чей поиск не дал совпадений. То, какие именно из этих исходов ведут к захвату документов, по-прежнему определяется переключателями выше, поэтому хотя бы один из них должен иметь значение fallback_to_document.

{
  "FIN": {
    "document": { "enabled": true, "fallback_only": true },
    "wallet": { "enabled": true, "providers": ["ftn"], "on_failure": "fallback_to_document" }
  }
}

Параметр fallback_only является необязательным и по умолчанию имеет значение false. Он отклоняется, если document.enabled не установлен в true или если ни один кошелек или поиск по базам данных в этой стране не настроен на резервный переход к захвату документов. Укажите типы документов, которые должны предлагаться в качестве резервных, в documents_allowed, например паспорт и удостоверение личности для Финляндии.

Сколько стоит каждый метод

Метод	Цена
Захват документа	$0.15 за проверку
Поиск без документов	Публичные тарифы в USD по странам и идентификаторам

Это базовые цены: ваша скидка по тарифу применяется к обоим методам. Для поиска используются публичные розничные тарифы проверки по базам данных для тех сервисов, которые он запускает; в одну попытку могут входить несколько сервисов. В Нигерии выбирается либо NIN, либо BVN. В таблице по странам указана полная настроенная стоимость попытки, при этом каждая повторная попытка, получившая ответ, тарифицируется отдельно.

Правила биллинга

Реестр, вернувший ответ, тарифицирует поиск. Совпадение, частичное совпадение и отсутствие совпадения — всё учитывается: запрос был выполнен, а полученный ответ является результатом услуги.
Реестр, так и не вернувший ответ, не тарифицируется. Ошибка провайдера ничего не стоит.
Номер, не прошедший проверку формата на стороне клиента, никогда не тарифицируется и не засчитывается в max_attempts, поскольку он так и не дошел до реестра.
Захват документа тарифицируется дополнительно при переходе к резервному методу. Поиск, который вернул ответ, а затем перешел к захвату документа, тарифицируется двумя списаниями, поскольку были выполнены две проверки.

Покрытие

Захват документов доступен во всех странах, поддерживаемых Didit, и ниже не повторяется: $0.15 за проверку. В этой таблице перечислены только те страны, в которых существует бездокументный метод. Страна, которой нет в списке, или ячейка со значением «Не планируется», означает поддержку только захвата документов.

Страна	Код	Поиск без документов	Кошельки цифровых удостоверений
Аргентина	`ARG`	Доступно — RENAPER	Не планируется
Австралия	`AUS`	Не планируется	ConnectID (скоро)
Австрия	`AUT`	Не планируется	EUDI Wallet (скоро)
Бельгия	`BEL`	Не планируется	itsme (скоро), Smart-ID (доступно), EUDI Wallet (скоро)
Боливия	`BOL`	Доступно — SEGIP	Не планируется
Бразилия	`BRA`	Доступно — Receita Federal	gov.br (скоро), Google Wallet (доступно)
Болгария	`BGR`	Не планируется	EUDI Wallet (скоро)
Камбоджа	`KHM`	Доступно — реестр избирателей Министерства внутренних дел	Не планируется
Канада	`CAN`	Доступно — записи канадских кредитных бюро (двойной процесс FINTRAC)	Не планируется
Чили	`CHL`	Доступно — Servicio de Registro Civil e Identificación	Не планируется
Китай	`CHN`	Доступно — NCIIC (Национальный информационный центр идентификации граждан)	Не планируется
Колумбия	`COL`	Доступно — Registraduría General de la Nación / ANI	Не планируется
Коста-Рика	`CRI`	Доступно — Tribunal Supremo de Elecciones	Не планируется
Хорватия	`HRV`	Не планируется	EUDI Wallet (скоро)
Кипр	`CYP`	Не планируется	EUDI Wallet (скоро)
Чехия	`CZE`	Не планируется	Bank iD (скоро), MojeID (скоро), EUDI Wallet (скоро)
Дания	`DNK`	Доступно — реестр CPR	MitID (доступно), EUDI Wallet (скоро)
Доминиканская Республика	`DOM`	Доступно — Junta Central Electoral	Не планируется
Эквадор	`ECU`	Доступно — Registro Civil del Ecuador	Не планируется
Сальвадор	`SLV`	Доступно — RNPN	Не планируется
Эстония	`EST`	Не планируется	Smart-ID (доступно), Mobile-ID (доступно), эстонская ID-карта (скоро), EUDI Wallet (скоро)
Финляндия	`FIN`	Доступно — регистр народонаселения DVV	Finnish Trust Network (доступно), EUDI Wallet (скоро)
Франция	`FRA`	Доступно — французские записи о проживании и коммунальных услугах	FranceConnect (скоро), EUDI Wallet (скоро)
Германия	`DEU`	Не планируется	Personalausweis (скоро), EUDI Wallet (скоро)
Греция	`GRC`	Не планируется	EUDI Wallet (скоро)
Гватемала	`GTM`	Доступно — RENAP	Не планируется
Гондурас	`HND`	Доступно — CNE	Не планируется
Венгрия	`HUN`	Не планируется	EUDI Wallet (скоро)
Исландия	`ISL`	Не планируется	Auðkenni (скоро), EUDI Wallet (скоро)
Индия	`IND`	Доступно — UIDAI (Aadhaar)	Не планируется
Индонезия	`IDN`	Доступно — реестр населения Индонезии на основе данных о месте жительства	Не планируется
Ирландия	`IRL`	Не планируется	EUDI Wallet (скоро)
Италия	`ITA`	Не планируется	EUDI Wallet (скоро)
Кения	`KEN`	Доступно — IPRS (Integrated Population Registration System)	Не планируется
Латвия	`LVA`	Не планируется	Smart-ID (доступно), eParaksts mobile (скоро), EUDI Wallet (скоро)
Лихтенштейн	`LIE`	Не планируется	EUDI Wallet (скоро)
Литва	`LTU`	Не планируется	Smart-ID (доступно), Mobile-ID (доступно), EUDI Wallet (скоро)
Люксембург	`LUX`	Не планируется	itsme (скоро), EUDI Wallet (скоро)
Малайзия	`MYS`	Доступно — JPN (Национальный регистрационный департамент)	Не планируется
Мальта	`MLT`	Не планируется	EUDI Wallet (скоро)
Мексика	`MEX`	Доступно — RENAPO	Не планируется
Нидерланды	`NLD`	Доступно — данные о месте жительства в Нидерландах	itsme (скоро), iDIN (доступно), EUDI Wallet (скоро)
Нигерия	`NGA`	Доступно — NIMC / NIBSS	Не планируется
Норвегия	`NOR`	Доступно — данные о месте жительства в Норвегии	BankID (скоро), Vipps (скоро), Buypass ID (скоро), EUDI Wallet (скоро)
Панама	`PAN`	Доступно — Избирательный трибунал / SIB	Не планируется
Парагвай	`PRY`	Доступно — Высший трибунал избирательной юстиции	Не планируется
Перу	`PER`	Доступно — RENIEC	Не планируется
Польша	`POL`	Не планируется	EUDI Wallet (скоро)
Португалия	`PRT`	Не планируется	EUDI Wallet (скоро)
Румыния	`ROU`	Не планируется	EUDI Wallet (скоро)
Сингапур	`SGP`	Доступно — кредитное бюро Сингапура и данные коммунальных служб	Google Wallet (доступно)
Словакия	`SVK`	Не планируется	EUDI Wallet (скоро)
Словения	`SVN`	Не планируется	EUDI Wallet (скоро)
Южная Африка	`ZAF`	Доступно — Министерство внутренних дел	Не планируется
Испания	`ESP`	Не планируется	EUDI Wallet (скоро)
Швеция	`SWE`	Доступно — реестр населения Skatteverket	BankID (доступно), Freja eID (скоро), EUDI Wallet (скоро)
Тайвань	`TWN`	Не планируется	Google Wallet (доступно)
Таиланд	`THA`	Доступно — регистрация актов гражданского состояния DOPA	Не планируется
Украина	`UKR`	Не планируется	Diia (скоро)
Объединённые Арабские Эмираты	`ARE`	Не планируется	UAE PASS (скоро)
Великобритания	`GBR`	Доступно — данные кредитного бюро Великобритании и финансовых служб	OneID (скоро), Google Wallet (доступно), GOV.UK Wallet (скоро)
Соединённые Штаты	`USA`	Доступно — данные кредитного бюро США и финансовых служб	Google Wallet (доступно)
Уругвай	`URY`	Доступно — Dirección Nacional del Registro de Estado Civil	Не планируется
Венесуэла	`VEN`	Доступно — CNE	Не планируется
Замбия	`ZMB`	Доступно — Zambia Revenue Authority	Не планируется

Покрытие формируется на основе каталога возможностей, предоставляемого бэкендом, поэтому эта таблица служит тем же источником, с которым сверяются консоль и API. Скоро означает, что пункт отображается в консоли, но пока не может быть включен; это ещё не действующая возможность, и для неё нет гарантированной даты выпуска.

Что попадает в сессию

Каждый результат Верификации личности содержит метод, с помощью которого он был получен, его уровень надёжности и — если использовался метод без использования документов — блок подтверждающих данных для конкретного метода. Сессии с документами обрабатываются точно так же, как и раньше, а новые ключи имеют значение null.

Поле	Тип	Описание
`verification_method`	string	`document`, `id_lookup` или `wallet`.
`assurance`	string	`documentary`, `data_match` или `cryptographic`.
`wallet_provider`	string \| null	Идентификатор кошелька из каталога, когда результат получен с помощью кошелька.
`id_lookup`	object \| null	Подтверждающие данные из реестра: источник, время проверки, попытки, сопоставление каждого поля, портрет из реестра.
`wallet_verification`	object \| null	Подтверждающие данные удостоверения: провайдер, орган выдачи, уровень надёжности, валидность подписи, общие атрибуты.
`fallback_from`	object \| null	`{ "method": ..., "reason": ..., "action": ... }`, если метод без использования документов завершился ошибкой: `action` принимает значение `fallback_to_document` для верификации по документу, которую продолжил пользователь, или `decline` для отклонённой Верификации личности. `null`, если резервный переход не выполнялся.

Типы полей и примеры для всех трёх методов в разбивке по полям приведены в модели данных верификации личности, и те же самые ключи передаются в webhook status.updated.

Связанные разделы

Проверка по базам данных без использования документов — поля по странам, форматы, согласие и хранение данных
Кошельки цифровых удостоверений (Digital ID) — атрибуты кошельков, уровни надёжности и логика обработки сбоев
Методы Верификации личности в консоли — вкладка «Страны» и индикатор метода в сессии
Конфигурации функций сценария — справочник по ключу methods

Аутентификация