Получить результат проверки паспорта в СМЭВ 3.0

GET

https://business.tinkoff.ru/openapi/api/v1/individual/documents/passport-check-smev/status

Метод для получения статуса или результата проверки. Вы передаёте requestID, который получили через метод POST, и в ответе получаете статус проверки заявки.

Общие рекомендации:

Нет ограничения количества запросов на проверку заявки.
Выполняйте запрос на проверку каждой заявки не чаще 1 раза в 3 секунды.
Создавать новую заявку, пока не получен ответ по старой, не нужно — банк вернёт вам requestId уже активной заявки. Это механизм защиты от перегрузки.

Из статуса IN_PROGRESS заявка перейдёт в VALID/INVALID или по истечении внутреннего таймаута (5 минут) get status с этим requestID начнёт возвращать NOT FOUND.

Авторизация

Security

Bearer API Token

RPS

Ограничение — 20 запросов в секунду

Scopes

opensme/individual/passport-check-smev

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Query parameters

Required

requestId

String<uuid>

Идентификатор, полученный в результате выполнения POST-запроса.

Ответ

200

Запрос найден, статус получен

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Запрос на проверку не найден

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции