Documentation

Documentation

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

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

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

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

Работа с API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Виджеты

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

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

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

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

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

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

Справочник API

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

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

Реестр отправляется в формате CSV по электронной почте, которая указана в вашем договоре с Банком 131. Если вы хотите получать реестры в формате XSLSX или другим способом, например по 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 — возврат успешной выплаты. Только для выплат на российские банковские счета, может вернуться по инициативе банка получателя выплаты. Подробнее

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

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

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