Documentation

Documentation

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

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

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

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

Работа с API

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

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

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

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

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

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

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

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

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

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

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

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

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

Виджеты

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

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

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

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

Самозанятые

  • Общая информация
  • Привязка
  • Проверка привязки
  • Проверка данных
  • Оповещения из ФНС
  • Начисления и бонусы

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

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

Справочник API

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

Ежедневный реестр выплат

Реестр отправляется в формате CSV по электронной почте, которая указана в вашем договоре с Банком 131. Если вы хотите получать реестры в формате XLSX или другим способом, например по SFTP, свяжитесь с менеджером Банка 131.

Как использовать реестр

В реестре Банк 131 присылает перечень всех успешных операций за сутки. Вам необходимо проводить сверку операций на вашей стороне с теми, что есть в реестре, чтобы найти ошибочные.

Если на вашей стороне операция помечена как успешная, а в реестре ее нет, вам необходимо повторить запрос.

Если на вашей стороне операция значится неуспешной, а в реестре она есть, вам больше не нужно пытаться ее провести.

Реестр — это финансовый документ. Если вы считаете, что получили реестр с ошибкой, обязательно сообщите своему менеджеру в Банке 131. Срок, в который можно вносить исправления, указан в вашем договоре с Банком.

Название файла с реестром

<Project name>_ГГГГ-ММ-ДД-ГГГГ-ММ-ДД

Поля в реестре

№Название поляФорматОписаниеПример
1operationIdstringИдентификатор платежа в Банке 13121
2transactionDatestring (дата в формате YYYY-MM-DD H:I:S)Время создания платежа на стороне Банка 1312019-06-21 23:17:55
3finishedAtstring (дата в формате YYYY-MM-DD H:I:S)Время завершения платежа на стороне Банка 1312019-06-21 23:17:56
4typeOfPaymentstringТип транзакции. Возможные варианты: Advice — выплата, Refund — возврат выплаты. ПодробнееAdvice
5paymentFastintТип выплаты. 0 — обычная выплата, 1 — срочная выплата через БЭСП (только для выплат на российские банковские счета)1
6paymentSessionIdstringИдентификатор платежной сессии23
7contractstringНомер вашего договора с Банком 131100-C-000000
8paymentSessionMerchantMetadatastringВаши дополнительные данные, которые вы передавали в запросе на операцию{"test_data":"test"}
9paymentMethodIdentitystringПлатежное средство (маскированный номер карты, номер счета)420080******8800
10productstringИдентификатор продукта или услуги по договору с Банком 131new_test_payouts
11grossLocalAmountdecimalСумма, на которую оказывается услуга (полная сумма)110
12paymentLocalAmountdecimalСумма платежа (запроса)100
13feesLocalAmountdecimalВознаграждение Банка 131 (grossLocalAmount - paymentLocalAmount)10
14currencystringТрехбуквенный код валюты (ISO)RUB
15receiptstringСсылка на чек. Необязательное поле, по умолчанию не добавляется!https://lknpd.nalog.ru/api/v1/receipt/220704837033/205ldfqqhc/print
16rrnstringRRN (Retrieval reference number) — уникальный идентификатор транзакции в банке12345678
 

Типы выплаты (typeOfPayment)

  • Advice — успешная выплата.
  • Refund — возврат успешной выплаты. Только для выплат на российские банковские счета, может вернуться по инициативе банка получателя выплаты. Подробнее

Особенности отправки реестра

При необходимости, Банк 131 также может отправить вам реестр одним из следующих способов:

  • несколькими файлами в формате CSV или XLSX (файл CSV или XLSX, разбитый на части);
  • единым файлом архива ZIP (архивированный файл CSV или XLSX);
  • несколькими файлами ZIP (архивированный файл CSV или XLSX, разбитый на части).

Услуга может быть полезна, например, в том случае, если ваш почтовый сервер не принимает файлы больше определеного объема. Если для вас это актуально, напишите запрос вашему менеджеру в Банке 131.

При большом объеме отправляемых данных Банк 131 может самостоятельно принять решение об отправке реестра по частям и/или в архивированном виде.

Разбивка реестра на части производится по количеству транзакций.

Пример разбивки реестра на части

payout_monthly_2023-02-01-2023-03-01_part_1_of_3.csv
payout_monthly_2023-02-01-2023-03-01_part_2_of_3.csv
payout_monthly_2023-02-01-2023-03-01_part_3_of_3.csv

Пример реестра

Скачать пример реестра

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