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

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

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

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

НазваниеТипОписание
payment_methodPaymentMethodПлатежные данные
typestringзначение: bank_account
bank_accountBankAccountPaymentMethodБанковский счет
system_typestringСистема банковских переводов. Всегда: ru
ruBankAccountRUОбъект банковского счета
bikstringБИК банка получателя
accountstringБанковский счет получателя
full_namestringФИО получателя
descriptionstringНазначение выплаты. Как сформировать
amount_detailsAmountDetailsСумма
amountintСумма в копейках. Значение должно быть больше нуля. Если отправляете 100 рублей, нужно передать 10000
currencystringКод валюты согласно ISO 4217. Регистр не важен. Всегда: rub

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

НазваниеТипОписание
payment_methodPaymentMethodПлатежные данные
typestringзначение: bank_account
bank_accountBankAccountPaymentMethodБанковский счет
system_typestringСистема банковских переводов. Всегда: ru
ruBankAccountRUОбъект банковского счета
bikstringБИК банка получателя
accountstringБанковский счет получателя
full_namestringФИО получателя
descriptionstringНазначение выплаты с кодом валютной операции (согласуется с менеджером в Банке 131). Как сформировать
amount_detailsAmountDetailsСумма
amountintСумма в копейках. Значение должно быть больше нуля. Если отправляете 100 рублей, нужно передать 10000
currencystringКод валюты согласно ISO 4217. Регистр не важен. Всегда: rub
participant_detailsParticipantDetailsИнформация об участниках выплаты
senderParticipantДанные отправителя
full_namestringИмя
company_namestringНазвание компании
address_linestringАдрес
country_iso3stringСтрана (ISO-3166-1 alpha-3)
citystringГород
recipientParticipantДанные получателя
full_namestringИмя получателя
 

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

В назначении выплаты (поле 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 дней вам придет возврат.

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

← На иностранную картуНа счет в украинском банке →