YooMoney API
Old versions of the API
Help
Sign up for YooMoney
Setting up an online sales register
According to Federal Law No. 54-FZ, you must submit fiscal receipts to the Tax Service each time a payment is made for products, services, or work if you are:
  • an organization (any tax system),
  • a sole proprietor with employees (GTS, STS, unified tax on imputed income, or patent),
  • a sole proprietor without employees selling products made by a third party (GTS, STS, unified tax on imputed income, or patent).
If you need to submit receipts, you can do it using our service or on your own.
 
How to submit receipts via YooMoney
You need to buy or rent an online sales register from one of our partners and set up interaction with our service. In this way, we'll send data for receipts to your online sales register right as each payment is made.
  1. Go to the "Online sales register" section in the Merchant Profile settings and confirm that you need to submit receipts.
  2. To continue setup, you'll need an online sales register. It can be either an online service (if you only work online) or a physical sales register (if you accept payments at a retail outlet). A physical sales register can also be used for online sales if it can send online receipts to customers via internet.
  3. Sign your online sales register up for YooMoney: select it from the drop-down list under Your online sales register and configure the settings.
Parameters for activation
How to configure them for your online sales register:
Kit Invest
ATOL
ModulKassa
Orange Data
Бизнес.Ру
Evotor
aQsi online
Mertrade
Первый-ОФД
Settings for receipts
"Where do you accept payments?": enter the place where the sales register is installed (this information will be printed in the receipt).
  • If you accept payments at a retail outlet, enter its full name (for example: "Borodino" cafe, 3rd floor, section 2, office 52).
  • If you accept payments on a website, enter its URL.
  • If both, enter the name of the store and the URL (for example: "Sanitary ware" store; snthnk.ru).
"Email for errors": enter the email address where you'd like to receive notifications about errors while submitting receipts.
  1. After that, you need to decide how YooMoney should handle payments where the receipt wasn't delivered to the online sales register.
    Accept the payment: first, the payment is processed, then data for the receipt is sent to the online sales register.
    The payment will be processed even if the sales register hasn't responded. However, the receipt might not be submitted: in this case, a notification will be sent to the email address for errors.
    This configuration is suitable for most online stores selling physical products.
    Cancel the payment: first, data for the receipt is sent to your online sales register. Payment is processed after the sales register responds that there are no problems with the receipt.
    If there's no response from the online sales register for 5 minutes (for example, if something happens on provider's side), the payment won't go through and money will be returned to the customer.
    For example, it's suitable for stores selling digital products without delivery.
    Don't link the payment with the receipt: data for receipts is submitted separately from the payment: you control this process on your own using the YooMoney API (it doesn't work under the http).
  2. During the next step, double-check the settings and confirm if everything is correct.
  3. Configure how data for receipts is submitted on your website.
If you configure the integration via the API on your own
Add the parameters for receipts (product names, prices, VAT rates, and information about the customer) to payment requests. Learn more in the documentation
If you implemented YooMoney using the payment module
Update the module, go to its settings, and enable submitting data in accordance with Federal Law No. 54-FZ: learn more in the manual for your module. If there's no such setting in the payment module, contact the support service of your platform.
How to submit receipts independently
If you don't use a solution from our partners, you need to send data for receipts to your online sales register by yourself. Payments will be processed via YooMoney regardless if your online sales register is working or not.
  1. Go to the "Online sales register" section in your Merchant Profile settings and confirm that you need to submit receipts.
  2. To continue configuration, you'll need an online sales register. It can be either an online service (if you only work online) or a physical sales register (if you receive payments at a physical retail outlet). A physical sales register can also be used for online sales if it can send online receipts to customers via internet.
    If you don't have a sales register yet, we suggest implementing the ready-made solution for 54-FZ: to do that, follow the link and leave an application for implementing the solution.
  3. Select Other from the drop-down list under Your online sales register.
  4. During the next step, double-check the settings and confirm if everything is correct.