Возможности
Когда у платежа есть выгодоприобретатель или бенефициар, Банку 131 требуется проверять получателя платежа — до проведения операции.
Например, если вы работаете с самозанятыми по агентской схеме (самозанятый является вашим выгодоприобретателем, а вы — агентом по приему денег в его пользу) и отправляете им выплаты или сплит-платежи.
Или вы осуществляете расчеты с использованием номинального счета, тогда деньги на этом счете принадлежат бенефициару. Им может быть физическое или юридическое лицо плательщик, или получателем-физическим лицом - зависит от вашей юридической модели. Если вы не знаете, кто бенефициар, обратитесь к своему менеджеру.
Для проверки бенефициаров юридических лиц требуется передать анкету, шаблон анкеты предоставит менеджер.
Для проверки бенифициаров физических лиц необходимо использовать данное АПИ.
Если вы не знаете, требуется ли вам проверять получателей, значит, вам это не нужно.
Как настроить взаимодействие
Взаимодействие с API проходит не так, как обычно: нужно использовать «КриптоПро» для подписи запросов. Это требование закона.
Как провести проверку
Шаг 1. Отправьте запрос на проверку
Отправьте запрос cheсk
с данными физического лица, Банк 131 проверит
данные в СМЭВ.
Вам в ответ придет идентификатор заявки на проверку.
Шаг 2. Проверьте результат
Отправляйте запрос check/{id}
с идентификатором, который пришел на предыдущем шаге.
Результат проверки вернется не сразу: может пройти от 10 минут до 2 суток.
Если всё в порядке (status
— success
), можно отправлять деньги.
Если вы отправите запрос cheсk
с теми же данными (inn
и agent_contract_number
), в ответ на запрос
check/{id}
вернется ошибка (description
— already exists
).
В описании ошибки придет идентификатор предыдущей проверки, по которому можно узнать её статус.
Пример ответа при повторной проверке
{
"status": "error",
"error": {
"code": "already_exists",
"description": "Request with the same data already exists"
}
"data": {
"id": "7" // идентификатор предыдущей проверки
}
}
Как Банк 131 узнает, что данные проверены
При отправке выплаты самозанятому вы указываете ИНН
(в поле tax_reference
).
По этому ИНН Банк 131 сможет понять, что самозанятый прошел проверку.
При отправке выплаты с номинального счета вы указываете ИНН бенефициара (в поле beneficiary_id
), за счет средств которого осуществляется выплата или ИНН бенефициара, которому осуществляется выплата (зависит от вашей юридической схемы). Банк проведет платеж, если бенефициар был успешно проверен.