Ежедневный реестр выплат
Реестр отправляется в формате CSV по электронной почте, которая указана в вашем договоре с Банком 131. Если вы хотите получать реестры в формате XLSX или другим способом, например по SFTP, свяжитесь с менеджером Банка 131.
Как использовать реестр
В реестре Банк 131 присылает перечень всех успешных операций за сутки. Вам необходимо проводить сверку операций на вашей стороне с теми, что есть в реестре, чтобы найти ошибочные.
Если на вашей стороне операция помечена как успешная, а в реестре ее нет, вам необходимо повторить запрос.
Если на вашей стороне операция значится неуспешной, а в реестре она есть, вам больше не нужно пытаться ее провести.
Реестр — это финансовый документ. Если вы считаете, что получили реестр с ошибкой, обязательно сообщите своему менеджеру в Банке 131. Срок, в который можно вносить исправления, указан в вашем договоре с Банком.
Название файла с реестром
<Project name>_ГГГГ-ММ-ДД-ГГГГ-ММ-ДД
Поля в реестре
| № | Название поля | Формат | Описание | Пример |
|---|---|---|---|---|
| 1 | operationId | string | Идентификатор платежа в Банке 131 | 21 |
| 2 | transactionDate | string (дата в формате YYYY-MM-DD H:I:S) | Время создания платежа на стороне Банка 131 | 2019-06-21 23:17:55 |
| 3 | finishedAt | string (дата в формате YYYY-MM-DD H:I:S) | Время завершения платежа на стороне Банка 131 | 2019-06-21 23:17:56 |
| 4 | typeOfPayment | string | Тип транзакции. Возможные варианты: Advice — выплата, Refund — возврат выплаты. Подробнее | Advice |
| 5 | paymentFast | int | Тип выплаты. 0 — обычная выплата, 1 — срочная выплата через БЭСП (только для выплат на российские банковские счета) | 1 |
| 6 | paymentSessionId | string | Идентификатор платежной сессии | 23 |
| 7 | contract | string | Номер вашего договора с Банком 131 | 100-C-000000 |
| 8 | paymentSessionMerchantMetadata | string | Ваши дополнительные данные, которые вы передавали в запросе на операцию | {"test_data":"test"} |
| 9 | paymentMethodIdentity | string | Платежное средство (маскированный номер карты, номер счета) | 420080******8800 |
| 10 | product | string | Идентификатор продукта или услуги по договору с Банком 131 | new_test_payouts |
| 11 | grossLocalAmount | decimal | Сумма, на которую оказывается услуга (полная сумма) | 110 |
| 12 | paymentLocalAmount | decimal | Сумма платежа (запроса) | 100 |
| 13 | feesLocalAmount | decimal | Вознаграждение Банка 131 (grossLocalAmount - paymentLocalAmount) | 10 |
| 14 | currency | string | Трехбуквенный код валюты (ISO) | RUB |
| 15 | receipt | string | Ссылка на чек. Необязательное поле, по умолчанию не добавляется! | https://lknpd.nalog.ru/api/v1/receipt/220704837033/205ldfqqhc/print |
| 16 | rrn | string | RRN (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