В 2023 году МВД закрыло API-доступ к своей базе для проверки актуальности российских паспортов. Рынку оставили СМЭВ: вполне рабочий канал с регулярными таймаутами. Для онбординга это не всегда лучший сценарий: пользователь ждет, бизнес-процесс прерывается.
Когда проверка документов это часть онбординга, задержки и ошибки перестают быть техническим нюансом и становятся фактором потерь. По этой причине нужен источник, который можно подключить без отдельного шлюза и отдельной боли.
Компания «Биорг» откликнулась на запрос рынка и вывела в прод проверку действительности паспорта РФ и водительского удостоверения по актуальной базе МВД, с подключением к ней через сайт Госуслуг. Это не «еще один источник», а новый путь к привычной и необходимой проверке, который уже доступен в продукте «Биорг.Идентификация» (KYC).
Почему Госуслуги
СМЭВ может быть узким местом. Банк или финтех-компания отправляет запрос, а дальше ждет: часть ответов приходит быстро, часть после ретраев, а часть не приходит вовсе. В продуктовой воронке это складывается в очень понятную арифметику: каждая минута ожидания повышает шанс, что человек закроет вкладку и пойдет туда, где проверку делают быстрее.
Госуслуги важны не как бренд, а как надежный канал доступа к данным. Мы подключились к сайту, который использует актуальные данные МВД, и вывели эту проверку как отдельный этап обработки документа.
Результат приходит вместе с распознанными полями и статусом проверки. Не нужно строить отдельную интеграцию, разбирать ошибки СМЭВ и держать запасные костыли. Достаточно просто добавить этап «external_sites_check» в существующий запрос.
Не нужно отдельного клиента для внешнего шлюза, нет отдельных таймаутов и ретраев, нет отдельного логирования под каждый источник. Проверка живет там же, где и весь пайплайн обработки документа.
Мы получили рабочий канал для проверки действительности документов, который можно использовать вместо СМЭВ или параллельно с ним. Если в процессе уже есть СМЭВ, новый этап позволяет не терять пользователей на чужих сбоях.
Обсудите вашу задачу со специалистом — это бесплатно
Нужно автоматически распознавать паспорта РФ или иностранных граждан? Свяжитесь с нашим экспертом Евгением Гусарским, чтобы оценить проект.
@beorg_supЧто это меняется для вашего продукта
Когда важна не «проверка ради проверки», а влияние на метрики продукта, эффект от новой фичи «Биорг» возникает из трех слагаемых вместе или по-отдельности.
- Меньше фрода. Если документ недействителен, система может остановить онбординг до ручной проверки и не тратить ресурсы на последующие шаги. Это важно при выдаче кредитов, карт, в аренде и других процессах, где цена ошибки высока. В комплаенс-моделях такой статус можно использовать как жесткий стоп-фактор или как триггер для дополнительной проверки.
- Скорость. Проверка выполняется в рамках того же запроса, где распознается документ. Не нужно отправлять пользователя на отдельный сценарий, просить повторную загрузку или держать статус «проверяется» несколько часов. Чем короче ожидание, тем выше шанс успешной конверсии.
- Предсказуемость. У ответа есть понятный статус и пояснение. Продуктовая логика может вести себя по-разному: при статусе «действительный» — продолжать флоу, при статусе «недействителен» — показать ошибку или запросить другой документ, при статусе «сервис недоступен» — дать запасной сценарий. Это лучше, чем бесконечно крутить троббер для клиента.
Если проверка занимает до 2 минут, заявка не уходит в подвешенное состояние. Это снижает нагрузку на поддержку и процедуры ручного комплаенса. Статус приходит сразу и продуктовые правила можно применять в тот же момент: не отправлять на скоринг пользователя с недействительным документом, не резервировать лимиты, не нарезать бессмысленных задач бэк-офису.
Для ВУ логика та же. Меняется тип документа, но проверка подключается тем же этапом. Это удобно, если сервис уже работает с паспортами и нужно расширить сценарий на ВУ.
Под капотом
Чтобы включить проверку, добавьте в запрос этап `external_sites_check` и укажите сервис `gosuslugi` в `stages_settings`.
Проверка работает для паспорта РФ и российских ВУ. Перед отправкой должны быть распознаны обязательные поля: для паспорта — серия, номер, фамилия и имя; для ВУ — серия, номер, фамилия, имя, отчество и дата рождения.
Данные проверок по Базам данных доступны в документах по ключу external_integrations
Пример запроса для паспорта:
COCO JSON
{
«project_id»: «U_RATE_3»,
«images»: [«<строка base64>»],
«process_info»: [
{
«key»: «PASSPORT»,
«type»: «PASSPORT»,
«options»: {
// Было: только распознавание и проверка качества/подлинности
// Стало: добавили этап внешних проверок
«stages»: [«verification», «external_sites_check»],
«stages_settings»: {
// Новый блок: куда ходить за проверкой
«external_sites_check»: {
«list»: [«gosuslugi»]
}
}
}
}
]
}
В запросе изменились две вещи: в `stages` добавлен `external_sites_check`, а в `stages_settings` указан источник `gosuslugi`. В ответе придет объект `gosuslugi` со статусом и текстовым комментарием. Для ВУ запрос такой же, меняется только `type` на `DLIC`.
Статус проверки паспорта РФ и ВУ, значения
0 — Недействительный/лишение
1 — Действительный
2 — Недостаточно данных/аннулировано
3 — Сервис недоступен/данные не найдены
Поле `comment` дает понятное человеку пояснение: `Valid`, `Invalid`, `Revocation` и так далее. Его можно логировать для разборов и показывать службе поддержки, но в пользовательский интерфейс лучше выводить собственные формулировки — короткие и без технического жаргона.
Отдельная польза для разработчиков: не нужно менять архитектуру. Проверка не требует нового эндпоинта, отдельной очереди или ручного сопоставления ответов из разных систем. Вы добавляете этап в уже существующий `process_info`, а остальное обрабатывается внутри запроса.
Ответ можно использовать синхронно или в асинхронной обработке так же, как другие результаты этапа. Если нужно проверить только паспорт или только ВУ, логика не меняется: источник включается на уровне конкретного документа.
Что мне с этого
СМЭВ лагает, что случается так или иначе со всякой системой, но не обязательно с этим мириться. Проверка через Госуслуги дает второй рабочий канал: когда один источник отвечает медленно или не отвечает вовсе, продукт может не зависеть от него напрямую. В онбординге такая разница особенно заметна: меньше повторных отправок, меньше тикетов «почему проверка висит», меньше брошенных заявок.
Как подключить
Вся необходимая информация по внешним проверкам, и в частности, действительности документов через сайт Госуслуг (` external_integrations `), статусам и форматам ответов доступна в документации к API-сервису “Биорг.Идентификация”.
Включите новую опцию в своем проекте, просто добавив 1 этап в запрос или оставьте заявку в чате, чтобы мы вас проконсультировали.
Обсудите вашу задачу со специалистом — это бесплатно
Нужно автоматически распознавать паспорта РФ или иностранных граждан? Свяжитесь с нашим экспертом Евгением Гусарским, чтобы оценить проект.