Выплаты по номеру счета
Здесь описан сценарий, при котором данные передаются в открытом виде. Вы можете отправлять деньги на счет двумя способами:
- срочной выплатой через систему БЭСП — деньги зачисляются в течение 1 часа. Чтобы подключить БЭСП, обратитесь к персональному менеджеру в Банке 131;
- обычной выплатой — деньги зачисляются от 2 часов до 1 банковского дня (зависит от банка получателя).
Тарифы за проведение срочных и обычных выплат отличаются и фиксируются в договоре с Банком 131.
Счета для выплат
Выплаты можно отправлять только на банковские счета, которые начинаются с этих цифр:
- 40817810
- 42301810
- 42302810
- 42303810
- 42304810
- 42305810
- 42306810
- 42307810
- 40802810
- 40820810
- 40702810 (для юридических лиц)
Параметры выплат
- Для резидентов
- Для нерезидентов
| Название | Обязательность | Тип | Описание |
|---|---|---|---|
| payment_method/payout_details | + | object | Платежные данные |
| type | + | string | Значение: bank_account |
| bank_account | + | object | Банковский счет |
| system_type | + | string | Система банковских переводов. Всегда: ru |
| ru | + | object | Объект банковского счета |
| bik | + | string | БИК банка получателя |
| account | + | string | Банковский счет получателя |
| full_name | + | string | ФИО физического лица. В случае выплаты на счет ИП, передается в следующем формате: ИП <ФИО> |
| inn | - (обязательно для выплат на счета юридических лиц или ИП) | string | ИНН |
| kpp | - (обязательно для выплат на счета юридических лиц) | string | КПП |
| description | + | string | Назначение выплаты. Как сформировать |
| participant_details | - (обязательно при выплатах с номинального счета) | object | Информация об участниках выплаты |
| sender | + | object | Данные отправителя |
| account | + | string | Номер банковского номинального счета, с которого будет осуществляться выплата |
| beneficiary_id | + | string | ИНН бенефициара или выгодоприобретателя |
| recipient | + | object | Данные получателя |
| beneficiary_id | + | string | ИНН бенефициара или выгодоприобретателя |
| payment_details | - (обязательно при выплатах с номинального счета) | object | Информация об операции (тип, описание) |
| type | + | string | Значение: internal_transfer |
| amount_details | + | object | Сумма |
| amount | + | int | Сумма в копейках. Значение должно быть больше нуля. Чтобы передать 100 рублей, укажите 10000 |
| currency | + | string | Код валюты согласно ISO 4217. Регистр не важен. Всегда: rub |
| Название | Обязательность | Тип | Описание |
|---|---|---|---|
| payment_method/payout_details | + | object | Платежные данные |
| type | + | string | Значение: bank_account |
| bank_account | + | object | Банковский счет |
| system_type | + | string | Система банковских переводов. Всегда: ru |
| ru | + | object | Объект банковского счета |
| bik | + | string | БИК банка получателя |
| inn | - (обязательно для выплат на счета юридических лиц или ИП) | string | ИНН получателя |
| kpp | - (обязательно для выплат на счета юридических лиц) | string | КПП получателя |
| account | + | string | Банковский счет получателя |
| full_name | + | string | ФИО физического лица. В случае выплаты на счет ИП, передается в следующем формате: ИП <ФИО>. При выплате юридическому лицу — наименование юрлица, если предусмотрено договором. Важно: если наименование или ФИО указано некорректно, банк-получатель может отказать в зачислении и деньги вернутся на счет отправителя |
| description | + | string | Назначение выплаты с кодом валютной операции (согласуется с менеджером в Банке 131). Как сформировать |
| amount_details | + | object | Сумма |
| amount | + | int | Сумма в копейках. Значение должно быть больше нуля. Чтобы передать 100 рублей, укажите 10000 |
| currency | + | string | Код валюты согласно ISO 4217. Регистр не важен. Всегда: rub |
| participant_details | + | object | Информация об участниках выплаты |
| sender | + | object | Данные отправителя |
| full_name | - (обязательно, если отправитель — физическое лицо) | string | Имя |
| company_name | - (обязательно, если отправитель — юридическое лицо) | string | Название компании |
| address_line | + | string | Адрес. Важно: страну и город необходимо указать в следующих полях, в данном поле их дублировать не нужно |
| country_iso3 | + | string | Страна (ISO-3166-1 alpha-3) |
| city | + | string | Город |
| recipient | + | object | Данные получателя |
| full_name | + | string | Имя получателя |
Требования к назначению выплаты
При переводе денег в параметре bank_account.ru.description необходимо указать следующие данные:
- тип операции (например,
оплата услуг); - основание выплаты (например,
по договору № 123); - наименование работ, услуг, товаров;
- облагается НДС или нет.
Если организация или физическое лицо не являются резидентами РФ, в назначении выплаты нужно указать код валютной операции в формате: {VO<код вида валютной операции>}, предварительно согласованный с Банком 131.
Запрещены символы: ?, !.
Максимальная длина текста: 210 символов.
Пример назначения выплаты
- Для резидентов
- Для нерезидентов
Перевод средств по договору № 5015553456 Иванов Иван Иванович НДС не облагается
{VO99090} Перевод средств по договору № 5015553456 Иванов Иван Иванович НДС не облагается
Отправить обычную выплату
Воспользуйтесь общим сценарием выплаты без виджета. Параметры выплаты смотрите в таблице выше.
Чтобы получать уведомления о зачислении денег на счет получателя, нужно подключить вебхук confirmation_payout. Для этого обратитесь к персональному менеджеру в Банке 131. Отправка вебхука не гарантируется Банком 131 и зависит от банка, обслуживающего счет получателя.
Пример обычной выплаты
- Для резидентов
- Для нерезидентов
curl -X POST \
https://demo.bank131.ru/api/v1/session/init/payout \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-SIGN: signature' \
-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: signature' \
-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": "Иванов Иван Иванович"
}
}
}'
Отправить срочную выплату
Воспользуйтесь общим сценарием выплаты без виджета. Параметры выплаты смотрите в таблице выше. Обязательно передайте значение true в параметре is_fast объекта ru, иначе отправится обычная выплата.
Пример объекта с выплатой через БЭСП
{
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "044525971",
"account": "40817810100000270411",
"full_name": "Иванов Иван Иванович",
"description": "Перевод средств по договору № 5015553111 Иванов Иван Иванович НДС не облагается",
"is_fast": "true"
}
}
}
Возможные ошибки
При проведении выплат могут возникать ошибки:
routing_internal_error— выплата не прошла, так как выбранный способ не предусмотрен вашим договором с Банком 131;- если вы отправили срочную выплату в банк, который не подключен к системе БЭСП, выплата будет обработана как обычная, но Банк 131 удержит комиссию за срочность.
Как узнать, что выплата вернулась >