Smart-ID API: руководство для разработчиков по RP API v3

Последняя проверка: 5 октября 2026 · Не является юридической консультацией

Это руководство по Smart-ID API с упором на код: эндпоинты, сессии, проверка ответов, тестирование в демо-среде и правовой статус. О договорах и правилах AML по странам читайте в нашем руководстве по интеграции Smart-ID.

Smart-ID в двух словах

Smart-ID, мобильное приложение компании SK ID Solutions AS. Через Relying Party API от SK сервис использует его для входа пользователя или сбора подписи.^[13] Часть каждого ключа хранится на сервере SK. Департамент государственной инфосистемы Эстонии (RIA) называет это «серверной службой управления ключами Smart-ID».^[4]

Распространённость: пользователи и транзакции

Литва, крупнейший рынок Smart-ID: 1,857,471 пользователь. Далее идут Латвия с 1,198,463 и Эстония с 797,395, по данным счётчика на smart-id.com на 5 октября 2026.^[1] SK сообщает о «почти 100 миллионах транзакций каждый месяц».^[2]

В Эстонии на Smart-ID приходится «почти 60 процентов рынка» аутентификаций, по данным ERR News. Счётчик показывает только общие цифры; ни один первичный источник не приводит долю Smart-ID среди взрослого населения каждой страны (5 октября 2026).

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

RP API v3 связывается с приложением тремя способами: динамический QR-код при работе с разных устройств, ссылка Web2App или App2App на том же телефоне либо push-уведомление.^[12] SK продвигает сценарий с QR-кодом и переходом из приложения в приложение под названием Smart-ID+, который «больше не требует ввода личного кода на сайте».^[8]

Как работает Smart-ID API v3

API построен на REST поверх HTTPS с JSON в кодировке UTF-8.^[19] Четыре группы эндпоинтов POST открывают сессию и возвращают sessionID. Один GET возвращает результат.^[13]

Группы эндпоинтов RP API v3 по обзору SK.^[13]

Упрощенная схема входа с другого устройства по ссылке на устройство.^[12][18]

Подводные камни:

• Каждый начальный запрос v3 содержит случайный rpChallenge, который генерируете вы. Он заменил nonce из v2 для защиты от атак повторного воспроизведения.^[20]
• sessionSecret никогда не должен попадать на ваш фронтенд. Один сценарий использует один запрос сессии, даже если вы показываете QR-код и ссылку одновременно.^[18]
• В сценариях с уведомлением вы вычисляете четырехзначный код из SHA-256 от rpChallenge.^[17]
• SK аутентифицирует вас по IP-адресу источника и relyingPartyUUID и требует закрепления ключей HTTPS (key pinning).^[19]
• Согласно документации SK, для пользователя без учетной записи возвращается HTTP 404. SK просит показывать одно и то же сообщение при всех ошибках, чтобы исключить перебор пользователей.^[19]

Что бизнес получает от API Smart-ID

Завершенная сессия возвращает state, result.endResult, сертификат пользователя в cert и объект signature. Поле serialNumber субъекта содержит личный код, например PNOEE-30001010004, где префикс указывает страну.^[15]

Для проверки ответа SK требует:^[15]

• Проверить, что state равно COMPLETE, endResult равно OK, а протокол ACSP_V2 (вход) или RAW_DIGEST_SIGNATURE.
• Проверять цепочку сертификатов только по CA SK, с OCSP или CRL.
• Требовать наличия каждого идентификатора политики Smart-ID, чтобы другие сертификаты SK не проходили проверку.
• Сравнить certificateLevel с требуемым вами уровнем.
• Восстановить подписанные данные и проверить подпись.
• Проверять значения callback URL в сценариях на одном устройстве.

Уровень доверия и правовой статус

Smart-ID не входит в список нотифицированных схем eID ЕС; нотифицированная схема Эстонии (уровень «высокий», 7 ноября 2018) охватывает ID-карту и Mobile-ID.^[6]

Оговорка: e-резиденты «неотличимы от резидентов».^[5]

Надлежащая проверка клиента по ПОД/ФТ в Эстонии

Закон Эстонии о предотвращении отмывания денег и финансирования терроризма (RahaPTS) устанавливает дистанционные способы в § 31(3).^[23]

§ 31(3)RahaPTS (Эстония)

"1) e-identimise süsteemi, millest on teatatud ... (EL) nr 910/2014 ... artikli 9 kohaselt ja mis vastab ... artikli 8 lõike 2 punktis b või c sätestatud usaldusväärsuse tasemele" или "2) kvalifitseeritud usaldusteenust"

Источник: Riigi Teataja, RahaPTS^[23]

Иными словами: нотифицированная схема eID с уровнем доверия «существенный» или «высокий» либо квалифицированная услуга доверия. Способ 1 не подходит. Официальной позиции о том, подпадают ли квалифицированные сертификаты Smart-ID под способ 2, по состоянию на 5 октября 2026 года нет, поэтому обратитесь в Finantsinspektsioon или к юристу. Закон Литвы о ПОД/ФТ (статья 11) и Постановление Кабинета министров Латвии № 392 (п. 7.1) называют квалифицированную или защищённую электронную подпись среди нескольких дистанционных способов.^[28][29]

С 2027 года: статья 22(6) AMLR

Регламент о противодействии отмыванию денег (AMLR) применяется с 10 июля 2027 года. Статья 22(6)(b) допускает «средства электронной идентификации, отвечающие требованиям Регламента (ЕС) № 910/2014 в отношении уровней доверия „существенный“ или „высокий“, и соответствующие квалифицированные услуги доверия».^[30] Окончательные проекты стандартов Органа по противодействию отмыванию денег (AMLA) от 30 сентября 2026 года, ещё не ставшие правом, допускают eID уровня «существенный» или «высокий» «независимо от того, уведомлены ли они в соответствии со статьёй 9».^[31] Сроки eIDAS 2 описаны на нашей странице о кошельке EUDI Wallet.

Как бизнес подключается: прямой договор RP или брокер

Процесс SK: бесплатное тестирование без договора, выбор мер безопасности, отправка ваших IP-адресов и названия сервиса, подписание, получение RP UUID, запуск «в течение нескольких дней после первого обращения».^[21] Сертифицированные брокеры также перепродают Smart-ID, а эстонские государственные органы могут использовать шлюз TARA от RIA.^[5]

Три способа подключиться к Smart-ID.^[21][5]

Прайс-лист SK (с 1 июня 2026 года) тарифицирует каждый «запрос аутентификации или подписания Smart-ID»: €0.109 при ежемесячном минимуме €60, до €0.0106 на тарифе на 3 миллиона, а свыше 5 миллионов заключается индивидуальное соглашение.^[11] SK заявляет, что Smart-ID+ «не требует дополнительной оплаты» для действующих RP.^[7]

Тестирование в демо-среде

Демо: https://sid.demo.sk.ee/smart-id-rp/v3/, relyingPartyUUID 00000000-0000-4000-8000-000000000000, имя DEMO. Боевая среда: https://rp-api.smart-id.com/v3/.^[14] Тестовые аккаунты по результату:^[16]

Сценарии использования и отраслевые правила

• KYC и AML-онбординг. Подписанные имя и личный код; пригодность для AML зависит от страны.^[23][28][29]
• Азартные игры и возраст. Закон Эстонии об азартных играх запрещает лицам младше 21 года участвовать в азартных играх (§ 34(2)) и обязывает удалённых операторов проверять каждого игрока и регистрировать его личный код (§ 53(1)).^[24] В API мы не нашли заявлений о проверке только возраста.
• Подписание. Квалифицированные учётные записи подписывают через v3/signature; «4 из 10 литовцев использовали квалифицированную электронную подпись в 2025 году».^[13][33]
• Телеком. Ни одна норма стран Балтии не называет Smart-ID для регистрации SIM-карт (5 октября 2026).

Ограничения и запасные варианты

«В Эстонии и Латвии Smart-ID в настоящее время доступен только лицам с эстонским или латвийским национальным идентификационным номером»; в Литве нерезиденты могут получить Smart-ID Basic в двух банках.^[22] У Smart-ID нет возрастного ограничения, но у способов регистрации оно есть (латвийская ID-карта с 14 лет), а для учётных записей лиц младше 18 лет нужно разрешение родителя.^[32]

По состоянию на 5 октября 2026 мы не нашли задокументированных сбоев; риск представляет фишинг. По данным ERR News, в 2025 году мошенники, выманивающие PIN-коды, похитили с эстонских банковских счетов почти €23 млн. С 29 апреля 2026 при регистрации в Эстонии ID-карта считывается по NFC, а не через кард-ридер.^[34]

Сначала eID, документ как запасной вариант; фиксируйте, почему понадобился каждый запасной вариант.^[31]

Чек-лист внедрения Smart-ID API

Сначала разрабатывайте на бесплатной демо-среде SK, чтобы договор подождал, пока ваш код не заработает.^[21] Проверка ответа составляет основу работы.^[15]

• Разрабатывайте на демо-URL и опубликованных тестовых учётных записях.^[14][16]
• Отдавайте предпочтение сценариям device link; уведомления разрешайте только на известных устройствах.^[13]
• Генерируйте новый случайный rpChallenge для каждого входа.^[20]
• Закрепите (pin) HTTPS-ключ SK и храните sessionSecret на сервере.^[19][18]
• Выполняйте все шаги проверки ответа, описанные SK.^[15]
• Отправьте SK свои IP-адреса и название сервиса, затем подпишите договор.^[21]
• Зафиксируйте правовое основание для использования в целях AML в каждой стране.^[23]
• Добавьте маршрут с проверкой документа для пользователей без Smart-ID.

Как Didit помогает со Smart-ID

Smart-ID доступен в Didit для проверки eID в Эстонии, Латвии, Литве и Бельгии. Подключение к SK держит Didit, поэтому вам не нужны договор RP, список разрешенных IP-адресов и код для работы с сертификатами.

В консоли откройте Workflows, шаг ID Verification, Countries, выберите страну и отметьте Smart-ID в разделе "Wallets accepted". Через API задайте methods.EST.wallet, создайте сессию и получите результат через GET /v3/session/{id}/decision/ или вебхук: verification_method имеет значение "wallet" и содержит объект wallet_verification, как описано в документации по кошелькам цифровой идентичности.^[35] Пользователь подтверждает код сверки в приложении Smart-ID. Didit никогда не запрашивает PIN-код.

Вы получаете полное имя, дату рождения, балтийский личный код, уровень доверия (с меткой High) и проверку подписи; адреса и портрета нет. Пользователи без Smart-ID переходят на проверку документов со считыванием NFC-чипа ($0.15), проверкой liveness и сравнением лиц; полный KYC стоит $0.33, а AML-скрининг $0.20. Оплачиваются только завершённые входы через eID; завершённая верификация через Smart-ID стоит $0.20 (страница тарифов), все eID перечислены на странице цифровых ID-кошельков.

Часто задаваемые вопросы

Источники

1. Главная страница Smart-ID, счётчик пользователей в реальном времени, SK ID Solutions, дата обращения 5 октября 2026.
2. 2025: развитие цифрового доверия за пределами границ, SK ID Solutions, 19 января 2026.
3. Доверие и конкуренция в сфере цифровой идентификации в Европе, e-Estonia, 2026.
4. Электронная идентификация (eID), Департамент государственной инфосистемы (RIA).
5. Техническая спецификация TARA, RIA.
6. Обзор предварительно нотифицированных и нотифицированных схем eID в рамках eIDAS, Европейская комиссия, дата обращения 5 октября 2026.
7. Smart-ID+, SK ID Solutions.
8. Как новый Smart-ID защищает меня от мошенничества, FAQ Smart-ID.
9. Правительство Эстонии внедряет Smart-ID+ для повышения безопасности, SK ID Solutions, 28 января 2026.
10. Почему иногда отображается один код подтверждения, а иногда три, FAQ Smart-ID.
11. Прейскурант, SK ID Solutions, действует с 1 июня 2026 г.
12. Relying Party API: введение, SK ID Solutions, версия 3.2.3.
13. Relying Party API: обзор конечных точек API, SK ID Solutions.
14. Технические параметры сред, SK ID Solutions.
15. Relying Party API: проверка ответа, SK ID Solutions.
16. Тестовые учётные записи для автоматизированного тестирования, SK ID Solutions.
17. Relying Party API: сценарии на основе уведомлений, SK ID Solutions.
18. Relying Party API: сценарии со ссылкой на устройство, SK ID Solutions.
19. Relying Party API: техническое описание API, SK ID Solutions.
20. Relying Party API: журнал изменений, SK ID Solutions.
21. Процесс интеграции для поставщиков электронных услуг, Smart-ID.
22. Могут ли иностранцы и нерезиденты пользоваться Smart-ID, FAQ Smart-ID.
23. Rahapesu ja terrorismi rahastamise tõkestamise seadus (RahaPTS), § 31, Riigi Teataja.
24. Hasartmänguseadus (Закон об азартных играх), Riigi Teataja.
25. Elektroniskā identifikācija, Министерство обороны Латвии.
26. Smart-ID получил местный квалифицированный статус для аутентификации в Латвии, SK ID Solutions, 29 мая 2023 г.
27. Smart-ID и Mobile-ID признаны в Литве средствами, одобренными государством, SK ID Solutions, 19 декабря 2024 г.
28. Закон о предотвращении отмывания денег и финансирования терроризма, статья 11, Литва, консолидированный текст INFOLEX.
29. Постановление Кабинета министров № 392, Латвия, likumi.lv.
30. Регламент (ЕС) 2024/1624 (AMLR), EUR-Lex, Официальный журнал от 19 июня 2024 г.
31. Итоговый отчёт, проект RTS в соответствии со статьёй 28(1) AMLR, AMLA, 30 сентября 2026 г.
32. Возрастные ограничения для использования Smart-ID, FAQ Smart-ID.
33. SK ID Solutions выпустила почти три миллиона сертификатов в Литве в 2025 году, SK ID Solutions, 7 мая 2026 г.
34. Регистрация в Smart-ID с эстонской ID-картой теперь доступна через NFC, Smart-ID, 29 апреля 2026 г.
35. Кошельки цифровой идентичности, документация Didit.
36. Relying Party API: взаимодействия, SK ID Solutions.

Smart-ID входит в число пяти eID, которые уже доступны в проверке eID от Didit. См. также что такое проверка eID и руководство по API BankID Sweden.