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

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

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

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

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

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