YooMoney API
Guides
Old versions of the API
Help
Sign up for YooMoney
Reports for Safe deal
YooMoney generates daily reports about successful transactions (payments, refunds, and transfers of marketplace's remuneration). They’re sent to the email address that you specified in the Documents — Reports section of your YooMoney Merchant Profile. A report contains all transactions carried out on a specific date (within 12:00:00 AM to 11:59:59 PM by Moscow time). If there were no transactions within the specified date, you will receive an empty report.
There are two ways to receive reports: in the email body (default option) and in a CSV format file attached to the email (enabled by request).
When using Safe deal, you'll receive the following reports:
 
Payment reports
Each report contains all the payments that changed to the succeeded status during the reporting period.
Fields in the report
Fields in the reportDescription
Payment identifierUnique identifier of a payment in YooMoney, sent in the id field of the response to a payment  creation request.
Payment amountThe amount paid by the customer is the full payment amount that includes the amount of your marketplace's remuneration and the amount of the payout to the seller. The decimals are separated by the dot, and there are always two digits after the decimal point, no thousands separator.
Payment currencyThree-letter currency code (RUB is the Russian ruble).
Payment amount excluding NBCO's commissionPayment amount excluding YooMoney's commission (the value of income_amount in the successful payment ). The decimals are separated by the dot, and there are always two digits after the decimal point, no thousands separator.
Date and time of paymentTime when the payment was created in the following format: dd.MM.yyyy HH:mm:ss. Example: 18.06.2021 17:46:58
Payment method identityNumber of the YooMoney wallet used for making the payment. Other payment methods are specified by the internal account number on the YooMoney’s side.
DescriptionValue set in the description field, sent in response to a payment creation request .
Payment typeCode of the payment method on YooMoney’s side (not used in requests).
Payer nameFirst name, last name, and middle name of the YooMoney wallet’s owner. Specified only for payments of over 15,000 rubles made via YooMoney wallet.
Payer addressAddress of the YooMoney wallet’s owner. Specified only for payments of over 15,000 rubles made via YooMoney wallet.
TINTaxpayer Identification Number (INN) of the YooMoney wallet’s owner. Specified only for payments of over 15,000 rubles made via YooMoney wallet.
Transfer amountAmount reserved for the payout to the seller. The decimals are separated by the dot, and there are always two digits after the decimal point, no thousands separator.
Marketplace's remuneration before deducting NBCO's remunerationMarketplace's remuneration, the difference between the payment amount and the amount of the payout to the seller. The decimals are separated by the dot, and there are always two digits after the decimal point, no thousands separator.
Report example
DAILY PAYMENT REPORT FOR "Store name" LLC. # 112
Date of payments: 22.06.2020
Payment identifier; Gross payment amount; Payment currency; Payment amount excluding NBCO's commission; Date and time of payment; Payment method identifier; Description; Payment type; Transfer amount; Marketplace's remuneration before deducting NBCO's remuneration

1da5c87d-0984-50e8-a7f3-8de646dd9ec9; 1000.00; RUB; 955.00; 22.06.2021 17:46:58; 410038366898; Payment for order No. 37; AC; 800.00; 200.00
216eea9e-000f-50ef-b000-008f493c0104; 500.00; RUB; 477.50; 22.06.2021 17:47:32; 410038366898; Payment for order No. 72; AC; 400.00; 100.00

Total gross amount of payments accepted: 1500.00 RUB
Total amount of payments less fees: 1432.50 RUB
Number of payments: 2

To: "Store name" LLC

(Under Agent agreement 111.1111.11)
Refund reports
Each report contains all the refunds that changed to the succeeded status during the reporting period.
Fields in the report
Fields in the reportDescription
Refund identifierUnique identifier of a refund in YooMoney, sent in the id field of the response to a refund  creation request.
Payment identifierUnique identifier of the initial payment in YooMoney.
Refund amountTotal refund amount. The decimals are separated by the dot, and there are always two digits after the decimal point, no thousands separator.
Refund currencyThree-letter currency code (RUB is the Russian ruble).
Date and time when the refund was credited to payer’s accountTime when the refund was created in YooMoney in the following format: dd.MM.yyyy HH:mm:ss. Example: 18.06.2021 17:46:58
Payment method identityNumber of the YooMoney wallet used for making the payment. Other payment methods are specified by the internal account number on YooMoney’s side.
Refund amount in product’s currencyRefund amount in product’s currency specified in the store settings.
The amount of the refund of marketplace's remuneration before deducting NBCO's commissionThe amount of marketplace's remuneration to be refunded before deducting YooMoney's commission. The decimals are separated by the dot, and there are always two digits after the decimal point, no thousands separator.
Payment currencyThree-letter currency code (RUB is the Russian ruble).
Payment typeCode of the payment method on YooMoney’s side (not used in requests).
DescriptionValue set in the description field, sent in response to a refund creation request .
Payment descriptionDescription of the payment to be refunded: value of the description field, sent in a payment creation request .
Report example
REFUNDED PAYMENTS FROM "Store name" LLC. # 100
Date of refunds: 22.06.2020

Refund identifier; Payment identifier; Refund amount; Refund currency; Time of refund’s crediting to payer’s account; Payment method identifier; Refund amount in product's currency; The amount of the refund of marketplace's remuneration before deducting NBCO's commission; Payment currency; Payment type; Description; Payment description

20eebe8c-000f-50fb-9000-701173f3f80e; 2182ae34-000f-5000-9000-29e509d1a33b; 200.00; RUB; 22.06.2021 17:46:58; 410038366898; 200.00; 50.00; RUB; AC; Payment for order No. №37; Payment for order No. 37
20eebe8c-000f-50fb-9000-400218bda9f0; 2182ae34-000f-5000-9000-21e24bd05867; 600.75; RUB; 22.06.2021 17:47:32; 410038366898; 600.75; 70.00; RUB; AC; 1235346. Payment correction under agreement No. 0000; Payment for order No. 819

Total amount: 800.75
Number of refunds: 2

To: "Store name" LLC

(Under Agent agreement 111.1111.11)
Reports about marketplace’s remuneration
Each report contains all the transfers of your marketplace's remuneration.
Fields in the report
Fields in the reportDescription
Remuneration IDUnique ID of the remuneration to be transferred. Example: 1da5c87d-0984-50e8-a7f3-8de646dd9ec9
Payment identifierUnique ID of the payment in YooMoney within which the customer paid for the deal. It's provided in the id field of the response when the payment  is created.
Amount of marketplace's remuneration before deducting NBCO's commissionMarketplace's remuneration before deducting YooMoney's commission: the difference between the payment amount and the amount of the payout to the seller. The decimals are separated by the dot, and there are always two digits after the decimal point, no thousands separator.
Amount of marketplace's remuneration after deducting NBCO's commissionAmount transferred to your marketplace by YooMoney. The decimals are separated by the dot, and there are always two digits after the decimal point, no thousands separator.
Remuneration currencyThree-letter code of the currency of the remuneration transferred to you (RUB for the Russian ruble).
NBCO's commissionYooMoney's remuneration in the currency of the payment. The decimals are separated by the dot, and there are always two digits after the decimal point, no thousands separator.
Remuneration timeTime when the remuneration was transferred to you in YooMoney's time zone in the following format: dd.MM.yyyy HH:mm:ss. Example: 18.06.2021 17:46:58
DescriptionYooMoney's field for technical purposes.
Report example
DAILY PLATFORM REMUNERATION REPORT FOR "Store name" LLC. # 123
Date of remunerations: 22.06.2020
Remuneration ID; Payment identifier; Amount of marketplace's remuneration before deducting NBCO's commission; Amount of marketplace's remuneration after deducting NBCO's commission; Remuneration currency; NBCO's commission; Remuneration time; Description

1da5c87d-0984-50e8-a7f3-8de646dd9ec9; 2da5c87d-0984-50e8-a7f3-8de646dd9e10; 200.00; 150.00; RUB; 50.00; 22.06.2021 17:46:58;
216eea9e-000f-50ef-b000-008f493c0104; 316eea9e-000f-50ef-b000-008f493c0111; 70.00; 47.50; RUB; 22.50; 22.06.2021 17:47:32;

Total gross amount of remunerations accepted: 270.00 RUB
Total amount of remunerations less fees: 197.50 RUB
Number of remunerations: 2

To: "Store name" LLC

(Under Agent agreement 111.1111.11)
See also