Перейти к основному содержанию
Вход через кошелёк является одним из трёх методов верификации личности. Пользователь входит с помощью уже имеющегося у него цифрового удостоверения личности — национального eID или банковского удостоверения — и этот провайдер передаёт Didit подписанный набор атрибутов. Результат имеет уровень гарантии cryptographic: провайдер удостоверений аутентифицировал человека и подписал возвращённые атрибуты. Это всё, о чём говорит данный уровень. Это не рейтинг по сравнению с двумя другими уровнями — они описывают разные типы подтверждений, а не большее или меньшее количество одного и того же — а продолжительность входа зависит от собственного процесса кошелька, который Didit не контролирует и не гарантирует.
Доступность зависит от вашей среды. В приведённых ниже таблицах описана доступность в продакшене, а консоль использует актуальный каталог возможностей своей среды при сохранении сценария. MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID и Mobile-ID доступны. Estonian ID-card, eParaksts mobile, Personalausweis, OneID и ConnectID имеют статус Скоро в продакшене. Smart-ID поддерживает Эстонию, Латвию, Литву и Бельгию; Mobile-ID поддерживает Эстонию и Литву; Finnish Trust Network поддерживает Финляндию. Охват стран, конфигурацию и процесс верификации см. в руководстве по интеграции Smart-ID и Mobile-ID. Кошелёк со статусом Скоро нельзя включить в этой среде.

Выберите способ интеграции

Используйте API цифровых ID-кошельков, когда ваше приложение самостоятельно управляет интерфейсом и шагами аутентификации. У каждого кошелька есть отдельный endpoint запуска, а для получения результата, поллинга и отмены используются общие endpoint’ы. Вам не нужно создавать сценарий. Используйте Sessions API для размещённого Didit пользовательского пути с кошельком, правил сценария и настроенного запасного варианта с проверкой документов. Доступность кошелька, обязательное согласие пользователя и верифицированные атрибуты личности применяются к обоим методам интеграции.

Предварительные требования

Для каждого кошелька требуется активная цифровая идентичность у указанного ниже эмитента и доступ к его методу аутентификации. Аккаунт должен соответствовать требованиям для предоставления запрашиваемых атрибутов, и пользователь должен дать согласие на их передачу. Подпись подтверждает эмитента и возвращённые клеймы; она не гарантирует, что каждый запрошенный атрибут присутствует, актуален или достаточен для вашей политики комплаенса. Кошелёк без портретного фото не включает сравнение с селфи. Ниже перечислены все 25 записей о кошельках из каталога, включая обе страны BankID, ConnectID, Estonian ID-card и eParaksts mobile. Настроенный запасной вариант с проверкой документов выполняет отдельную проверку документов. Дата запуска не гарантируется. Это кошельки цифровой идентификации. Скрининг криптокошельков проверяет блокчейн-адреса на финансовые риски и является отдельным продуктом.

Цены

✅ Доступно означает, что кошелёк включён в продакшене. ⏳ Скоро появится означает, что кошелёк ещё не включён в продакшене, даже если интеграционное тестирование уже началось. Сначала отображаются доступные кошельки. По запросу в столбце цен означает, что кошелёк доступен, но для него нет опубликованного розничного тарифа; это не означает бесплатную верификацию. Это стандартные цены Didit в USD за завершённую верификацию через кошелёк для перечисленных ниже продуктов идентификации. Указанная цена включает проверку личности через кошелёк; отдельная комиссия за транзакцию с использованием национальной eID к ней не добавляется. Согласованный индивидуальный тариф организации имеет приоритет. Скоро в столбце цен означает, что кошелёк запланирован, а цена для клиентов ещё не опубликована. Это не означает, что верификация бесплатна. Флаги стран показывают покрытие кошелька по каталогу; отдельный столбец доступности показывает, можно ли его включить в данный момент. Опубликованная цена не активирует кошелёк. Доступность выше указана на основе продакшн-каталога. Кошелёк с отметкой Скоро пока нельзя выбрать в сценарии; эти тарифы начнут действовать, когда он станет доступен.
  • За подтверждённый вход через кошелёк плата взимается один раз за узел «Верификация личности» в сценарии или один раз за запрос на верификацию через отдельный API кошельков. Повторные обратные вызовы или проверки статуса не приводят к дополнительным списаниям.
  • Отменённые, истекшие, отклонённые или незавершённые входы не тарифицируются как верификация через кошелёк.
  • Цены на кошельки являются базовыми: скидка вашего тарифа применяется к ним так же, как и к любой другой проверке.
  • Запасной вариант с проверкой документа считается отдельной проверкой, тарифицируемой в соответствии с ценами на верификацию документов. Другие завершённые функции сценария оплачиваются отдельно.
Например, 1,000 завершённых верификаций с полной идентификацией iDIN по стандартному тарифу стоят $950 без учёта других функций сценария. Это полная идентификация, а не цена повторного входа. Указанный выше тариф BankID относится к уровню Norway High, а тариф немецкого eID относится к Personalausweis Profile 2.

Что делает пользователь

  1. Выбирает свою страну на шаге удостоверения личности и выбирает кошелёк из списка разрешённых вами.
  2. Выполняет вход с помощью этого кошелька так же, как входит в свой банк или на государственный портал.
  3. Дает согласие на передачу своих атрибутов личности вам.
  4. Возвращается после успешной верификации.
Вход на одном устройстве перенаправляет пользователя в приложение кошелька и возвращает его в процесс верификации по завершении. Вход с разных устройств отображает QR-код на экране десктопа, который пользователь сканирует телефоном с установленным кошельком. Предлагаются оба варианта, если кошелёк их поддерживает; выбор остаётся за пользователем. Когда для вашего сценария включены Smart-ID или Mobile-ID, пользователь вводит свой персональный идентификационный код на странице верификации. Mobile-ID также запрашивает номер телефона, привязанный к личности. На странице отображается сравнительный код, и пользователь подтверждает операцию на телефоне только в том случае, если этот код совпадает. Пользователь вводит свой PIN-код на телефоне; Didit никогда его не запрашивает. Этот процесс работает как на десктопе, так и на телефоне без использования QR-кода. Доступность определяется каталогом возможностей продакшн-среды; кошелёк с отметкой Скоро пока нельзя включить. Начатый вход остаётся действительным в течение ограниченного времени (по умолчанию 10 минут). По истечении этого времени пользователю придётся начать заново.

Кошельки задаются списком разрешений

wallet.providers представляет собой список кошельков, которые может предложить страна. Это не ранжирование: порядок, в котором вы их передаёте, не имеет значения: при сохранении он нормализуется до порядка каталога, а конечный пользователь выбирает из разрешённых вами вариантов. Включите один кошелёк или все кошельки в стране — выбор остаётся за ними. API отклоняет сценарий, если в нём включён кошелёк, который каталог не предлагает для этой страны, или кошелёк со статусом Скоро.
Список атрибутов каждого кошелька ниже включает подписанное утверждение. Didit проверяет эту подпись и передаёт результат проверки в поле wallet_verification.signature_valid сессии; само утверждение не возвращается, поэтому нет ссылки, которую можно было бы получить или сохранить. Столбец В сессии указывает, какой из двух вариантов вы получаете для каждого атрибута.

Поддерживаемые кошельки

Доступные кошельки: MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID и Mobile-ID. iDIN доступен для полной идентификации в Нидерландах. Smart-ID и Mobile-ID доступны в странах, перечисленных в каталоге ниже. Покрытие стран и запрашиваемые входные данные для Smart-ID и Mobile-ID отражают реализованную интеграцию; доступность в продакшене регулируется отдельно. Используйте руководство по интеграции для реализованных маршрутов Smart-ID и Mobile-ID.
Доступность определяется каталогом возможностей, а не ведётся вручную на этой странице. Статус Скоро означает, что кошелёк виден в консоли, но пока не может быть включён; для него нет зафиксированной даты запуска.

Estonian ID-card и eParaksts mobile

Оба метода интегрированы в каталог кошельков, но в продакшене остаются со статусом Скоро. Их нельзя включить в продакшн-сценариях до тех пор, пока в продакшн-каталоге они не будут отмечены как Доступные. Идентификаторы API: idcard_ee для Эстонии (EST) и eparaksts_mobile для Латвии (LVA). Для обоих методов установлена цена $0.55 за завершённую верификацию при наличии доступа; опубликованный тариф сам по себе не открывает доступ в продакшене.
  • Estonian ID-card: пользователь продолжает процесс в браузере на компьютере, подключённом к считывателю смарт-карт, и проходит аутентификацию с помощью карты и PIN-кода через программное обеспечение карты.
  • eParaksts mobile: пользователь переходит в сервис аутентификации и подтверждает действие через свой активный аккаунт eParaksts mobile. Пользователи на компьютерах могут отсканировать QR-код, чтобы продолжить на телефоне; пользователи на смартфонах продолжают напрямую.
Оба метода используют общий для Didit процесс выбора кошелька, передачи управления и возврата. Пользователь вводит свой PIN-код для аутентификации исключительно в сервисе идентификации или в ПО карты, но никогда не в формы Didit. После аутентификации Didit проверяет подписанные атрибуты личности и продолжает выполнение настроенного сценария. При отмене или ошибке применяется настроенный в сценарии резервный вариант с документом либо действие при отклонении.
White label применяется к экранам верификации Didit. Внешние экраны аутентификации для этих двух методов сохраняют фирменный стиль своих сервисов. Пользовательские логотипы, названия сервиса и стили White label не переносятся на эти внешние экраны.

Использование этих кошельков через API

Оба метода также поддерживают автономную верификацию через API без workflow_id. Доступность в продакшене одинакова как для автономного API, так и для сценариев; проверяйте GET /v3/id-verification/wallets/ перед тем, как предлагать любой из этих методов пользователям. Храните ваш x-api-key на бэкенде и зарегистрируйте хост возврата вашего приложения в настройке allowed_return_hosts. При запуске верификации передавайте HTTPS return_url на этом хосте. В ответе на запуск возвращаются request_id и wallet_verification.next_action.url для браузера пользователя. Перенаправьте пользователя по этому URL, чтобы он мог пройти аутентификацию с помощью карты или приложения. После возвращения пользователя вызовите GET /v3/id-verification/wallets/verifications/{request_id}/ со своего бэкенда, чтобы проверить подтверждённый результат, или обработайте подписанный webhook status.updated. Не считайте простой редирект в браузере подтверждением успешной верификации. Одинаковые правила биллинга и цена за завершённую верификацию применяются к обоим вариантам интеграции.

Google Wallet

Google Wallet позволяет человеку передать государственное удостоверение личности со своего телефона на вашу страницу или в приложение с помощью W3C Digital Credentials API. Он доступен в продакшене и в песочнице. Для приложений в песочнице регистрация не требуется. Каждое продакшн-приложение регистрируется один раз перед тем, как сможет использовать Google Wallet: в консоли откройте шаг верификации личности, найдите строку Google Wallet для поддерживаемой страны, выберите Зарегистрироваться в Google и завершите разовую настройку, которая занимает около минуты. После этого Google будет показывать ваше название и логотип, когда люди передают своё удостоверение личности. Пока приложение не зарегистрировано, сохранение сценария с включённым Google Wallet будет отклонено с сообщением “Register this application with Google before enabling Google Wallet.” Конечные пользователи ваших клиентов видят эту опцию как Verify with digital ID, поскольку помимо Google Wallet ответить на запрос может любой другой кошелёк Android, поддерживающий тот же запрос OpenID4VP и содержащий совместимое удостоверение личности (цифровой ID-пропуск или мобильное водительское удостоверение).
  • Страны: США, Великобритания, Бразилия, Сингапур и Тайвань.
  • Удостоверения: цифровой ID-пропуск Google Wallet, созданный на основе паспорта, а также мобильные водительские удостоверения из поддерживаемых штатов США.
  • Возвращаемые данные: имя, дата рождения, номер документа, срок действия документа, страна и орган выдачи, а также гражданство для ID-пропуска. В результате также содержится вердикт signature_valid для учётных данных. Фотография лица (портрет) не передаётся.
  • Конфиденциальность: Didit запрашивает только те поля, которые необходимы, и только эти поля покидают кошелёк. Пользователь подтверждает передачу данных в Google Wallet на собственном устройстве.
Редирект отсутствует: человек подтверждает действие в окне кошелька самого браузера или Android, а десктопные браузеры отображают свой собственный QR-код, если кошелёк находится на телефоне. Запрос на верификацию отправляется с вашей страницы или из приложения, поэтому для интеграции через API требуется HTTPS-источник вашей страницы. Размещённый сценарий из Sessions API предлагает этот метод только в браузерах и на устройствах, которые его поддерживают, а в остальных случаях сохраняет резервный вариант с документом. Когда вы отображаете размещённый сценарий внутри собственной страницы, используйте Web SDK версии 0.5.1 или новее либо добавьте digital-credentials-get в атрибут allow вашего iframe: без этого браузер отклонит запрос кошелька внутри iframe.

Другие планируемые кошельки

ConnectID (Австралия) интегрирован для тестирования в песочнице и отображается в каталоге кошельков как connectid. Пользователь выбирает участвующий тестовый банк через селектор ConnectID, входит в систему этого банка и просматривает запрос на передачу данных. Начальный набор идентификационных данных запрашивает имя, фамилию и дату рождения, а также идентификатор транзакции для верификации. Он не запрашивает адрес, номер телефона, адрес электронной почты, баланс счёта или историю транзакций. В уведомлении о передаче данных указываются Didit и компания, получающая подтверждённую личность. Учётные данные для доступа к банку остаются у банка. Доступ к продакшн-среде остаётся со статусом Скоро; тестирование в песочнице не позволяет выполнять верификацию личности в продакшне. До активации необходимо утвердить сценарий использования в продакшне, завершить онбординг клиента, принять обязательные условия и пройти сертификацию. Другие кошельки, отмеченные в таблицах как Скоро, также остаются недоступными в продакшне. Дата запуска не обещана.

Уровень доверия

Если кошелёк предоставляет уровень доверия eIDAS (low, substantial или high), Didit фиксирует фактически заявленный уровень в результате. Кошелёк без указанного уровня eIDAS, например ConnectID, отображается как Не указано; его интеграция не подразумевает заявления об уровне доверия eIDAS. Если кошелёк возвращает более слабый уровень, чем запрошенный, попытка входа завершается ошибкой вместо незаметного понижения уровня. Проверяйте wallet_verification.level_of_assurance в объекте сессии, если от этого зависят ваши комплаенс-правила.

Справочник по кошелькам

MitID

mitid · Доступно Информация, вводимая в Didit: Имя · Дата рождения · CPR-псевдоним (псевдонимизированный)

BankID

bankid_se · Доступно Информация, вводимая в Didit: Имя · Персональный номер

iDIN

idin · Доступно Информация, вводимая в Didit: Имя · Дата рождения · Адрес

Finnish Trust Network

ftn · Доступно Информация, вводимая в Didit: Имя · Личный идентификационный код

Google Wallet

google_wallet · Доступно Информация, вводимая в Didit: Данные личности в Didit не вводятся

Smart-ID

smart_id · Доступно Информация, вводимая в Didit: Личный идентификационный код

Mobile-ID

mobile_id · Доступно Информация, вводимая в Didit: Личный идентификационный код · Номер телефона Mobile-ID

BankID

bankid_no · Скоро появится Информация, вводимая в Didit: Имя · Дата рождения · Национальный идентификационный номер

Vipps

vipps · Скоро появится Информация, введённая в Didit: Имя · Дата рождения · Национальный идентификационный номер

Buypass ID

buypass · Скоро появится Информация, введённая в Didit: Имя · Дата рождения · Национальный идентификационный номер

itsme

itsme · Скоро появится Информация, введённая в Didit: Имя · Дата рождения · Номер в национальном регистре

Personalausweis

personalausweis · Скоро появится Информация, введённая в Didit: Имя · Дата рождения · Гражданство · Адрес

Freja eID

frejaid · Скоро появится Информация, введённая в Didit: Имя · Дата рождения · Личный номер

UAE PASS

uae_pass · Скоро появится Сведения, вносимые в Didit: Имя · Номер Emirates ID · Гражданство · Портрет

gov.br

govbr · Скоро Сведения, вносимые в Didit: Имя · CPF

OneID

oneid · Скоро Сведения, вносимые в Didit: Имя · Дата рождения

GOV.UK Wallet

govuk_wallet · Скоро Сведения, вносимые в Didit: Имя · Дата рождения · Портрет

Эстонская ID-карта

idcard_ee · Скоро Сведения, вносимые в Didit: Имя · Дата рождения · Личный идентификационный код

eParaksts mobile

eparaksts_mobile · Скоро Данные, вводимые в Didit: Имя · Дата рождения · Персональный идентификационный код

Bank iD

bankid_cz · Скоро появится Данные, вводимые в Didit: Имя · Дата рождения

MojeID

mojeid · Скоро появится Данные, вводимые в Didit: Имя · Дата рождения

Diia

diia · Скоро появится Данные, вводимые в Didit: Имя · Дата рождения · Фотография лица

FranceConnect

franceconnect · Скоро появится Данные, вводимые в Didit: Имя · Дата рождения

Auðkenni

audkenni · Скоро появится Информация, вводимая в Didit: Имя · Kennitala

ConnectID

connectid · Скоро появится Информация, вводимая в Didit: Данные личности не вводятся в Didit

EUDI Wallet

eudi · Скоро появится Информация, вводимая в Didit: PID - данные идентификации личности

Сбои и резервные сценарии

Любой результат, отличный от verified, обрабатывается согласно переключателю wallet.on_failure для страны: fallback_to_document перенаправляет пользователя на съемку документа, decline завершает сессию со статусом отклоненной Верификации личности. fallback_to_document при отключенной съемке документов для этой страны приводит к отклонению, так как резервный вариант недоступен. Информацию о том, как показывать съемку документов только после неудачного входа через кошелек, см. в разделе Предложение съемки документов только в качестве резервного варианта. Тарифицируется только успешно завершенный вход. Прерванные, отмененные, завершенные по таймауту и неудачные попытки входа бесплатны.

Данные, попадающие в сессию

Поле attributes содержит проверенные утверждения кошелька, названия которых зависят от конкретного кошелька. Используйте full_name и date_of_birth в результате верификации личности для получения нормализованных полей данных личности. Таблица для каждого кошелька разграничивает нормализованные поля и атрибуты, специфичные для кошелька. Поле portrait присутствует только для тех кошельков, которые передают фотографию. Поле signature_valid представляет собой результат проверки подписанного утверждения, возвращённого кошельком. Оно равно true при успешном входе: утверждение, не прошедшее проверку, приводит к ошибке входа; в этом случае применяется правило wallet.on_failure, а одобренный результат не формируется. Полное описание типов полей см. в модели данных Верификации личности.

Настройка кошельков

Этот фрагмент конфигурации следует использовать только если в каталоге вашей среды каждый выбранный кошелек отмечен как available в выбранной стране. Передача кошелька, который недоступен, приводит к отклонению сохранения всего сценария, включая любые другие методы в том же запросе. Примеры для Smart-ID и Mobile-ID см. в руководстве по интеграции.
Включите хотя бы один кошелек, если wallet.enabled имеет значение true, иначе сохранение будет отклонено. Полный справочник доступен в разделе Конфигурация функций сценария.

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

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