API Changelog

For those who use zero-amount linking: you can now subscribe to the  payment_method.active notification in Merchant Profile.

For those who process payouts (regular payouts and payouts within the Safe Deal):

For those who accept payments for housing and public utilities: limits have been introduced for the bank.name parameter (up to 45 characters) and the payment_period.year parameter (must be within the range 1920–2050).

С 1 января 2026 года комиссия за платежи в ЮKassa увеличится на сумму НДС: вместе с комиссией за платежи будет списываться НДС — 22% от суммы комиссии. Сумма платежа за вычетом комиссии и суммы НДС с этой комиссии вернется в объекте income_amount. Для уточнения подробностей обратитесь к менеджеру ЮKassa.

Starting December 29, 2025, YooMoney will no longer support services for self-employed individuals, including receipts for payments and refunds, as well as payouts to the self-employed. Until December 29, all services will remain fully available.

For those who create invoices via API: you can now automatically share the invoice with the customer via YooMoney in a text message or by email.

For those who accept payments via Sberbank Business Online (b2b_sberbank): the list of VAT rates that can be set for products with the same rate (vat_data.type=calculated) has changed. Starting from January 1, 2026, you can specify a new rate in the request: 22% (instead of the 20% rate). Learn more in the API reference.

For those who make payouts:

For those who use the solutions for payments under 54-FZ: starting from January 1, 2026, the basic VAT rate will increase from 20% to 22%, and the estimate rate from 20/120 to 22/122. You can specify the new rate codes in the vat_code parameter: 11 and 12, respectively. All online sales registers support the increased rates.

Now, when creating a refund, you can send the metadata object with the additional data that you need for work (for example, number of the order in your system). YooMoney will return this data unchanged.

For SberPay, the holding period for payments made in two stages is now 5 days (previously 7 days). The new period is applicable to payments created on November 13, 2025 or later.

For those who use the YooMoney solution for working in accordance with 54-FZ: you can now specify the new parameters internet (online payment processing attribute) and timezone (time zone) in the receipt data.

Now you can test payment acceptance for housing and public utilities.

You can now send a payment overview to users. To do this, set the statements when you create a payment. After a successful payment, YooMoney will automatically send the payment details to the user's email. This is available only for payments made with bank card, via SberPay, or using FPS.

For those who use YooMoney's solutions for working under 54-FZ:

С 1 сентября 2025 года для способа «Покупки в кредит» от СберБанка вводится период охлаждения. Это время после оформления кредита или рассрочки, в течение которого пользователь может передумать и бесплатно отказаться от сделки. Что изменится в API:

The option to download the YooMoney API specification in the YAML format is now available. More about the OpenAPI specification

A new integration option, Payment with phone number entered on your side, was added for the "Pay in installments" payment method. You can independently request the user's phone number and send it to YooMoney. Then the user will proceed to the "Pay in installments" service to complete the payment without any additional actions on YooMoney's side.

A new payment method has been added: "Pay in instalments". It allows customers to split the payment amount and pay for the order gradually. Код способа в API — sber_bnpl.

The succeeded_at parameter (time of a successful payout processing) was added to the payout object. It's only included for payouts with the succeeded status.

Payment and payout limits have changed:

For those who use autopayments: now you can test saving the payment method using a zero-amount linkage.

Now the refund object in the succeeded status for payment refunds made from a bank card or via Mir Pay contains authorization details (refund_authorization_details) with the refund's RRN.

For those who use Receipts from YooMoney: now you can specify no more than 80 items in the items parameter of the receipt (the value used to be no more than 100 items).

The holding period for payments made in two stages as part of the "Credit pruchases" by SberBank payment method has changed. The holding period for payments made in two stages is now 2 hours (used to be 7 days). The new period will affect all payments made from February 21, 2025 on.

YooMoney offers a new type of saving the payment method: zero-amount linkage. You can save a user's bank card for autopayments or payouts without debiting their account.

For those who use the solutions for payments under 54-FZ: YooMoney now supports the 5% and 7% VAT rates. You can specify the new rate codes in the vat_code parameter. Requirements:

We've changed the procedure of making payments for housing and public utilities. Now the payment object changes to succeeded right away after the user's payment is successfully accepted. You no longer need to wait for the results of registration of a payment order on the housing and utilities sector's side.

A new reason for payout cancellation has been added: self_employed_annual_limit_exceeded (limit on the annual income of the self-employed is exceeded).

For those who accept payments via Sberbank Business Online (b2b_sberbank): the list of VAT rates that can be set for products with the same rate (vat_data.type=calculated) has changed. You may now set the new rate in the request: 5%. The rate of 18% is no longer supported. Learn more in the API reference.

You can now accept payments for housing and public utilities via YooMoney.

The YooMoney service now supports online sales registers provided by KOMTET Kassa and digitalkassa. Learn more about sending receipts to a third-party online sales register

The invoice object with the canceled status now returns a cancellation_details object with information about the initiator and reason for the cancellation.

For those who accept payments via FPS and redirect users to the bank's app independently: you can now set the URL to which the user will return after payment in the request for creating a payment. To do this, add the return_url parameter to the confirmation object.

You can now issue invoices via API in YooMoney.

For payments via FPS: the payment object with the succeeded status is now returned with the payer_bank_details object. It contains the banking details used for payment.

We've added a new payment method: you can now accept payments by electronic certificates linked to the Mir card. The method code in the API is electronic_certificate.

Tinkoff Pay payment method is now called T-Pay. There're no changes in the API, the code remains the same: tinkoff_bank.

iOS SDK is no longer supporting iOS versions below 14.0.

For partners: now access to the store can be granted not only by the Owner, but also by a user with the Manager role. Learn more about roles in the Merchant Profile

For those who add money to e-wallets, bank accounts, and phone balances:

The YooMoney API stops supporting the “Installments” payment method (installments):

Added a new reason for the cancellation of a refund: rejected_by_timeout (technical issues on the side of the initiator of the refund cancellation).

For those who use regular payouts: the minimum payout amount to a bank card is now 5 rubles (previously it was 100 rubles). Learn more about payout limits

Now when paying via Tinkoff Pay in a payment object with the succeeded, waiting_for_capture, and canceled statuses, objects payment_method.card (bank card details) and authorization_details (payment authorization details) may be returned.

The YooMoney widget now supports payments via “Credit purchases” by SberBank.

For two-stage payments: now, for payments via SberPay, Mir Pay, Tinkoff Pay, and “Credit purchases” by SberBank, you can debit not just the whole amount but a part of it as well.

For those who accept payments from bank cards or via Mir Pay: the card_product object (card product of a payment system) has been added to the Payment object.

For those who make standard payouts, there are updates in extracts from payout reports:

Mobile SDK updates:

The QIWI Wallet payment method (qiwi) has been disabled due to the fact that QIWI Bank had its license revoked. Payments and refunds for this method are unavailable.

For SberPay, the holding period for payments made in two stages is now 5 days (previously 7 days). The new period will affect all payments made from January 25, 2024 on.

For the self-employed who use the auto-sending of receipts: you can disable the option in the YooMoney Merchant Profile now without having to revoke the rights from YooMoney in the Moi Nalog service.

For those who make payouts to bank cards using the widget for collecting the data:

For those, who request store settings: limits for the itn parameter of the Me object have changed. INN (TIN) can now contain up to 20 characters.

For partners: the fiscalization_enabled parameter of the Me object is deprecated, the information about the settings of receipts sent to the Tax Service is now returned in the fiscalization object.

YooMoney now supports online sales registers provided by 1-OFD, LIFE PAY, Mertrade, RocketR. More about sending receipts to a third-party online register

One-time limits for payments have changed. The maximum payment amount for payments made via SberBank Business Online, FPS, Tinkoff Pay, SberPay is 700,000 rubles; maximum limit for payments made via Mir Pay or bank cards is 350,000 rubles. More about limits

Tinkoff Pay is now used instead of the Tinkoff payment method. The code in the API remains the same: tinkoff_bank. Main differences:

If you've already used the Tinkoff method, the transition to Tinkoff Pay will be completed automatically.

For those who make payouts to the self-employed: a new status of the self-employed object has been added: unregistered (a self-employed individual with this INN (TIN) isn't registered in Moi nalog, or the user has lost the self-employed status).

For those who send receipts using the Receipt after payment scenario: the limit on maximum number of receipts that you can link to one payment or refund has been extended to 30.

For those who make payouts: now you can enable notifications on changes in payout status using the Merchant Profile.

Now, if a user adds money to the bank account created in your system, details of the replenished account should be set in the request for creating a payment. Learn more about adding money to an account created in your system

For payments via the Faster Payments System (FPS): now payment and refund objects can contain transaction's ID in FPS: payment_method.sbp_operation_id (in payment objects) and refund_method.sbp_operation_id (in refund objects).

New payment method added: “Credit purchases” by SberBank, API code is sber_loan.

The YooMoney API stops supporting the alfabank payment method (Alfa-Click).

YooMoney offers a new solution for working under 54-FZ: Receipts from YooMoney. Using it, you can send receipts to the Tax Service without renting an online sales register or buying a fiscal storage drive.

The YooMoney widget now supports payments via Mir Pay.

For those who use Safe deal: added a new reason for the cancellation of a payout, identification_required (adding money to anonymous wallets is forbidden, the user needs to complete identification).

For those who use iOS SDK: you can no longer install the demo app, which previews payment interfaces and the payment process.

Added a new payment method: Mir Pay. This method is displayed in the payment form for mobile devices on Android. Available to those who use Smart payment or YooMoney's ready-made page for payments via bank cards.

For those who make payouts: now commission is deducted from your balance not for all successful transactions once a day, but separately for each payout immediately after it's made.

Payments via the FPS (Faster Payments System) can no longer be processed in two stages. Now the capture parameter must always have value true in requests for creating a payment via the FPS. If you use Smart payment or the YooMoney widget, FPS is no longer displayed as a payment method for two-stage payments.

Now partners who use an OAuth token for authenticating requests can process recurring payments.

Now YooMoney has the test mode for those who'd like to test the features of the API. You don't need to enter the information about your company or enter into a contract. Available for regular payments, and the partnership program. To test the Safe deal or Split payments feature, you need to enter the information about your company when signing up.

Now you can specify the phone number where money should be added in a request for creating a payment in YooMoney. Learn more about adding money to the balance

For those who make payouts to bank cards using data collection widget: a new version of the widget (3.0.0) has been released. In this version, the set of parameters returning by the library in case of success has changed. Learn more about updates

The process of testing payments via the wallet has changed: you can test payments in the demo store without signing out of your YooMoney wallet.

For those who use autopayments: now you can test the unsuccessful scenario in which the payment where the payment method is saved is successful, but if the payment is repeated using the received ID, it returns an error.

Two-stage payments via FPS (the Faster Payment System) are temporarily unavailable.

Self-employed individuals can now process payments with automatic receipt registration in the Moi Nalog service.

Now the FPS payment method can be saved for recurring payments.

Checkout.js no longer returns the expired_card and card_declined error codes.

Online platforms which use Split payments can now add a transaction description (transfers.description) for each store in payment creation requests. The seller will see this description in the YooMoney Merchant Profile.

For those who use YooMoney's solution for 54-FZ: online sales registers from Kit Invest and ModulKassa now support generating receipts in accordance with FFD 1.2.

The YooMoney widget now processes unsuccessful payment attempts for all payment methods, and Smart payment now works for unsuccessful attempts via bank cards, SberPay, Faster Payments System, and YooMoney wallet. If you manage the integration on your own, unsuccessful attempts are now processed by ready-made forms for payment via bank cards, the YooMoney wallet, or SberPay. If you'd like to make the decision on what to tell the user after an unsuccessful payment on your own, contact your YooMoney manager.

Added a new range of IP addresses from which YooMoney can send notifications: 2a02:5180::/32

YooMoney stops supporting German in the widget. If you display texts in the payment form in German, select another language: English or Russian.

Smart payment now supports saving the payment method for recurring payments.

The single payment limit for transactions via the Faster Payments System has been increased from 600,000 rubles to 1 million rubles.

The payer_bank_details.kpp parameter in the payment object is now optional for payments via Sberbank Business Online.

New requirements for the URL for incoming notifications: now only URLs with TCP ports 443 or 8443 can be used for subscribing to notifications.

sbp payment method (the Faster Payments System of the Central Bank of the Russian Federation, FPS) added to the payment creation request.

All transactions via Visa, Mastercard, JCB, and American Express cards issued abroad have been suspended in Russia. Therefore, there are restrictions on using Apple Pay and Google Pay:

The WebMoney payment method (webmoney) has been disabled due to the fact that WebMoney's settlement bank had its license revoked. Payments and refunds for this method are unavailable.

From now on, if you’d like to configure how payment methods are displayed in the YooMoney widget, first you need to contact your manager to implement this feature. If you don’t do it, you’ll get the customization_of_payment_methods_not_allowed error when initializing the widget with the specified payment_methods parameter.

Now the SberPay payment method can be saved for recurring payments.

YooMoney may now send notifications from two new IP addresses:

Updates to the YooMoney widget:

YooMoney now supports FFD 1.2 for working with online sales registers. The option to send new parameters for marking will be implemented later.

Added the authorization_details.three_d_secure parameter (information about user’s 3‑D Secure authentication) to the Payment object.

The SberBank Online payment method is about to be disabled:

Now you can display the YooMoney payment widget in a pop-up window.

For those who use Safe deal: now you can subscribe to notifications about changes in the status of created deals and payouts.

If a payment via Apple Pay and Google Pay is unsuccessful, the YooMoney widget or the Smart payment page displays an error message to the user and prompts them to try paying again with an option to select a different card or payment method.

Now you can specify information about marking of the drugs being sold (additional user and payment subject parameters) in the request for creating a receipt. Available only to those who use the Receipt after payment scenario.

For those who use Safe deal: the minimum amount for a payout to seller's bank card reduced from 100 rubles to 1 ruble. Learn more about payout limits

You can now create a demo store from the YooMoney Merchant Profile.

For those who use Safe deal: now you can specify the bank card number when making payouts.

For those who use Safe deal: now you can make payouts to YooMoney wallets.

Added a restriction on creating receipts using the Receipt after payment scenario: now you can’t link more than 15 receipts to one payment or refund.

Added test bank cards of different payment systems for testing payments via bank cards.

A new solution for marketplaces — Safe deal — is now available in YooMoney. It can be used for online platforms, where individuals sell products and provide services to each other, to accept payments from customers and make payouts to sellers.

Now the YooMoney widget processes unsuccessful payments via bank cards on its own and prompts the user to try paying again. You can disable this setting by contacting your YooMoney manager and set up a custom scenario of processing unsuccessful payments.

Now payments can be made using a new version of the SberBank payment method — SberPay. YooMoney switches those who use the SberBank Online payment method to the new version. Learn more about SberPay

Now online platforms which use Split payments can get information about seller’s store registered on the platform.

In the YooMoney Checkout Widget, you can’t select the method of authentication via 3-D secure for bank card payments anymore. Payment confirmation will now be always offered to users in a pop-up window instead of a separate webpage.

Online marketplaces that use Split payments can now send additional information for each store.

Updates in the YooMoney Checkout widget:

Limitation added for payment refunds: payments via Sberbank Online (sberbank payment method) can only be refunded within a year since the date of creation.

New payment cancellation reason added: unsupported_mobile_operator (YooMoney doesn’t support payments from the specified phone number).

Three new fields were added to the payment reports: Payer name, Payer address, and Taxpayer Identification Number (INN). This information is only sent for payments of over 15,000 rubles made via YooMoney wallet.

For those who implement the Google Pay method independently: gateway tokenization parameter now must be specified with the yoomoney value.

Updates for web SDK: YooMoney widget, Checkout.js, Checkout UI.

Launch of the new API version. Changes:

Mobile SDK updates:

For partners: YooMoney has changed the process for getting OAuth tokens. Learn more about updates

New design of the payment form in the YooMoney Checkout Widget.

The YooMoney API stops supporting the wechat payment method (WeChat app).

Online marketplaces that use Split payments can now track the integration status of stores via dashboard.

Changes in the card.first6 parameter of the Payment object:

The YooMoney's widget now returns a new error code: invalid_return_url (invalid URL of the payment completion page).

With Split Payments, online marketplaces can now charge commissions from stores for sold products and services.

New reasons for payment cancellation have been added:

Payment refunds now have a limitation: a payment can only be refunded within three years of its creation.

You can now customize the color scheme of the payment form in the YooMoney Checkout Widget.

A new version of the mobile SDK for iOS has been released. If you're already using the library to accept payments, update dependency settings.

YooMoney now offers a new solution for marketplaces – Split payments. Now online marketplaces where stores place their goods and services can accept payments and automatically distribute them among stores.

In the YooMoney Checkout Widget, when making a payment via bank card, the user can now complete 3-D Secure authentication in a pop-up window without leaving your website.

The income_amount parameter (payment amount minus the YooMoney commission) added to the Payment object.

The option to test the payment process with a receipt is now available.

New scenario for sending receipts is now available: you can send data for creating payment and refund receipts in the receipt creation request.

For partners:

You can now select the language (Russian, English, or German) in the YooMoney Checkout Widget for displaying text in the payment form to the user.

Sberbank Business Online payment method is now available for implementation to clients of all banks.

YooMoney Checkout Widget now supports payments via bank cards linked to YooMoney wallets.

You no longer need to specify the google_transaction_id parameter when creating a payment with the Google Pay payment method.

YooMoney Checkout Widget now supports payments via Sberbank Online.

YooMoney Checkout Widget now supports payments via YooMoney wallets and saving the payment method for recurring payments.

You can now embed a payment form to your website using the YooMoney Checkout Widget.

You can now get information about receipts for payments and refunds.

You can send data for generating transaction completion receipts to the online sales register.

card.issuer_country (code of the country where the bank card was issued) and card.issuer_name (name of the issuing bank) parameters added to the Payment object.

Authorization via the OAuth 2.0 protocol: developers of apps (for example, CMS, CRM) can interact with the YooMoney API on behalf of YooMoney users. More about the YooMoney partnership program

You can now get a list of receipts for payments or refunds.

permission_revoked (user disabled recurring payments) added to payment cancellation reasons.

wechat (WeChat app) payment method added to the payment creation request.

YooMoney now supports online sales registers provided by Kit Invest.

The YooMoney API stops supporting the psb payment method (Promsvyazbank Internet banking).

Changes in the airline parameters:

Launch of the YooMoney API documentation portal for developers.

tinkoff_bank (Tinkoff online banking) payment method added to the payment creation request.

The new 20% VAT rate added to the b2b_sberbank (Sberbank Business Online) payment method.

YooMoney now supports FFD 1.05: payment_mode (payment method attribute) and payment_subject (payment subject attribute) parameters for creating a receipt added to payment creation request.

b2b_sberbank (Sberbank Business Online) payment method added to the payment creation request.

YooMoney stops returning response HTTP 202 code (“request is being processed”): the response now contains either “success” or “failure”.

psb (Promsvyazbank Internet banking) payment method added to the Payment object. The user can only select this method at the YooMoney’s page.

locale parameter added to confirmation object in the payment creation request: you can select the language for displaying payment confirmation info to the user.

authorization_details object added to the Payment object.

google_pay (Google Pay) payment method added to the payment creation request.

cancellation_details object (commentary for a canceled payment) added to the Payment object.

installments (Installments service) payment method added to the payment creation request.

first6 parameter (Bank Identification Number for bank card, the first 6 digits) added to the card object.

airline object added to the payment creation request: you can send airline addendum data when selling airline tickets.

test attribute added to the Payment object.

description parameter added to the Payment object.

expires_at parameter added to the Payment object.

Launch of the YooMoney API.