Перейти к основному содержимому

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

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

к сведению

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

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

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

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

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

Параметры для выплаты​

НазваниеОбязательностьТипОписание
payment_method+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

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

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

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

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

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

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

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

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

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

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

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

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"
}'

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

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

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

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

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

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

В запросе на выплату в объекте ru в поле 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 дней вам придет возврат.

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