Daily payouts report
The daily report is sent in CSV format to the e-mail address specified in your agreement with Bank 131. If you wish to receive the reports in the XLSX or in a different way, for example, via SFTP, please contact your Bank 131 manager.
How to use the report
The report sent by Bank 131 contains a list of all successful operations for the full day (24 hours). You need to check operations on your side against those in the report to reveal any possible errors.
If an operation is marked as successful on your side but it does not appear in the report, you need to repeat the request.
If an operation is marked as unsuccessful on your side but it does appear in the report, you can stop trying to perform it.
The report is a financial document. If you believe that the report you received contains mistakes, make sure to contact your Bank 131 manager. The timeframe for making corrections is specified in your agreement with the Bank.
Report file name
<Project name>_YYYY-MM-DD_YYYY-MM-DD
Report fields
№ | Field name | Format | Description | Example |
---|---|---|---|---|
1 | operationId | string | Bank 131 payment identifier | 21 |
2 | transactionDate | string (date in the following format: YYYY-MM-DD H:I:S) | The time of payment creation on Bank 131's side | 2019-06-21 23:17:55 |
3 | finishedAt | string (date in the following format: YYYY-MM-DD H:I:S) | The time of payment completion on Bank 131's side | 2019-06-21 23:17:56 |
4 | typeOfPayment | string | Transaction type. Options: Advice is a payout; Refund is a refund. More details | Advice |
5 | paymentFast | int | Payout type. 0 — is a regular payout, 1 — is a fast payout via the BESP system (only for payouts to Russian bank accounts). | 1 |
6 | paymentSessionId | string | Payment session identifier | 23 |
7 | contract | string | The number of your contract with Bank 131 | 100-C-000000 |
8 | paymentSessionMerchantMetadata | string | Your additional data that you passed within the request for the operation | {"test_data":"test"} |
9 | paymentMethodIdentity | string | The payment instrument (masked card number, account number) | 420080******8800 |
10 | product | string | The product or service identifier according to the agreement with Bank 131 | new_test_payouts |
11 | grossLocalAmount | decimal | The sum of money for which the service is provided (total) | 110 |
12 | paymentLocalAmount | decimal | The sum of the payment (request) | 100 |
13 | feesLocalAmount | decimal | Bank 131's fee (grossLocalAmount - paymentLocalAmount ) | 10 |
14 | currency | string | The three-letter currency code (ISO) | RUB |
15 | receipt | string | Online receipt. Optional field, not included by default. | https://lknpd.nalog.ru/api/v1/receipt/220704837033/205ldfqqhc/print |
16 | rrn | string | Retrieval Reference Number: the unique identifier of a bank transaction | 12345678 |
Payout types (typeOfPayment)
Advice
is a successful payout.Refund
is a refund of a successful payout. Only for payouts to Russian bank accounts. Can be refunded upon request of the payout recipient's bank. More details
How to receive large report files
In case of large amount of data, Bank 131 is able to send report files with one of the methods below:
- CSV or XLSX file split into parts in CSV or XLSX format.
- single ZIP archive file (CSV or XLSX file archived).
- ZIP archive file split into parts (CSV or XLSX file archived and then split into parts).
This can help to deal with the issues when your email server cannot process a single email file with a size larger than specified. To know more about this service, please contact your manager at Bank 131.
In some cases, Bank 131 can split and/or archive reports based on their own business and/or operational needs.
You can specify the number of transactions you want to receive in each part of a report to split the report file in accordance with that number.
Example of split report
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