Выплата на счет в российском банке
API позволяет отправлять выплаты физлицам и самозанятым на счета в российских банках. Все параметры передаются в открытом виде.
Обязательные параметры для выплаты
Для российских организаций
Название | Тип | Описание |
---|---|---|
payment_method | PaymentMethod | Платежные данные |
type | string | значение: bank_account |
bank_account | BankAccountPaymentMethod | Банковский счет |
system_type | string | Система банковских переводов. Всегда: ru |
ru | BankAccountRU | Объект банковского счета |
bik | string | БИК банка получателя |
account | string | Банковский счет получателя |
full_name | string | ФИО получателя |
description | string | Назначение выплаты. Как сформировать |
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 | БИК банка получателя |
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
) по российским законам
необходимо указывать:
- вид операции (например, оплата услуг);
- основание платежа (например, договор №);
- наименование работ, услуг, товаров;
- облагается НДС или нет.
Если ваша организация зарегистрирована не в России, необходимо добавить еще код валютной операции (его нужно согласовать заранее с менеджером в Банке 131).
Пример назначения выплаты
Перевод средств по договору № 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"
}'
Срочные выплаты на счета в российских банках (через БЭСП)
Вы можете проводить срочные выплаты на счета в российских банках — через систему БЭСП. Срочная выплата проходит в течение часа, обычная — от 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 дней вам придет возврат.