Documentation

Documentation

  • API Банка 131
  • Languages iconРусский
    • English

›Способы получения выплат

Документация

  • Возможности API
  • С чего начать

Работа с API

  • Формат работы
  • Библиотеки
  • Тестирование
  • История изменений

Массовые выплаты

  • Возможности
  • Как всё работает
  • Сценарии выплат
  • Возвраты выплат
  • Самозанятые

    • Выплаты самозанятым
    • Привязка самозанятого
    • Фискализация без выплаты

    Способы получения выплат

    • На российскую банковскую карту
    • На счет в российском банке
    • В кошелек QIWI
    • В кошелек ЮMoney (Яндекс.Деньги)
    • В налоговую
    • Через СБП по номеру телефона

    Выплаты по шагам

    • Выплата на карту с виджетом
    • Выплата с номинального счета
    • Выплата одним запросом
    • Выплата на карту с PCI DSS
    • Выплата самозанятому с фискализацией

Прием платежей

  • Возможности
  • Процесс платежа
  • Платеж банковской картой
  • Платежи с холдированием
  • Возвраты
  • Рекуррентные платежи
  • Платежи через СБП по QR-коду
  • Платежи через Телеграм

    • Как создать платежного бота
    • Как подключить платежного бота
    • Как настроить платежного бота

    Сплит-платежи

    • Варианты и возможности
    • Сплит-платежи без доработок
    • Сплит-платежи по API

    Платежи по шагам

    • Оплата через платежную форму
    • Оплата с PCI DSS
    • Платеж одним запросом

Виджеты

  • Виджет для токенизации карты
  • Виджет платежной формы
  • Виджет для привязки самозанятого

Проверка паспорта

  • Возможности
  • Взаимодействие
  • Методы

    • Проверка паспорта
    • Статус проверки
  • Ответы и ошибки

Акты и реестры

  • Реестр выплат
  • Реестр платежей
  • Акт

Справочник API

  • Объекты
  • Методы
  • Вебхуки
  • Коды ошибок

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

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

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

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

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

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

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

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

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

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

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

НазваниеТипОписание
payment_methodPaymentMethodПлатежные данные
typestringзначение: bank_account
bank_accountBankAccountPaymentMethodБанковский счет
system_typestringСистема банковских переводов. Всегда: ru
ruBankAccountRUОбъект банковского счета
bikstringБИК банка получателя
innstringИНН получателя, 10 цифр для юридических лиц, 12 цифр - для физических. Необходимо указать при выплатах на счета юридических лиц.
kppstringKПП получателя, 9 цифр. Необходимо указать при выплатах на счета юридических лиц.
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) по российским законам необходимо указывать:

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

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

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

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

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

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

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

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

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

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

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

cURL
cURL
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 дней вам придет возврат.

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

← На российскую банковскую картуВ кошелек QIWI →
  • На какие счета можно отправить
  • Обязательные параметры для выплаты
    • Для российских организаций
    • Для нерезидентов
    • Как формировать назначение выплаты
  • Как провести выплату
  • Срочные выплаты на счета в российских банках (через БЭСП)
    • Как подключить
    • Как провести выплату через БЭСП
  • Возврат выплаты
Documentation
Документация
Массовые выплатыПрием платежейСправочник APIЮридические документы
Сценарии по шагам
Выплата на карту с токеномВыплата на карту с PCI DSSВыплата самозанятомуОплата через платежную форму
Напишите нам
Предложения и идеи — partners@131.ruПресса — press@131.ru
© 2022 Банк 131