Изменения

Что изменилось в API, потоке проверки и панели. Сначала новые; несовместимые изменения объявляются здесь заранее.

  1. Новое

    ID-карта: данные лицевой и оборотной сторон сверяются

    Номер документа, ПИНФЛ и дата рождения с лицевой стороны ID-карты теперь считываются и сверяются с данными оборотной стороны. Явное расхождение — DOC_DATA_MISMATCH (RED), если связать стороны не удалось — DOC_FACE_UNBOUND (ON_HOLD, никогда не автоматический GREEN).

    Улучшено

    Direct API: связывание двух сторон ID-карты

    POST /v1/checks/document теперь, как и hosted-поток, связывает лицевую и оборотную стороны. В список RejectLabel в OpenAPI добавлены DOC_FACE_UNBOUND и AML_NO_NAME.

    Новое

    Журнал API-запросов в панели

    Каждый API-запрос виден 30 дней: метод, путь, код ответа, длительность и ключ. Ищите по X-Request-Id (req_…) — ошибку интеграции можно найти без обращения в поддержку. Тела запросов и ответов не сохраняются.

    Новое

    Журнал аудита: фильтры, экспорт CSV и проверка цепочки

    Владельцы и администраторы видят в панели, кто, когда и что сделал. Записи связаны хеш-цепочкой: целостность проверяется одной кнопкой, для аудитора доступна выгрузка CSV.

    Безопасность

    Подпись v2 между сервисами и усиленная защита

    Каждый запрос между частями платформы теперь подписывается подписью v2, покрывающей метод, путь и тело, с отдельным ключом на каждое направление; повторная отправка отклоняется. Панель работает со строгой Content-Security-Policy и HSTS, сессия закрывается через 12 часов.

    Улучшено

    Вебхуки через очередь, справедливо между эндпоинтами

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

    Улучшено

    Лимиты размера изображений и возврат лимита

    Изображение документа ≤ 52 Мп, кадр селфи ≤ 13 Мп, тело запроса ≤ 32 МБ; при превышении — 422 image_too_large или 413 file_too_large. Сессия без результата или с истёкшим сроком не списывается с месячного лимита — резерв возвращается.

  2. Новое

    Direct API: документ, сверка селфи и проверка присутствия по отдельности

    Вызывайте POST /v1/checks/document, /face-match и /liveness из своего приложения с ключом sk_, без hosted-потока. С sandbox-ключами результат имитируется и не входит в лимит.

    Новое

    Усиленная проверка присутствия и дубликаты по документу

    Проверка присутствия усилена; неуверенный результат даёт только LIVENESS_UNCERTAIN (ON_HOLD), никогда RED. Если включено, второй applicant с тем же документом получает DUPLICATE.

    Новое

    API проверки по санкционным спискам

    POST /api/v1/aml/screen ищет имя (и, по желанию, дату рождения) в списках OFAC SDN, ООН и Великобритании. Списки обновляются ежедневно.

    Новое

    kyc.js, переход на телефон по QR и новые события вебхуков

    Встраивайте поток на сайт с помощью kyc.js (0,7 КБ). На компьютере поток показывает QR и продолжается на телефоне. Новые события: session.started и verification.submitted.

    Новое

    Публичная документация API и OpenAPI 3.1

    Полная документация API теперь открыта; исходную спецификацию можно скачать и сгенерировать свой клиент. Также добавлены приглашения в команду с ролями.

Актуальный контракт API всегда в файле OpenAPI и коллекции Postman. OpenAPI · Коллекция Postman

Начните с 100 бесплатных проверок в месяц

Без карты, договор онлайн — подтверждение за 1 минуту. Создайте аккаунт, возьмите тестовый ключ и проведите первую проверку уже сегодня.