Перейти к основному содержимому

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

/api/v1/individual/documents/passport-check-smev/status

GET

https://business.tbank.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

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

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

Loading...

openapi@tbank.ru

АО «ТБанк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.