Выплата на счет в российском банке

API позволяет отправлять выплаты самозанятым, ИП, физическим и юридическим лицам на счета в российских банках. Все параметры передаются в открытом виде.

Выплаты на счета юридических лиц доступны только нерезидентам Российской Федерации.

На какие счета можно отправить

Вы можете отправить выплаты только на счета, которые начинаются с этих цифр:

• 40817810
• 42301810
• 42302810
• 42303810
• 42304810
• 42305810
• 42306810
• 42307810
• 40802810
• 40702810 (для счетов юридических лиц).

Если счет начинается с других цифр, выплата не пройдет.

Обязательные параметры для выплаты

Для российских организаций

Название	Тип	Описание
payment_method	PaymentMethod	Платежные данные
type	string	значение: bank_account
bank_account	BankAccountPaymentMethod	Банковский счет
system_type	string	Система банковских переводов. Всегда: ru
ru	BankAccountRU	Объект банковского счета
bik	string	БИК банка получателя
account	string	Банковский счет получателя
full_name	string	ФИО физического лица. В случае выплаты на счет ИП, передается в следующем формате: ИП <ФИО>.
inn	string	ИНН. Необходимо указать при выплатах на счета юридического лица или ИП.
kpp	string	КПП. Необходимо указать при выплатах на счета юридического лица или ИП.
description	string	Назначение выплаты. Как сформировать
participant_details	ParticipantDetails	Сумма
sender	Participant	Данные получателя
account	string	Номер банковского номинального счета, с которого будет осуществляться выплата.
beneficiary_id	string	ИНН бенефициара или выгодоприобретателя. Необходимо указать только при выплатах с номинального счета.
recipient	Participant	Данные получателя
beneficiary_id	string	ИНН бенефициара или выгодоприобретателя. Необходимо указать только при выплатах с номинального счета.
payment_details	PaymentDetails	Информация об операции (тип, описание). Необходимо указать только при выплатах с номинального счета.
type	string	Значение: internal_transfer
amount_details	AmountDetails	Сумма
amount	int	Сумма в копейках. Значение должно быть больше нуля. Если отправляете 100 рублей, нужно передать 10000
currency	string	Код валюты согласно ISO 4217. Регистр не важен. Всегда: rub

Для нерезидентов

Название	Тип	Описание
payment_method	PaymentMethod	Платежные данные
type	string	значение: bank_account
bank_account	BankAccountPaymentMethod	Банковский счет
system_type	string	Система банковских переводов. Всегда: ru
ru	BankAccountRU	Объект банковского счета
bik	string	БИК банка получателя
inn	string	ИНН получателя, 10 цифр для юридических лиц, 12 цифр - для физических. Необходимо указать при выплатах на счета юридических лиц.
kpp	string	KПП получателя, 9 цифр. Необходимо указать при выплатах на счета юридических лиц.
account	string	Банковский счет получателя
full_name	string	ФИО физического лица. В случае выплаты на счет ИП, передается в следующем формате: ИП <ФИО>. При выплате юридическому лицу — наименование юрлица, если предусмотрено договором. Важно: если наименование или ФИО указано некорректно, банк-получатель может отказать в зачислении и деньги вернутся на счет отправителя.
description	string	Назначение выплаты с кодом валютной операции (согласуется с менеджером в Банке 131). Как сформировать
amount_details	AmountDetails	Сумма
amount	int	Сумма в копейках. Значение должно быть больше нуля. Если отправляете 100 рублей, нужно передать 10000
currency	string	Код валюты согласно ISO 4217. Регистр не важен. Всегда: rub
participant_details	ParticipantDetails	Информация об участниках выплаты
sender	Participant	Данные отправителя
full_name	string	Имя. Необходимо указать, если отправитель — физическое лицо.
company_name	string	Название компании. Необходимо указать, если отправитель — юридическое лицо.
address_line	string	Адрес. Важно: страну и город необходимо указать в следующих полях, в данном поле их дублировать не нужно.
country_iso3	string	Страна (ISO-3166-1 alpha-3)
city	string	Город
recipient	Participant	Данные получателя
full_name	string	Имя получателя.

Как формировать назначение выплаты

В назначении выплаты (поле BankAccountRU.description) по российским законам необходимо указывать:

• вид операции (например, оплата услуг);
• основание платежа (например, договор №);
• наименование работ, услуг, товаров;
• облагается НДС или нет.

Если ваша организация зарегистрирована не в России, необходимо добавить код вида валютной операции в следующем формате: {VO<код вида валютной операции>} без отступов и пробелов. Код необходимо согласовать заранее с менеджером в Банке 131.

Назначение выплаты не должно содержать следующие символы: ?, !. Максимальная длина: 210 символов.

Пример назначения выплаты

Перевод средств по договору № 5015553456 Иванов Иван Иванович НДС не облагается

Пример назначения выплаты для нерезидентов

{VO99090} Перевод средств по договору № 5015553456 Иванов Иван Иванович НДС не облагается

Как провести выплату

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

Посмотреть сценарий выплат

Пример запроса для выплаты на счет в банке

curl -X POST \
  https://demo.bank131.ru/api/v1/session/init/payout \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-SIGN: sign' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -d'{
    "payment_method": {
        "type": "bank_account",
        "bank_account": {
            "system_type": "ru",
            "ru": {
                "bik": "044525971",
                "account": "40817810100000270411",
                "full_name": "Иванов Иван Иванович",
                "description": "Перевод средств по договору № 5015553111 Иванов Иван Иванович НДС не облагается"
            }
        }
    },
    "amount_details": {
        "amount": 10000,
        "currency": "rub"
    },
    "metadata": "good"
}'

Пример запроса для выплаты на счет в банке для нерезидентов

curl -X POST \
  https://demo.bank131.ru/api/v1/session/init/payout \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-SIGN: sign' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -d'{
    "payment_method": {
        "type": "bank_account",
        "bank_account": {
            "system_type": "ru",
            "ru": {
                "bik": "044525971",
                "account": "40817810100000270411",
                "full_name": "Иванов Иван Иванович",
                "description": "{VO99090} Перевод средств по договору № 5015553456 Иванов Иван Иванович НДС не облагается"
            }
        }
    },
    "amount_details": {
        "amount": 10000,
        "currency": "rub"
    },
    "metadata": "good"
    "participant_details": {
        "sender": {
            "full_name": "Иванов Иван Иванович",
            "address_line": "123 Main Street"
            "country_iso3": "USA"
            "city": "New York"            
        }
        "recipient": {
            "full_name": "Иванов Иван Иванович"
        }
     }
}'

Срочные выплаты на счета в российских банках (через БЭСП)

Вы можете проводить срочные выплаты на счета в российских банках — через систему БЭСП. Срочная выплата проходит в течение часа, обычная — от 2 часов до 1 банковского дня (срок зачисления зависит от банка получателя).

Тарифы за проведение обычных и срочных выплат отличаются и фиксируются в договоре с Банком 131.

Как подключить

Заключите договор с Банком 131 на проведение выплат, скажите, что хотите проводить выплаты через БЭСП. Если договор уже есть, а выплат через БЭСП в нем нет, напишите нашему менеджеру.

Как провести выплату через БЭСП

В запросе на выплату в объекте BankAccountRU в поле is_fast передайте значение true — ваша выплата отправится через БЭСП.

Если не укажете этот параметр, отправится обычная выплата.

Пример объекта с выплатой через БЭСП

"bank_account": {
    "system_type": "ru",
    "ru": {
        "bik": "044525971",
        "account": "40817810100000270411",
        "full_name": "Иванов Иван Иванович",
        "description": "Перевод средств по договору № 5015553111 Иванов Иван Иванович НДС не облагается",
        "is_fast": "true"
    }
}

Что может пойти не так

• Если вы отправите выплату способом, которого нет в вашем договоре с Банком 131, выплата не пройдет. В ответе придет ошибка routing_internal_error.
• Если вы отправите срочную выплату в банк, который не подключен к системе БЭСП, выплата отправится как обычно, но Банк возьмет комиссию за срочную выплату.

Возврат выплаты

Выплата, которую вы отправили на счет в российском банке, может вернуться. В этом случае в течение 5 дней вам придет возврат.

Подробнее о возврате выплаты