Documentation

Documentation

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

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

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

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

Работа с API

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

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

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

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

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

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

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

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

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

  • Возможности
  • Процесс платежа
  • Платеж банковской картой
  • Платежи с холдированием
  • Возвраты
  • Рекуррентные платежи
  • Интеграция с Google Pay™
  • Сплит-платежи

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

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

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

Виджеты

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

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

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

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

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

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

Справочник API

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

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

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

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

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

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

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

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

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

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

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

№Название поляПримерОписаниеДлина поля
1ЗаголовокPayment register 100-C-000000, (ООО "Самый лучший сайт") from 11.01.2020 to 12.01.2020Payment register <номер договора>, (<Название компании>) from ДД.ММ.ГГГГ to ДД.ММ.ГГГГ-
2ID27291237020Идентификатор платежа в Банке 13115-32
3paymentSessionId23Идентификатор платежной сессии0-100
4Contract100-C-000000Номер вашего договора с Банком 1316-100
5Project nameacquiring_cardНазвание вашего проекта на стороне Банка 1312-100
6Type of paymentAdviceТип платежа. Возможные варианты: Adjustment, Advice, Refund, Chargeback, Сompensation, Recurrent. Подробнее10-16
7Amount110Сумма операции в рублях1-12
8Settlement-2Сумма возмещения, которую Банк должен вам перечислить. Сумма возмещения может быть отрицательной, к примеру по операциям Refund или Chargeback1-12
9Fee-2Сумма комиссии Банка 131 (согласно договору). Указывается в отрицательном значении1-12
10Transaction Date and Time11.01.2020 00:00:08Дата и время транзакции на стороне Банка 13119
11Card number4...1878Маскированный номер карты, по которому был совершен платеж9-19
12rrn12345678RRN (Retrieval reference number) — уникальный идентификатор транзакции в банке12
13paymentSessionMerchantMetadata1Di732vw57Ваши дополнительные данные, которые вы передавали в запросе на операцию6-20
 

Типы платежа (Type of payment)

  • Adjustment — частичная отмена транзакции
  • Advice — успешная транзакция
  • Refund — возврат успешной транзакции
  • Chargeback — оспоренная транзакция
  • Сompensation — возмещение. Сумма такого платежа может быть отрицательной. Например, если сумма Refund или Chargeback будет больше суммы Advice.
  • Recurrent — рекуррентный платеж (автоплатеж или повтор платежа)

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

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

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