BankID API в Швеции: доверяющая сторона напрямую или брокер, полное руководство
Как компания подключается к BankID API в Швеции: напрямую через банк или через брокера, какие данные возвращает вход, его правовой статус для ПОД/ФТ и азартных игр, ограничения и резервная проверка по документу.

Коротко
API BankID позволяет компании идентифицировать пользователя из Швеции или получить его подпись через приложение BankID. В 2025 году BankID пользовались 8.7 млн человек.[1] Доступ к API можно получить одним из двух способов: купить услугу у банка и подключиться напрямую как доверяющая сторона или работать через реселлера, который уже выполнил интеграцию.[4]
- При входе возвращаются 12-значный personnummer и имя с подписью. Адреса и фотографии нет.[6]
- BankID входит в шведскую схему eID (нотифицирована на уровнях Substantial и High). DIGG указывает для BankID уровень Substantial. Цены не публикуются.[4][10][11]
BankID это электронная идентификация (eID) Швеции: частное приложение, которое банки выпускают по общим правилам[3] и которое одобрено государственным цифровым агентством DIGG.[11] Для бизнеса это стандартный способ установить личность клиента из Швеции. Вместо фото документа компания получает подписанный ответ.
Кратко о BankID Sweden
BankID Sweden
Электронная идентификация Швеции, выпускаемая банками
Сколько людей пользуются BankID
Источник: BankID в цифрах, данные за 2025 год.[1]
Использование выросло с 4.1 млрд транзакций в 2019 году до 7.9 млрд в 2025 году.[1]
| Сектор | Доля использования BankID, 2025 |
|---|---|
| Банки и финансы | 50% |
| Прочие частные сервисы | 27% |
| Мобильные платежи | 17% |
| Государственный сектор | 6% |
BankID в цифрах.[1]
- Сентябрь 2002ОснованиеСоздана компания Finansiell ID-Teknik BID.
- Июнь 2011Мобильное приложениеЗапуск Mobile BankID.
- 14 декабря 2020НотификацияШведская схема eID, включая BankID, нотифицирована в рамках eIDAS.
- 17 августа 2026Проверка лицаСтановится доступна дополнительная проверка с распознаванием лица.
- 1 декабря 2026SverigeIDГосударственный e-ID запускается наряду с BankID.
От основания компании до государственного e-ID.[2][10][7][17]
Что видит пользователь
На телефоне приложение BankID открывается на том же устройстве. На компьютере пользователь сканирует QR-код с помощью приложения.[6] Согласно исследованию процесса BankID, затем пользователь подтверждает действие кодом безопасности или биометрией. Справочная документация BankID по методу collect подтверждает использование кода через свои коды ошибок.[6]
Выберите способ проверки
Войдите с помощью электронного удостоверения, которым вы уже пользуетесь.
BankID
Использовать документ, удостоверяющий личность
1Пользователь выбирает BankID при регистрации в вашем сервисе.
На компьютере: отсканируйте в BankID
Откройте приложение BankID на телефоне и отсканируйте этот код.
2Только на компьютере: QR-код передает запрос на телефон. На телефоне этот экран пропускается.[6]
Подтвердите личность
Проверьте, кто запрашивает данные, затем введите код безопасности.
3Пользователь подтверждает действие в приложении (кодом безопасности или биометрией, согласно исследованию процесса BankID).[6]
Дополнительная проверка
Приложите паспорт или ID-карту либо сделайте селфи.
4Необязательная дополнительная проверка, которую может запросить сервис.[7]
Вы прошли верификацию
- ИмяПередаётся
- PersonnummerПередаётся
- АдресНе передаётся
- ПортретНе передаётся
5Возврат в ваш сервис с подписанным результатом.[6]
Экран 4 необязателен: считывание паспорта или ID-карты по NFC или, с 17 августа 2026 года, распознавание лица по фотографии из чипа шведского паспорта или ID-карты.[6][7] В водительских удостоверениях нет чипа, поэтому их нельзя использовать для этой дополнительной проверки.[7]
Видео в подготовке: flow-qr-cross-device
Вход с другого устройства по QR-коду от начала до конца.
Что API BankID возвращает бизнесу
Ваш бэкенд запускает запрос через /auth (идентификация) или /sign, а затем каждые две секунды вызывает /collect, пока запрос в ожидании.[6] Когда пользователь подтверждает, ответ содержит completionData.
Пользователь подтверждает в приложении BankID
Прямая интеграция с BankID в упрощённом виде. Коды подсказки показывают, что отображать пользователю.[6]
| Поле | Когда | Что это |
|---|---|---|
| personalNumber | Всегда | Шведский национальный идентификационный номер, 12 цифр |
| name, givenName, surname | Всегда | Полное имя и его части |
| signature | Всегда | XML-подпись в кодировке Base 64 |
| ocspResponse | Всегда | Подписанный статус сертификата для подписи |
| device.ipAddress, device.uhi | Возвращается | IP-адрес, который видит BankID, уникальный идентификатор оборудования |
| bankIdIssueDate | Возвращается | Дата выдачи BankID |
| stepUp.mrtd, stepUp.face | Если выполнялась дополнительная проверка (step-up) | Выполнялась ли проверка чипа или лица |
| risk | Только по запросу | low, moderate или high |
| Адрес, гражданство, фотография | Никогда | Не входит в ответ |
Ответ collect для завершённого заказа.[6]
Дата рождения закодирована в personnummer, поэтому проверка возраста выполняется при каждом входе.[3]
Уровень гарантии и правовой статус
14 декабря 2020 года Швеция уведомила в рамках eIDAS одну зонтичную схему, "Swedish eID", указав в качестве её средств BankID, Freja eID и EFOS на уровнях гарантии Substantial и High.[10] В собственной таблице уведомлённых шведских e-ID DIGG относит Mobile BankID, BankID on file и BankID on card к уровню Substantial.[11] В шведской рамочной системе доверия он находится на уровне доверия 3.[3][11]
| Инструмент | Что это означает для BankID |
|---|---|
| Рамочная система доверия DIGG для шведских e-ID | BankID одобрен на уровне доверия 3 наряду с другими e-ID, которые DIGG относит к этому уровню[11] |
| eIDAS, Регламент (ЕС) № 910/2014 | Нотифицирована в рамках шведской схемы eID. BankID заявляет, что подпись BankID является усиленной электронной подписью[3][10] |
| PSD2 | Идентификация соответствует требованиям строгой аутентификации клиента, подпись соответствует требованию динамической привязки[3] |
| Lag (2017:630), гл. 3, § 7 | Средства eID по eIDAS можно использовать для проверки личности при проверках по противодействию отмыванию денег[13] |
| Spellagen (2018:1138), гл. 12, § 2 | Лицензиаты в сфере азартных игр обязаны проверять личность с помощью надежной электронной идентификации[14] |
| Уголовный кодекс, глава 15, § 12 | Использование чужого BankID считается злоупотреблением документами[3] |
| Lag (2026:1358) | Закон о государственной e-ID, применяется с 1 декабря 2026 года[12] |
В отношении надлежащей проверки клиента шведский закон о противодействии отмыванию денег гласит:
Глава 3, § 7Lag (2017:630) om åtgärder mot penningtvätt och finansiering av terrorism
"När första stycket tillämpas får man använda medel för elektronisk identifiering och betrodda tjänster enligt ... (EU) nr 910/2014"
Источник: Sveriges riksdag, SFS 2017:630[13]
По-русски: средства eID по eIDAS можно использовать для проверки личности. Надлежащая проверка в целом остается риск-ориентированной.
С 10 июля 2027 года применяется Регламент ЕС о противодействии отмыванию денег (AMLR). Его статья 22(6)(b) допускает средства eID с «уровнями доверия „существенный“ или „высокий“», поэтому BankID соответствует этому требованию.[15] Окончательные проекты стандартов органа ЕС по противодействию отмыванию денег (AMLA) были направлены в Комиссию 30 сентября 2026 года и пока не имеют силы закона. Согласно этому проекту, средства eID «следует использовать везде, где это возможно», а удаленная проверка документов служит резервным вариантом для клиентов, которые не могут их использовать. К таким средствам проект относит европейский кошелек цифровой идентичности (EUDI Wallet).[16]
Примечание
SverigeID, государственная e-ID, выдаваемая Полицейским управлением Швеции, начинает работу 1 декабря 2026 года. DIGG утвердило ее на шведском уровне доверия 4, самом высоком. По состоянию на 5 октября 2026 года она еще не включена в список нотифицированных схем ЕС. Она дополняет BankID и Freja eID, а не заменяет их.[11][17]
Как подключиться к API BankID Sweden: напрямую или через посредника
Ответ BankID: "You can purchase the BankID service from a bank or through a retailer." («Вы можете приобрести услугу BankID у банка или через реселлера».)[4]
Прямая доверяющая сторона
Покупка у банка, собственная разработка
- Заключите договор с банком, который продает BankID
- Закажите сертификат доверяющей стороны (FP) через BankID Keygen
- Реализуйте start, QR, collect, сообщения пользователю и обработку cancel
- Цена за идентификацию и подпись согласуется с банком
Подходит для сервисов в одной стране с собственной командой разработки
Через посредника или реселлера
Один договор, одна интеграция
- Договор с реселлером, который покупает услугу BankID
- Вы вызываете API реселлера, а не API BankID
- С BankID взаимодействует интеграция реселлера, а не ваша
- Цена за проверку, которую устанавливает реселлер
Лучше всего подходит для онбординга в нескольких странах
Оба варианта работают по одним и тем же правилам BankID.[4]
Цены не публикуются ни для одного из вариантов. Стоимость «обычно зависит от количества выполненных идентификаций и подписей», а цены в частном секторе формируются конкуренцией.[4] Сроки подключения тоже не публикуются, по состоянию на 5 октября 2026 г.
Некоторые правила обязательны для вас в обоих вариантах. Договорные правила BankID запрещают «ID switching»: использовать вход для выдачи пароля или другого средства аутентификации либо сохранять сеанс пользователя с помощью cookie дольше двух часов бездействия.[4] Новые hint codes могут появляться «без предварительного уведомления», и прямая интеграция должна обрабатывать неизвестные коды.[6]
Государственные органы платят фиксированную цену через систему авторизации DIGG. Частные компании могут подключиться только к узлу eIDAS DIGG.[4][12] Коммерческая сторона описана в статье BankID для бизнеса в Швеции.
Сценарии использования API BankID
| Сценарий | Что дает BankID | Правовая основа |
|---|---|---|
| Онбординг KYC и AML | Подтвержденная личность через нотифицированную электронную идентификацию | Lag (2017:630), гл. 3, § 7[13] |
| Онлайн-гемблинг | Надежная электронная идентификация при регистрации | Spellagen, гл. 12, § 2[14] |
| Проверка возраста | Дата рождения из personnummer | Ответ на запрос collect[6] |
| Платежи | Строгая аутентификация клиента и динамическая привязка | PSD2[3] |
| Договоры и кредитование | Усиленная электронная подпись | eIDAS, Регламент (ЕС) № 910/2014[3] |
Для гемблинга действуют два дополнительных правила: онлайн-регистрация доступна только резидентам Швеции, а лицензии не могут распространяться на лиц младше 18 лет.[14]
Ограничения и резервные варианты
Для BankID нужны шведский personnummer и банк-эмитент.[5]
- Несовершеннолетние: возрастной порог устанавливает банк, «чаще всего ... либо 13, либо 18 лет», и несовершеннолетним нужно согласие родителей.[5]
- Шведы за рубежом могут утратить право на BankID, если их исключат из реестра SPAR.[5]
- Иностранные граждане: в новостной ленте BankID объявлено о продлении с паспортами ЕС для зарегистрированных граждан других стран с 5 мая 2026 года. Приезжие и нерезиденты без personnummer получить его не могут.[5][9]
По данным Computer Sweden, полиция сообщила о снижении телефонного мошенничества, связанного со входом через BankID, на 90% после появления QR-кодов. В 2026 году BankID добавил предупреждение о платеже и дополнительную проверку лица.[9]
Для всех остальных резервный вариант: проверка документа. Считайте чип паспорта или ID-карты по NFC (см. проверка eID по NFC и безопасность чипа), проверьте liveness и сопоставьте лицо.
1Сначала предлагайте BankID шведским пользователям
Приложение на том же устройстве или QR-код на компьютере.
Пользователь проходит запрос BankID
Примите подписанный результат
Personnummer, имя, подпись, OCSP.
Проверьте по документу
Считывание NFC-чипа, liveness и сопоставление лица.
2Получите адрес из другого источника
BankID его не возвращает.
3Проведите скрининг и примите решение
Проверки по санкциям и PEP. Решение остается за вами.
Сначала eID, документ как резервный вариант, одно решение в конце.
Чек-лист интеграции BankID
- Выберите между прямым договором с банком и реселлером.
- Перечислите атрибуты, которые требует ваша политика, и источник адреса.
- Поддержите запуск на том же устройстве и QR-код на компьютере.
- Опрашивайте collect каждые две секунды и прекращайте при статусе failed.[6]
- Сопоставьте каждый hint code с сообщением для пользователя, включая неизвестные.[6]
- Определитесь с индикатором риска и дополнительной проверкой.
- Храните подпись и ответ OCSP для аудита.[6]
- Завершайте неактивные сессии в рамках правила двух часов.[4]
- Настройте резервную проверку по документу для пользователей без BankID.
- Протестируйте интеграцию в тестовой среде BankID до запуска в работу.
Как Didit помогает с верификацией через BankID Sweden
BankID Sweden уже работает в Didit. Пользователь выбирает BankID в размещённом сценарии проверки или в SDK и входит на том же телефоне или по QR-коду. Didit никогда не запрашивает защитный код BankID (PIN).
Включите его в консоли в разделе Workflows, ID Verification, Countries, Wallets accepted или через API workflows. Вход возвращает полное имя, дату рождения, шведский personnummer, уровень доверия (с пометкой Substantial) и проверку подписи (вердикт, а не саму подпись). Адрес и фотография не передаются. Пользователи без BankID переходят на съемку документа со считыванием NFC-чипа, проверкой живости и сравнением лиц в том же сценарии. Полная проверка KYC стоит $0.33, верификация NFC $0.15, а AML-скрининг $0.20.
Оплачиваются только завершённые входы через BankID. Отменённые, прерванные по тайм-ауту и неудачные входы бесплатны. Проверки документов оплачиваются за каждую проверку. BankID стоит $0.20 (цены). Подключённые eID перечислены на странице цифровых ID-кошельков.
Скриншот в подготовке: hosted-flow-wallet-chooser
Пользователь выбирает BankID в сценарии Didit.
Скриншот в подготовке: hosted-flow-qr
На компьютере QR-код передает вход на телефон.
Скриншот в подготовке: console-wallets-accepted
Включение BankID Sweden в консоли Didit.
Что обеспечивает Didit
- Вход через BankID Sweden в размещённом сценарии или в SDK
- Маршрут с документом для пользователей без BankID
- Подписанные атрибуты и доказательства каждой проверки
Что остается за вами
- Оценка рисков и политики
- Решение об онбординге
- Источник адреса клиента
Подключите BankID Sweden к регистрации пользователей уже сегодня
Включите BankID и маршрут с документом в одном сценарии и платите только за завершенные входы через eID.
Главное
- В 2025 году BankID пользовались 8.7 млн человек, и он есть у 99.9% зарегистрированных шведов в возрасте от 18 до 67 лет.
- BankID покупают у банка и интегрируют самостоятельно либо подключают через реселлера. Цены не публикуются.
- Вход возвращает personnummer и имя в подписанном виде, но без адреса и без фотографии.
- DIGG относит BankID к уровню Substantial, что соответствует статье 22(6)(b) AMLR с 10 июля 2027 г.
Часто задаваемые вопросы
Сколько стоит API BankID?
BankID не публикует цены. Стоимость обычно зависит от количества идентификаций и подписей, а цены в частном секторе определяет конкуренция.[4] Didit взимает $0.20.
Какие данные возвращает BankID?
12-значный personnummer, полное имя, имя и фамилию, подпись и ответ OCSP, а также данные об устройстве и необязательный уровень риска. Адрес, гражданство и фотография не передаются.[6]
Можно ли с помощью BankID проверить возраст пользователя?
Да. В personnummer закодирована дата рождения, поэтому каждый вход показывает возраст пользователя. Несовершеннолетним сам BankID доступен, только если это разрешает их банк, обычно с 13 или 18 лет и с согласия родителей.[5][6]
Могут ли иностранцы пользоваться BankID?
Только при наличии шведского personnummer и счета в банке-эмитенте. В новостях BankID сообщается, что с 5 мая 2026 года зарегистрированные лица, не являющиеся гражданами Швеции, могут продлевать BankID по паспортам ЕС. Посетителям без personnummer нужен другой способ, например проверка документа.[5][9]
Какой уровень доверия у BankID?
«Существенный». BankID входит в шведскую схему eID, о которой уведомили в рамках eIDAS 14 декабря 2020 года. Схема заявлена на уровнях «существенный» и «высокий», а DIGG относит средства BankID к уровню «существенный» и к шведскому уровню доверия 3.[10][11]
Достаточно ли BankID для надлежащей проверки клиентов по AML в Швеции?
Это допустимое средство. Закон о противодействии отмыванию денег, глава 3, раздел 7, позволяет использовать электронную идентификацию eIDAS для проверки личности. Скрининг, оценка рисков и мониторинг по-прежнему обязательны дополнительно.[13]
Сколько времени занимает интеграция BankID?
По состоянию на 5 октября 2026 года BankID не публикует сроки подключения. Для прямой интеграции нужны договор с банком, сертификат доверяющей стороны от BankID Keygen и собственная обработка QR-кодов, опроса (polling) и кодов подсказок (hint codes). Реселлер заменяет всё это одним API.[4][6]
Можно ли протестировать BankID до запуска?
Да. На сайте BankID для разработчиков есть тестовый портал рядом со справочником API.[6] Для запуска всё равно нужен договор с банком или реселлером, а при прямом подключении ещё и сертификат доверяющей стороны, заказанный через BankID Keygen.[4] Протестируйте также обработку неизвестных кодов подсказок, потому что BankID может добавлять новые коды без предварительного уведомления.[6]
Заменяет ли SverigeID BankID?
Нет. SverigeID, государственный e-ID, который запускается 1 декабря 2026 года, дополняет BankID и Freja. Он одобрен на шведском уровне доверия 4, но по состоянию на 5 октября 2026 года ещё не включён в список уведомлённых схем ЕС.[11][17]
Источники
- BankID в цифрах, BankID, данные за 2025 год.
- История, BankID.
- Законы и нормативные акты, BankID.
- Подключите свой бизнес, BankID.
- Как получить BankID, BankID.
- Справочник API /collect, BankID Developers, дата обращения 5 октября 2026 года.
- Распознавание лица как дополнительная проверка, новости BankID, август 2026 года.
- Цифровое удостоверение личности на избирательном участке, новости BankID, 2026 год.
- Новости, BankID, публикации 2026 года.
- Обзор предварительно уведомлённых и уведомлённых схем eID в рамках eIDAS, Европейская комиссия, дата обращения 5 октября 2026 года.
- Одобренные e-ID и функции удостоверения, DIGG.
- Об электронной идентификации, DIGG.
- Lag (2017:630) om åtgärder mot penningtvätt och finansiering av terrorism, Sveriges riksdag.
- Spellagen (2018:1138), текст закона на lagen.nu.
- Регламент (ЕС) 2024/1624 (AMLR), статья 22, EUR-Lex.
- Итоговый отчет, проект RTS в соответствии со статьей 28(1) AMLR, AMLA, 30 сентября 2026.
- Statlig e-legitimation, SverigeID, Полиция Швеции.
Сравните все национальные eID на странице проверки через eID или начните с материала о том, что такое проверка через eID.
Один процесс для Швеции и других стран
Начните с BankID, добавьте eID, которые уже есть у ваших пользователей, а документы оставьте как резервный вариант.
Похожие статьи
- e-Devlet для бизнеса: проверка личности в Турции
- Интеграция Singpass Myinfo: руководство для бизнеса в Сингапуре
- Интеграция с Cl@ve в Испании: кто может подключиться и чем её заменить
- Проверка PhilSys: как компании проверяют национальный ID
- Руководство для верификатора OpenID4VP: приём EUDI Wallet
- Регламент eIDAS: что меняет eIDAS 2 (2024/1183)