Получить результаты проверки бенефициаров в финансовом мониторинге

GET

https://secured-openapi.tbank.ru/api/v2/nominal-accounts/beneficiaries/scoring

Возвращает информацию о результатах проверки бенефициаров в финансовом мониторинге:

Для ФЛ резидентов (FL_RESIDENT) — корректность паспортных данных, действительность паспорта и проверка по чёрным спискам.
Для ИП резидентов (IP_RESIDENT) — корректность паспортных данных, действительность паспорта и проверка в ЕГРЮЛ.
Для ИП нерезидентов (IP_NONRESIDENT) — проверка в ЕГРЮЛ.
Для ЮЛ резидентов (UL_RESIDENT) — проверка в ЕГРЮЛ.

Список возможных кодов непройденных проверок:

INVALID_INN — не пройдена проверка на корректность паспортных данных бенефициара.
INVALID_PASSPORT — не пройдена проверка на действительность паспорта бенефициара.
IN_BLACKLIST — бенефициар найден в чёрных списках.
UL_CLOSED, UL_NOT_FOUND — не пройдена проверка бенефициара в ЕГРЮЛ.

Критичные проверки

INVALID_INN
INVALID_PASSPORT
UL_CLOSED
UL_NOT_FOUND

Коды всех непройденных критичных проверок вернутся в массиве errors.

⚠️ Если не пройдена хотя бы одна критичная проверка, итоговый статус будет FAILED.

Выплата с участием такого бенефициара через метод Завершить этап сделки или через метод Выполнить платеж в пользу бенефициара на реальный счёт не сможет завершиться успешно, потому что такое лицо не может быть бенефициаром по номинальному счёту.

Некритичные проверки

IN_BLACKLIST

Коды всех непройденных некритичных проверок вернутся в массиве warnings.

⚠️ Непрохождение некритичных проверок не влияет на выплаты бенефициарам.

Ограничение на использование метода — 10 запросов в секунду.

Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage — Управление номинальными счетами.

Авторизация

Security

Bearer API Token

MTLS-сертификат

Query parameters

beneficiaryId

String<uuid>

Идентификатор бенефициара, по которому необходимо вернуть результаты проверки. Если вы не передаёте параметр, возвращаются результаты по всем бенефициарам.

passed

Boolean

Фильтр по результату проверки (прошёл/не прошёл).

offset

Integer<int32>

Количество результатов проверки, которое нужно пропустить. Значение по умолчанию — 0.

limit

Integer<int32>

Количество результатов проверки, которое нужно вывести. Значение по умолчанию — 50.

Ответ

200

400

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

401

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

403

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

422

Ошибка при обработке данных

429

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

500

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

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

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

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