...

API и SDK для верификации

Один REST API для проверки клиентов: распознавание паспорта и других документов с антифрод-проверками, AML-проверки по госреестрам и санкционным спискам, результат в JSON и вебхуком. Для сайта и мобильного браузера — готовый Web SDK. Работает в облаке в России или в вашем контуре.

Верификация пользователей через API: ноутбук разработчика и смартфон с виджетом проверки паспорта
  • REST API: KYC-сессии и AML-проверки в JSON
  • Web SDK для сайта и мобильного браузера
  • Облако в России или Docker в вашем контуре
Данные хранятся в России Реестр российского ПО №19972 152‑ФЗ

Что подключается через KYC API и AML API

Проверка клиентов онлайн по API: один аккаунт, один токен и общий формат ответа для всех продуктов. Подключайте только то, что нужно вашему процессу, — остальное можно добавить позже без новой интеграции. Мониторинг транзакций (KYT) подключается по проекту — подробнее на странице KYT.

  • Распознавание и проверка документов

    Паспорт РФ, загранпаспорт, водительское удостоверение, ID-карта и ещё 16 000+ типов документов из 195+ стран и территорий. В ответе — тип документа, поля с уровнем уверенности и антифрод-проверки изображения: редактор, фото с экрана, распечатка.

    OCR API и SDK
  • AML-проверки физического лица

    Перечень Росфинмониторинга, санкционные списки OFAC, ЕС, Великобритании и ООН, комплаенс-скрининг PEP, розыск, долги, банкротство, суды — по ФИО и паспорту, без загрузки документа. Каждая проверка выбирается отдельно.

    Каталог проверок
  • Действительность паспорта по данным МВД

    Проверка серии, номера и даты выдачи паспорта РФ через СМЭВ и получение ИНН по паспорту — отдельные проверки того же AML API. Подходит для банковской верификации паспорта без визита в офис.

    Проверки физических лиц
  • Liveness и сверка лица

    Селфи, селфи с документом и проверка живости — шаги того же KYC-сценария: включаются в редакторе сценария и проходят в Web SDK. Сверка лица с фото в документе приходит в ответе сессии.

    Liveness
  • Web SDK

    Готовый JavaScript-виджет проводит пользователя по шагам сценария и сам отправляет снимки в API. Работает в браузерах на компьютере и смартфоне.

    Подробнее ниже
  • Проверка контрагентов по ИНН

    Статус компании, признаки однодневки, суды, руководитель и учредители — на странице проверки контрагентов. Методы KYB в документации пока не опубликованы: доступ к API обсудим на тестовом доступе.

    Проверка контрагентов

Карта методов REST API NeuroVision

Все методы — POST по адресу https://api.neuro-vision.ru/v1/, тело — JSON или multipart/form-data для изображений, ответ — JSON. Ниже — методы, которые нужны для интеграции; полный список с параметрами — в документации REST API.

  • KYC-сессии: документы и селфи

    Сессия собирает все шаги проверки одного пользователя по сценарию. Поля ответа документа и пример /kyc/process — на странице OCR API и SDK.

    Методы KYC

    Загрузка и распознавание

    • /kyc/process — изображения документов и селфи, режим sync или async; /kyc/session/create — новая сессия

    Результат

    • /kyc/session/status — статус и результаты по sessionId или clientKey; /kyc/session/status/change — смена статуса вручную

    Выгрузки

    • /kyc/sessions, /kyc/sessions/filter — список и фильтр сессий, экспорт CSV/XLSX; /kyc/download — архив логов
  • AML-проверки физического лица

    Проверки по данным, без KYC-сессии и загрузки документа.

    AML: API и интеграция

    Запуск

    • /kyc/checks/run — данные человека и список проверок в checkers, сразу возвращает runId

    Результат

    • /kyc/checks/result — опрос по runId каждые 5–10 секунд, пока checksStatus не станет complete

    По KYC-сессии

    • /kyc/session/databases — проверки по данным распознанного документа, результат — вебхуком DATABASE_CHECKS_COMPLETE
  • Аккаунт, токены и данные

    Доступ к API, баланс и управление персональными данными.

    Токены доступа

    Авторизация

    • /user/login — временный JWT со сроком valid_days; /token/create, /token/update, /token/delete, /tokens — постоянные токены

    Баланс

    • /user/balance — текущий баланс аккаунта или группы

    Персональные данные

    • kyc/session/erase — уничтожение ПД по sessionId или по clientUser во всех сессиях пользователя; kyc/session/erase/log — журнал

Архитектура интеграции: бэкенд, API и вебхук

Ваш бэкенд хранит токен и принимает решение, фронтенд только снимает документ и селфи. Так ключи не попадают в браузер, а итог проверки всегда приходит на сервер — даже если пользователь закрыл вкладку. Подключить проверки к CRM, ERP или 1С можно через тот же REST API.

Шаг 1

1. Сценарий в личном кабинете

В редакторе сценария задаёте шаги проверки, типы документов и страны, антифрод-проверки, callback URL и секретный ключ. Идентификатор сценария (schemaId) понадобится в API и SDK.

Сценарий проверки в личном кабинете: шаги, идентификатор и callback URL
Шаг 2

2. Токен на вашем сервере

Постоянный токен создаётся в разделе «Доступ» и хранится как секрет бэкенда. Временный JWT удобен для скриптов и тестов. В браузер токен не передаётся.

Постоянный токен доступа к API в личном кабинете NeuroVision
Шаг 3

3. Съёмка на фронтенде

Web SDK открывается поверх вашей страницы и проводит пользователя по шагам: документ, селфи, проверка живости. Если интерфейс свой — бэкенд сам отправляет изображения в /kyc/process.

Съёмка документа в Web SDK или в собственном интерфейсе
Шаг 4

4. Обработка в NeuroVision

Сервис распознаёт документ, проверяет изображение и сверяет лица, а при включённых проверках по базам запускает их по данным документа. Для проверок без документа — отдельный вызов /kyc/checks/run.

Обработка сессии: документ, сверка лица и проверки по базам
Шаг 5

5. Вебхук и решение

Итог сессии приходит на callback URL вашего бэкенда; итог можно в любой момент запросить по sessionId. Ваша система записывает данные в анкету, CRM или АБС и решает: одобрить, отказать или отправить оператору.

Вебхук приходит на бэкенд, система принимает решение по проверке

Пример запроса и ответа: AML API и статус KYC-сессии

KYC API паспорт и AML-проверки в коде: запуск проверок физического лица, ответ и результат, затем статус KYC-сессии. Структура — из документации, данные вымышленные. Пример распознавания документа через /kyc/process — на странице OCR API и SDK. Параметры — в описании запуска проверок и статуса сессии.

Запрос: запуск проверок

cURL
curl -X POST "https://api.neuro-vision.ru/v1/kyc/checks/run" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "<ВАШ_ТОКЕН>",
    "person": {
      "lastName": "Лавров",
      "firstName": "Ярослав",
      "middleName": "Ильич",
      "birthDate": "1990-01-01",
      "passport": { "series": "0000", "number": "000000", "issueDate": "2010-01-01" }
    },
    "checkers": [
      "passportVerification",
      "regulatoryRestrictions",
      "sanctionsLists",
      "debtBurden",
      "insolvencyStatus"
    ]
  }'

Как читать результат AML

Результат каждой AML-проверки приходит в двух полях — три возможных статуса ниже. Названия всех проверок — в каталоге.

  • Сначала outcome, потом passed

    Поле outcome говорит, дошла ли проверка до источника, поле passed — что источник ответил. Читайте их в таком порядке.

    • outcome → passed
  • Источник опрошен

    Проверка дошла до реестра и вернула результат: смотрите поле passed. Такая проверка тарифицируется.

    • outcome: performed
  • Не хватило данных

    Проверка не запускалась: не передан обязательный параметр. Она не тарифицируется. Пустой результат здесь значит «не проверяли», а не «чисто» — не принимайте его за пройденную проверку.

    • outcome: skipped
  • Реестр не ответил

    Источник временно недоступен, результата нет. Запуск можно повторить позже тем же запросом.

    • outcome: unavailable

KYC SDK для сайта или свой интерфейс на REST API

  • Кто снимает документ и что делает бэкенд

    Свой интерфейс + REST API — снимает ваш фронтенд или мобильное приложение, бэкенд отправляет изображения в /kyc/process и читает ответ. Web SDK NeuroVision — снимает виджет: инструкция, рамка, подсказки «поля не видны», повторная съёмка; бэкенд создаёт сессию, шифрует clientKey и принимает вебхук.

  • Проверка живости и подключение

    Свой интерфейс — HTTP-клиент на любом языке; как передать серию кадров для проверки живости без виджета, уточним на тестовом доступе. Web SDK — проверка живости шаг сценария и проходит в виджете; подключение — <script> с widget-lib.js или npm-пакет kyc-widget-nv для React.

  • Оформление и компьютер без камеры

    Свой интерфейс — оформление полностью ваше, поведение на компьютере без камеры — ваша логика. Web SDK — логотип, цвета, тексты экранов и светлая или тёмная тема задаются в редакторе сценария; компьютер без камеры — переход на телефон по QR-коду или ссылке.

  • Мобильные приложения: WebView вместо нативного SDK

    Отдельных SDK для iOS и Android сейчас нет. Виджет адаптивный и работает с камерой смартфона, поэтому в приложении его открывают во встроенном браузере или WebView. Внутри cross-origin iframe браузер блокирует камеру — вкладывать виджет в чужой iframe нельзя.

  • Серверные библиотеки и код подключения

    Серверных библиотек для Python, Java и C# тоже нет: API работает по обычному HTTP, готовые скрипты есть на Python. Код подключения виджета для HTML и React — на странице OCR API и SDK и в документации: подключение, параметры, работа с clientKey.

  • Запуск без разработки

    Свой интерфейс и Web SDK требуют подключения кода. Без интеграции — прямая ссылка на виджет или одноразовые KYC-ссылки из личного кабинета, до 1 000 штук за раз.

Оба варианта ведут к одному результату — сессии с тем же JSON и тем же вебхуком. Разница в том, кто рисует экраны съёмки и проверяет качество снимка до отправки. Web SDK для верификации подходит для быстрого старта, свой интерфейс — когда съёмка уже встроена в ваш продукт.

Как получить результат: синхронно, вебхуком или опросом

  • mode=sync результат в ответе /kyc/process — для анкеты, где пользователь ждёт
  • mode=async сразу sessionId, итог — вебхуком или по статусу
  • Статус KYC-сессии /kyc/session/status по sessionId или clientKey
  • AML без сессии опрос /kyc/checks/result раз в 5–10 с
  • Пока идёт обработка статус сессии processing, у AML — pending

  • Где настроить редактор сценария → callback URL вашего бэкенда
  • Шифрование тела секретный ключ сценария
  • Без персональных данных флаг: в вебхуке только статусы
  • Только итог флаг: без промежуточных статусов
  • Проверки по базам DATABASE_CHECKS_COMPLETE или по мере готовности
  • Распознавание документа может вернуть результат в том же ответе. Проверки по госреестрам идут минуты: часть реестров отвечает медленно, поэтому они всегда асинхронные.
  • Рекомендуемая схема для продакшена — асинхронный режим и вебхук: бэкенд не держит соединение открытым, а итог приходит, даже если пользователь ушёл со страницы. Результат любой сессии можно перечитать позже по sessionId — структурированные данные хранятся бессрочно или столько, сколько задано в сценарии.

Облако NeuroVision или ваш контур: где работает API

  • Облако в России

    Быстрый старт: токен, сценарий — и можно отправлять запросы. Масштабирование, мониторинг и обновления моделей — на стороне NeuroVision. Подробнее — KYC-сервис в России.

  • В вашем контуре

    Платформа ставится набором Docker-контейнеров на ваши серверы, установку и обновления выполняют инженеры NeuroVision. После установки работает без интернета: доступ нужен для активации лицензии и обновлений.

  • Что одинаково

    Те же методы, тот же JSON и те же вебхуки — переход из облака в контур не требует переписывать интеграцию. Меняется только адрес API. Требования к серверу — на странице OCR API и SDK.

Для банков и госкомпаний с изолированным контуром — выделенные серверы и индивидуальный SLA обсуждаются в договоре.

Лимиты, версии и поддержка API

Цифры из документации NeuroVision

Проверьте их на тестовом доступе — на ваших данных и вашей нагрузке.

  • 01

    Лимиты и пакеты

    По тарифу частоту запросов не ограничивают: купленный пакет можно израсходовать за день или за год. Если пакет закончился, сервис не блокируется. Ожидаемую нагрузку и число параллельных запросов обсуждаем на тестовом доступе.

  • 02

    Одна сессия — по очереди

    Одновременные загрузки в одну KYC-сессию обрабатываются по одной. Следующий запрос ждёт до 25 секунд, затем получает 409 session is busy — кадр не обработан, попытка не списана. Повторите запрос после ответа на предыдущий.

  • 03

    Версии и журнал изменений

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

  • 04

    Поддержка интеграции

    В рабочие дни с 10:00 до 18:00 по Москве — тикеты в личном кабинете, Telegram и почта. Круглосуточная поддержка с SLA — по отдельному договору. В обращении укажите sessionId и сценарий — так ответ придёт быстрее.

  • 5–10 с интервал опроса результата AML-проверок
  • 25 с ожидание очереди к одной KYC-сессии
  • 6 месяцев хранятся оригиналы изображений

Коды ответов и ошибки API

  • 400 invalid schema тело не соответствует схеме метода
  • 400 unknown or not allowed checkers опечатка в проверке или проверка не разрешена аккаунту
  • 401 access denied нет токена или токен не действует
  • 404 run not found чужой или несуществующий runId
  • 409 session is busy к сессии идёт другой запрос — повторить после ответа

  • Сессия failed причина — в errors шага в формате [группа] описание
  • Сессия suspicious признаки мошенничества — кадры в сессию больше не слать
  • Сессия expired истекло время жизни из сценария — создать новую сессию
  • AML skipped не хватило данных, список — в missingInputs; не тарифицируется
  • AML unavailable реестр не ответил — запуск можно повторить
  • Ошибки бывают двух видов. Ошибка запроса — HTTP-код и message: запрос отклонён целиком, в сессии ничего не меняется, попытка не списывается. Результат проверки — обычный ответ 200, где причина отказа лежит в status, errors или outcome.
  • Полный справочник с описанием каждой проверки — Ошибки KYC. Ошибки распознавания документа (bad image, text fields not visible и др.) разобраны на странице OCR API и SDK.

От тестового доступа до продакшена: 5 шагов

Подключить KYC API — это вечер разработчика на первый запрос и несколько дней на вебхук, обработку отказов и тесты на ваших данных. Организационные шаги — на нашей стороне.

Шаг 1

1. Тестовый доступ

Оставьте заявку. Менеджер выдаст доступ к личному кабинету и документации. Тестовый период — 1 месяц.

Шаг 1 из 5: тестовый доступ
Шаг 2

2. Токен и сценарий

В разделе «Доступ» создайте токен, в разделе «KYC/AML» — сценарий: документы, страны, проверки, callback URL. Скопируйте идентификатор сценария.

Шаг 2 из 5: токен и сценарий
Шаг 3

3. Первый запрос

Отправьте фото документа в /kyc/process или запустите AML-проверки по примеру выше. Посмотреть процесс глазами пользователя можно в демо.

Шаг 3 из 5: первый запрос
Шаг 4

4. Вебхук и отказы

Включите асинхронный режим и вебхук, обработайте failed, suspicious, skipped и 409. Решите, какие случаи уходят оператору.

Шаг 4 из 5: вебхук и отказы
Шаг 5

5. Продакшен

После договора — боевые доступы. Для изолированного контура — выделенные серверы и установка у вас. Следите за списком изменений API.

Шаг 5 из 5: продакшен

Сколько стоит запрос к API

Платите за проверки, а не за подключение. Пакеты расходуются в любом темпе. Тестовый период — 1 месяц.

Рассчитать стоимость
  • 01

    KYC-сессия с распознаванием документа и антифрод-проверками — от 16 ₽: в сессию входят все шаги сценария и до 6 бесплатных попыток съёмки на шаг

  • 02

    AML-проверка по госреестру — 5 ₽, 16 базовых проверок — 50 ₽, международный комплаенс-скрининг — 36 ₽

  • 03

    Проверка, которой не хватило данных, не тарифицируется

Лицензии и сертификаты

Фонд содействия инновациям

Проект «Разработка мультимодальной системы с применением искусственного интеллекта "Neuromed" для управления диагностическими процессами клиники на базе платформы компьютерного зрения "Нейровижн"» поддержан Фондом содействия инновациям в рамках реализации федерального проекта «Отечественные решения»

Получите тестовый доступ к API

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

Не можете сформулировать запрос? Запишитесь на звонок, и наша команда свяжется с вами в удобное время

Записаться на звонок

Компания внесена в реестр IT-компаний и реестр операторов персональных данных Минцифры России.

Адрес: Москва, Пресненская наб., д. 12 — деловой центр «Москва-Сити», башня «Федерация». Ближайшие станции метро — «Деловой центр» и «Международная».

Частые вопросы об API и SDK NeuroVision

Распознавание документов с антифрод-проверками, селфи и проверку живости как шаги KYC-сессии, а также AML-проверки физического лица по госреестрам и санкционным спискам. Всё работает через один REST API с одним токеном. Для сайта и мобильного браузера есть готовый Web SDK.

KYC API работает с изображениями: документ, селфи, сверка лиц, результат — в KYC-сессии. AML API проверяет человека по данным — ФИО, дате рождения, паспорту — без загрузки документа: методы /kyc/checks/run и /kyc/checks/result. Их можно связать: проверки по базам запускаются по данным распознанного документа той же сессии.

В два шага. KYC API распознаёт паспорт по фото и проверяет изображение на редактирование, фото с экрана и распечатку. AML-проверка passportVerification сверяет серию, номер и дату выдачи с данными МВД, а taxIdLookup получает ИНН по паспорту.

Нативных SDK для iOS и Android сейчас нет. Web SDK работает в мобильных браузерах и открывается внутри приложения через WebView или встроенный браузер, поэтому проверку можно встроить и в мобильное приложение. Ограничение — виджет нельзя вкладывать в чужой iframe: браузер заблокирует камеру.

Отдельных серверных библиотек нет: API работает по обычному HTTP, поэтому подходит любой язык. В документации есть готовые скрипты на Python, на этой странице — примеры на cURL и Python.

Оба способа доступны. Для KYC-сессии удобнее вебхук на callback URL из сценария, при необходимости статус запрашивается по sessionId или clientKey. Результат AML-проверок без сессии забирается опросом /kyc/checks/result каждые 5–10 секунд.

Постоянным токеном из раздела «Доступ» личного кабинета или временным JWT, который выдаёт метод /user/login. Постоянный токен удобнее для серверной интеграции, его передают полем token в теле запроса. Без токена API отвечает 401 access denied.

Да, тестовый доступ даём на 1 месяц — с личным кабинетом, токеном и документацией. Оставьте заявку внизу страницы. Посмотреть, как проходит проверка у пользователя, можно в демо.

По тарифу частоту запросов не ограничивают: пакет можно израсходовать в любом темпе, а после его окончания сервис не блокируется. Запросы к одной KYC-сессии обрабатываются по очереди. Ожидаемую нагрузку обсуждаем на старте тестового доступа.

KYC-сессия с распознаванием документа и антифрод-проверками — от 16 ₽, AML-проверка по госреестру — 5 ₽. Проверка, которой не хватило данных, не тарифицируется. Точная цена зависит от сценария и объёма — её считает прайс-матрица.

Да. Платформа устанавливается в ваш контур как набор Docker-контейнеров, установку и обновления выполняют инженеры NeuroVision. После установки она работает без интернета, а методы API остаются теми же.

Метод kyc/session/erase уничтожает персональные данные одной сессии или всех сессий пользователя по clientUser. Вопросы по интеграции принимает поддержка: тикеты в личном кабинете, Telegram и почта — контакты в документации.