Просмотр и статус

Методы этого раздела помогают найти бенефициара, посмотреть его данные и управлять активностью.

Список бенефициаров

Метод list_beneficiary возвращает бенефициаров по фильтрам — по ИНН, активности, типу, номинальному счёту. Поля метода — в разделе Список бенефициаров.

Тип бенефициара в фильтре legal_type задаётся так: F — физлицо, I — ИП, J — юрлицо. Метод можно вызывать не чаще одного раза в 5 минут с одинаковыми параметрами.

Возможные ошибки

Метод возвращает список по фильтрам и специфичных ошибок не имеет. Общий формат ошибок описан в разделе Формат логических ошибок.

Информация по бенефициару

Метод get_beneficiary возвращает информацию о бенефициаре, которую вы передали при регистрации: ИНН, тип, номинальный счёт, последний загруженный договор оферты и разрешение на операции. Поля метода — в разделе Информация по бенефициару.

Отдельно стоит поле is_added_to_ms — оно показывает, создан ли бенефициар в мастер-системе банка. Загружать документы можно только после того, как оно станет true. Поле permission говорит, разрешены ли бенефициару операции, а permission_description — причину запрета, если операции запрещены. Метод можно вызывать не чаще одного раза в 5 минут по одному бенефициару.

Возможные ошибки

Код	Текст
4409	Not found beneficiary

Деактивация бенефициара

Метод deactivate_beneficiary деактивирует бенефициара — после этого он не может участвовать в сделках. Поля метода — в разделе Деактивировать бенефициара.

Деактивировать бенефициара можно, только если на его виртуальных счетах нет денег. Иначе вернётся ошибка 4416.

Возможные ошибки

Код	Текст
4409	Not found beneficiary
4416	On the virtual accounts of the beneficiary of the positive balance
4953	Beneficiary already in upgrading state
4955	Beneficiary already deactivated

Активация бенефициара

Метод activate_beneficiary возвращает бенефициара в активное состояние. Поля метода — в разделе Активировать бенефициара.

Инфо

Активировать деактивированного бенефициара можно только через 24 часа после деактивации.

Возможные ошибки

Код	Текст	Meta
4409	Not found beneficiary	—
4953	Beneficiary already in upgrading state	—
4954	Beneficiary already activated	—
4963	Beneficiary activation is not allowed after deactivation	Activation available after: 2020-07-09T15:00:00+03:00

Поле meta в ошибке 4963 показывает, с какого момента бенефициара можно активировать. Пример ответа с этой ошибкой:

{
    "jsonrpc": "2.0",
    "error": {
        "code": 4963,
        "message": "Beneficiary activation is not allowed after deactivation",
        "meta": "Activation available after: 2020-07-09T15:00:00+03:00"
    },
    "id": "0d6a26ea-84f0-4be2-9999-b46edc9b59b6"
}