1. Сценарий в личном кабинете
В редакторе сценария задаёте шаги проверки, типы документов и страны, антифрод-проверки, callback URL и секретный ключ. Идентификатор сценария (schemaId) понадобится в API и SDK.
Один REST API для проверки клиентов: распознавание паспорта и других документов с антифрод-проверками, AML-проверки по госреестрам и санкционным спискам, результат в JSON и вебхуком. Для сайта и мобильного браузера — готовый Web SDK. Работает в облаке в России или в вашем контуре.
POST /kyc/process POST /kyc/checks/run POST /kyc/checks/result DATABASE_CHECKS_COMPLETE Проверка клиентов онлайн по API: один аккаунт, один токен и общий формат ответа для всех продуктов. Подключайте только то, что нужно вашему процессу, — остальное можно добавить позже без новой интеграции. Мониторинг транзакций (KYT) подключается по проекту — подробнее на странице KYT.
Паспорт РФ, загранпаспорт, водительское удостоверение, ID-карта и ещё 16 000+ типов документов из 195+ стран и территорий. В ответе — тип документа, поля с уровнем уверенности и антифрод-проверки изображения: редактор, фото с экрана, распечатка.
Перечень Росфинмониторинга, санкционные списки OFAC, ЕС, Великобритании и ООН, комплаенс-скрининг PEP, розыск, долги, банкротство, суды — по ФИО и паспорту, без загрузки документа. Каждая проверка выбирается отдельно.
Проверка серии, номера и даты выдачи паспорта РФ через СМЭВ и получение ИНН по паспорту — отдельные проверки того же AML API. Подходит для банковской верификации паспорта без визита в офис.
Селфи, селфи с документом и проверка живости — шаги того же KYC-сценария: включаются в редакторе сценария и проходят в Web SDK. Сверка лица с фото в документе приходит в ответе сессии.
Готовый JavaScript-виджет проводит пользователя по шагам сценария и сам отправляет снимки в API. Работает в браузерах на компьютере и смартфоне.
Статус компании, признаки однодневки, суды, руководитель и учредители — на странице проверки контрагентов. Методы KYB в документации пока не опубликованы: доступ к API обсудим на тестовом доступе.
Все методы — POST по адресу https://api.neuro-vision.ru/v1/, тело — JSON или multipart/form-data для изображений, ответ — JSON. Ниже — методы, которые нужны для интеграции; полный список с параметрами — в документации REST API.
Сессия собирает все шаги проверки одного пользователя по сценарию. Поля ответа документа и пример /kyc/process — на странице OCR API и SDK.
/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 — архив логовПроверки по данным, без KYC-сессии и загрузки документа.
/kyc/checks/run — данные человека и список проверок в checkers, сразу возвращает runId/kyc/checks/result — опрос по runId каждые 5–10 секунд, пока checksStatus не станет complete/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 — журналВаш бэкенд хранит токен и принимает решение, фронтенд только снимает документ и селфи. Так ключи не попадают в браузер, а итог проверки всегда приходит на сервер — даже если пользователь закрыл вкладку. Подключить проверки к CRM, ERP или 1С можно через тот же REST API.
KYC API паспорт и AML-проверки в коде: запуск проверок физического лица, ответ и результат, затем статус KYC-сессии. Структура — из документации, данные вымышленные. Пример распознавания документа через /kyc/process — на странице OCR API и SDK. Параметры — в описании запуска проверок и статуса сессии.
Запрос: запуск проверок
cURLcurl -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"
]
}' Ответ 200 OK
JSON{
"runId": "00000000-0000-1000-8000-000000000000",
"checksStatus": "pending",
"pending": 5,
"checkers": [
"passportVerification",
"regulatoryRestrictions",
"sanctionsLists",
"debtBurden",
"insolvencyStatus"
],
"responseTime": "2026-10-17T09:00:00.000Z"
} Ответ /kyc/checks/result (фрагмент)
JSON{
"runId": "00000000-0000-1000-8000-000000000000",
"checksStatus": "complete",
"pending": 0,
"results": [
{
"checker": "regulatoryRestrictions",
"status": "success",
"outcome": "performed",
"notPerformedReason": null,
"missingInputs": [],
"result": { "passed": true, "items": [], "totalCount": 0, "error": null }
},
{
"checker": "debtBurden",
"status": "success",
"outcome": "unavailable",
"notPerformedReason": "providerUnavailable",
"missingInputs": [],
"result": { "passed": null, "items": [], "totalCount": 0, "error": null }
}
],
"responseTime": "2026-10-17T09:02:00.000Z"
} Опрос результата
Pythonimport time
import requests
API = "https://api.neuro-vision.ru/v1"
TOKEN = "<ВАШ_ТОКЕН>"
def wait_checks(run_id, timeout=600):
"""Опрашивает результат каждые 7 секунд, пока checksStatus != complete."""
started = time.time()
while time.time() - started < timeout:
resp = requests.post(f"{API}/kyc/checks/result",
json={"token": TOKEN, "runId": run_id}, timeout=30)
data = resp.json()
if data.get("checksStatus") == "complete":
return data["results"]
time.sleep(7)
raise TimeoutError("Проверки не завершились за отведённое время")
for item in wait_checks("<RUN_ID>"):
print(item["checker"], item["outcome"], item["result"]["passed"]) Запрос по clientKey
cURLcurl -X POST "https://api.neuro-vision.ru/v1/kyc/session/status" \
-H "Content-Type: application/json" \
-d '{"token": "<ВАШ_ТОКЕН>", "clientKey": "client-000001"}' Ответ (фрагмент)
JSON{
"status": "success",
"sessionId": "00000000-0000-1000-8000-000000000000",
"schemaId": "00000000-0000-1000-8000-000000000001",
"clientKey": "client-000001",
"isClientNew": true,
"spent": 4.215,
"errors": [],
"results": ["… результаты по шагам сценария: document, selfie, faces …"],
"createdAt": "2026-10-17T09:00:00.000Z"
} Результат каждой AML-проверки приходит в двух полях — три возможных статуса ниже. Названия всех проверок — в каталоге.
Поле outcome говорит, дошла ли проверка до источника, поле passed — что источник ответил. Читайте их в таком порядке.
Проверка дошла до реестра и вернула результат: смотрите поле passed. Такая проверка тарифицируется.
Проверка не запускалась: не передан обязательный параметр. Она не тарифицируется. Пустой результат здесь значит «не проверяли», а не «чисто» — не принимайте его за пройденную проверку.
Источник временно недоступен, результата нет. Запуск можно повторить позже тем же запросом.
Свой интерфейс + REST API — снимает ваш фронтенд или мобильное приложение, бэкенд отправляет изображения в /kyc/process и читает ответ. Web SDK NeuroVision — снимает виджет: инструкция, рамка, подсказки «поля не видны», повторная съёмка; бэкенд создаёт сессию, шифрует clientKey и принимает вебхук.
Свой интерфейс — HTTP-клиент на любом языке; как передать серию кадров для проверки живости без виджета, уточним на тестовом доступе. Web SDK — проверка живости шаг сценария и проходит в виджете; подключение — <script> с widget-lib.js или npm-пакет kyc-widget-nv для React.
Свой интерфейс — оформление полностью ваше, поведение на компьютере без камеры — ваша логика. Web SDK — логотип, цвета, тексты экранов и светлая или тёмная тема задаются в редакторе сценария; компьютер без камеры — переход на телефон по QR-коду или ссылке.
Отдельных 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 mode=async sessionId — структурированные данные хранятся бессрочно или столько, сколько задано в сценарии. Доступ по токену и ролям
Постоянный токен создаётся бессрочным или с датой окончания, срок можно изменить, токен можно удалить. Пользователям аккаунта владелец назначает роли с нужными разделами, вход защищается двухфакторной аутентификацией.
Браузер не видит секретов
clientKey для Web SDK шифруется на вашем сервере секретным ключом сценария (в документации — пример AES-256-CBC). Сам секретный ключ и токен в браузер не передаются.
Шифрование и минимум данных
Тело вебхука шифруется секретным ключом сценария. Флаг «не отправлять персональные данные» оставляет в уведомлении только статусы — данные бэкенд забирает сам по sessionId.
Один вызов на пользователя
Метод kyc/session/erase уничтожает персональные данные одной сессии или всех сессий пользователя по clientUser, журнал удалений — kyc/session/erase/log. Изображения хранятся 6 месяцев, срок хранения результатов задаётся в сценарии.
Облако или ваш контур
Облако NeuroVision работает на серверах в России. При установке в контуре изображения и результаты не покидают ваши серверы.
152‑ФЗ
серверы в России · реестр российского ПО № 19972
Быстрый старт: токен, сценарий — и можно отправлять запросы. Масштабирование, мониторинг и обновления моделей — на стороне NeuroVision. Подробнее — KYC-сервис в России.
Платформа ставится набором Docker-контейнеров на ваши серверы, установку и обновления выполняют инженеры NeuroVision. После установки работает без интернета: доступ нужен для активации лицензии и обновлений.
Те же методы, тот же JSON и те же вебхуки — переход из облака в контур не требует переписывать интеграцию. Меняется только адрес API. Требования к серверу — на странице OCR API и SDK.
Для банков и госкомпаний с изолированным контуром — выделенные серверы и индивидуальный SLA обсуждаются в договоре.
Проверьте их на тестовом доступе — на ваших данных и вашей нагрузке.
Лимиты и пакеты
По тарифу частоту запросов не ограничивают: купленный пакет можно израсходовать за день или за год. Если пакет закончился, сервис не блокируется. Ожидаемую нагрузку и число параллельных запросов обсуждаем на тестовом доступе.
Одна сессия — по очереди
Одновременные загрузки в одну KYC-сессию обрабатываются по одной. Следующий запрос ждёт до 25 секунд, затем получает 409 session is busy — кадр не обработан, попытка не списана. Повторите запрос после ответа на предыдущий.
Версии и журнал изменений
Версия API — в пути: /v1/. Каждый выкат описан в списке изменений: что поменялось в API, вебхуках, виджете и кодах ошибок, есть ли ломающие изменения и что сделать в интеграции.
Поддержка интеграции
В рабочие дни с 10:00 до 18:00 по Москве — тикеты в личном кабинете, Telegram и почта. Круглосуточная поддержка с SLA — по отдельному договору. В обращении укажите sessionId и сценарий — так ответ придёт быстрее.
400 invalid schema 400 unknown or not allowed checkers 401 access denied 404 run not found 409 session is busy failed suspicious expired skipped unavailable message: запрос отклонён целиком, в сессии ничего не меняется, попытка не списывается. Результат проверки — обычный ответ 200, где причина отказа лежит в status, errors или outcome. bad image, text fields not visible и др.) разобраны на странице OCR API и SDK. Подключить KYC API — это вечер разработчика на первый запрос и несколько дней на вебхук, обработку отказов и тесты на ваших данных. Организационные шаги — на нашей стороне.
Платите за проверки, а не за подключение. Пакеты расходуются в любом темпе. Тестовый период — 1 месяц.
Рассчитать стоимость
Проект «Разработка мультимодальной системы с применением искусственного интеллекта "Neuromed" для управления диагностическими процессами клиники на базе платформы компьютерного зрения "Нейровижн"» поддержан Фондом содействия инновациям в рамках реализации федерального проекта «Отечественные решения»
Платформа компьютерного зрения Нейровижн зарегистрирована в Роспатенте (свидетельство №2023661508) и включена в Реестр российского ПО (реестровая запись №19972 от 13.11.2023)
Право использовать Платформу предоставляются в соответствии с лицензионным договором, заключаемым Нейровижн с клиентами
Расскажите, какие проверки нужны — документы, AML-проверки по базам или всё вместе, — какой объём в месяц и где должен работать сервис. Выдадим доступ к личному кабинету и поможем с первым запросом.
Не можете сформулировать запрос? Запишитесь на звонок, и наша команда свяжется с вами в удобное время
Записаться на звонокКомпания внесена в реестр IT-компаний и реестр операторов персональных данных Минцифры России.
Адрес: Москва, Пресненская наб., д. 12 — деловой центр «Москва-Сити», башня «Федерация». Ближайшие станции метро — «Деловой центр» и «Международная».
Как выстроить проверку клиентов, выбрать модель развёртывания и не потерять пользователей на верификации — в нашем блоге. Защита данных во всём процессе проверки — в статье о KYC и персональных данных.
Распознавание документов с антифрод-проверками, селфи и проверку живости как шаги 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 и почта — контакты в документации.