Documentation

Documentation

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

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

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

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

Работа с API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Виджеты

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

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

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

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

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

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

Справочник API

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

Налоги: НДС или «Налог на Google»

С помощью Банка 131 можно платить налоги, пока — только «налог на Google». Это НДС для иностранных компаний, которые оказывают электронные услуги покупателям из России.

Деньги отправятся в налоговую по этим реквизитам:

БИК: 004525988
Номер казначейского счета: 03100643000000017300
Номер единого казначейского счета: 40102810545370000003
Получатель: УФК по г.Москве (Межрегиональная инспекция ФНС России по крупнейшим налогоплательщикам №7)
ИНН получателя: 7707500730
КПП получателя: 770701001

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

Сообщите менеджеру в Банке 131, что хотите платить «налог на Google» — договоримся об удобной схеме работы и составим договор.

Схемы работы

С автоматическим отчислением

Эта схема подходит, если вы принимаете платежи с помощью Банка 131 и хотите платить налоги с полученной суммы.

В этом случае Банк будет откладывать деньги с каждого принятого платежа — ровно столько, сколько нужно для налога. В тот момент, когда нужно будет платить налог, деньги уже будут на счете обеспечения.

Проверить, сколько денег на счете, можно с помощью метода wallet/balance.

С пополнением счета обеспечения

По этой схеме работают обычные выплаты: вы передаете Банку 131 обеспечительный платеж, после этого Банк выполняет ваши распоряжения на платежи в налоговую.

Подробнее об этой схеме

Как заплатить налог

Есть два способа: использовать специальный метод или отправить обычную выплату с параметрами для налоговой.

Способ 1. Метод alias/ru_vat_lite

Отправьте запрос на выплату alias/ru_vat_lite. Укажите период, за который платите налог, и сумму в копейках. Выплата отправится в налоговую.

Способ 2. Обычная выплата с параметрами для налоговой

Отправьте запрос session/init/payout.

Передайте:

  • в поле payment_method.type— значение tax;
  • в поле tax.type— значение tax_short (пока есть только такой вариант, скоро их будет больше);
  • в поле tax_details.period — период, за который платите налог;
  • в amount_details.amount — сумму налога в копейках.

Обязательные параметры для платежей в налоговую

НазваниеТипОписание
payment_methodPaymentMethodПлатежные данные
typestringЗначение: tax
taxTaxPaymentMethodОбъект с данными для уплаты налогов
typestringТип или способ уплаты налога. Варианты: tax_short
tax_shortTaxShortОбъект с данными для уплаты налога с минимальным набором полей
tax_detailsTaxDetailsДанные для выплат в налоговую
periodTaxPeriodОбъект с описанием периода, за который нужно заплатить налог
typestringТип периода. Варианты: month (налог за месяц), quarter (налог за квартал)
numbernumberЗависит от типа периода. Для month — номер месяца (от 1 до 12), для quarter — номер квартала (от 1 до 4)
yearstringГод, 4 цифры. Пример: 2021
amount_detailsAmountDetailsСумма
amountintСумма в копейках. Значение должно быть больше нуля. Если отправляете 100 рублей, нужно передать 10000
currencystringКод валюты согласно ISO 4217. Регистр не важен. Всегда: rub

Пример запроса

cURL
curl --location --request POST 'https://demo.bank131.ru/api/v1/session/init/payout' \
--header 'Content-Type: application/json' \
--header 'X-PARTNER-SIGN: sign' \
--header 'X-PARTNER-PROJECT: project' \
--data-raw '{
"amount_details": {
"amount": 20000,
"currency": "rub"
},
"payment_method": {
"type": "tax",
"tax": {
"type": "tax_short",
"tax_short": {
"tax_details": {
"period": {
"type": "quarter",
"number": 4,
"year": "2020"
}
}
}
}
}
}'

Пример успешного ответа

{
    "status": "ok",
    "session": {
        "id": "ps_2909",
        "status": "in_progress",
        "created_at": "2018-05-27T03:02:00.935351Z",
        "updated_at": "2018-05-27T03:02:00.935351Z",
        "payments": [
            {
                "id": "po_3230",
                "status": "in_progress",
                "created_at": "2018-05-27T03:02:00.935351Z",
                "payment_method": {
                    "type": "tax",
                    "tax": {
                        "type": "tax_short",
                        "tax_short": {
                            "tax_details": {
                                "period": {
                                    "type": "quarter",
                                    "number": 4,
                                    "year": "2020"
                                }
                            }
                        }
                    }
                },
                "amount_details": {
                    "amount": 20000,
                    "currency": "rub"
                }
            }
        ]
    }
}

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