The YooMoney API Changelog

API Changelog

2021

October 8

Added the

authorization_details.three_d_secure

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

October 6

The SberBank Online payment method is about to be disabled:

If you’d like to start accepting payments via SberBank, use SberPay.
If you already accept payments via SberBank Online, you’ll be switched to SberPay automatically. Learn more about the transition to SberPay

September 17

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.

September 15

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.

September 8

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

August 18

The YooMoney payment widget can now save bank cards used for payment in your store and offer them during recurring payments.

July 27

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.

July 13

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

June 8

Apple Pay and Google Pay payment methods can be saved for recurring payments.
You can now save the Apple Pay and Google Pay payment methods for recurring payments in the YooMoney Checkout Widget.

May 21

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.

May 12

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 and its implementation

April 2

Now online platforms which use YooMoney’s solution for marketplaces can get information about seller’s store registered on the platform.

March 31

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.

March 15

You can now configure the display of payment methods in the YooMoney Checkout Widget.
YooMoney doesn’t support web SDK Checkout UI anymore. If you want to display a ready-made form for entering bank card data, use the YooMoney Checkout Widget. If you want to design the form yourself, use Checkout.js.

February 1

Online marketplaces that use the YooMoney solution for marketplaces can now send additional information for each store.

2020

December 23

Updates in the YooMoney Checkout widget:

the widget now notifies when the payment form is displayed: the
render
method now returns Promise;
the option to reload an initialized widget is now available.

December 22

Limitation added for payment refunds: payments via Sberbank Online (

sberbank

payment method) can only be refunded within a year since the date of creation.

December 21

New payment cancellation reason added:

unsupported_mobile_operator

(YooMoney doesn’t support payments from the specified phone number).

December 18

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.

December 15

For those who implement the Google Pay method independently:

gateway

tokenization parameter now must be specified with the

yoomoney

value.

December 10

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

December 7

Launch of the new API version. Changes:

Endpoint: requests must now be sent to
https://api.yookassa.ru/v3
.
Comments to unsuccessful payments: if the payment is cancelled by YooMoney,
cancellation_details.party
will contain the
yoo_money
value.
Payment from YooMoney wallet: payment method code was changed to
yoo_money
.
Server SDK: SDKs for PHP and Python were updated.

December 1

Mobile SDK updates:

iOS SDK: SDK module renamed, dependencies updated, support for iOS versions older than 10.0 discontinued. More about updating to the newer version of SDK
Android SDK: SDK module renamed, dependencies updated, support for Android versions older than 5.0 discontinued. More about updating to the newer version of SDK

November 17

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

September 10

The YooMoney API stops supporting the

wechat

payment method (WeChat app).

August 28

Online marketplaces that use the YooMoney solution for marketplaces can now track the integration status of stores via dashboard.

August 26

Changes in the

card.first6

parameter of the Payment object:

the parameter is now optional;
the value of the parameter now depends on the method of entry of the bank card data.

June 5

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

June 3

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

May 21

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

May 14

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.

May 5

The

income_amount

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

April 2

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

March 27

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

March 6

For partners:

The option to request refund creation rights is now available.
The
payment_methods
object (list of payment methods available to the store) added to the Me object.

February 14

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.

February 6

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

2019

December 11

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

December 10

You no longer need to specify the

google_transaction_id

parameter when creating a payment with the Google Pay payment method.

November 19

YooMoney Checkout Widget now supports payments via Sberbank Online.

November 12

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

September 27

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

September 26

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

September 5

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

August 14

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.

July 12

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 for Business partnership program

July 5

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

July 1

customer
(customer information) object and
product_code
,
country_of_origin_code
,
customs_declaration_number
,
excise
(additional information about the product) parameters for creating a receipt added to payment creation request.
receipt.email
and
receipt.phone
parameters are deprecated. You can still use them, but we recommend sending the data in the
receipt.customer
object (
email
and
phone
parameters respectively).

June 27

permission_revoked

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

June 25

wechat

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

May 27

YooMoney now supports online sales registers provided by Kit Invest.

May 21

The YooMoney API stops supporting the

psb

payment method (Promsvyazbank Internet banking).

May 16

Changes in the

airline

parameters:

passengers
and
legs
are now optional;
ticket_number
is a required parameter, but if its value is unknown, you’ll need to specify
booking_reference
;
the option to specify the airline code (
carrier_code
) added to the flight information (
legs
).

April 4

Launch of the YooMoney API documentation portal for developers.

March 26

alfabank
(Alfa-Click) payment method now allows for processing the payment by the
redirect
scenario. The user’s login in Alfa-Click is not required.
Payment creation with
qiwi
(QIWI Wallet) payment method does not require the user’s phone number anymore (the
phone
parameter in the
payment_method_data
object is now optional).

February 14

tinkoff_bank

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

February 6

YooMoney now sends out notifications about two new events:
payment.canceled
(payment status changed to
canceled
) and
refund.succeeded
(refund status changed to
succeeded
).
The option to select the events that you want to track via notifications is now available in your Merchant Profile.

2018

December 28

The new 20% VAT rate added to the

b2b_sberbank

(Sberbank Business Online) payment method.

December 17

The amount of time allotted for capturing a payment in the
waiting_for_capture
status changed to 7 days for payments made from a YooMoney wallet (same as for payments via bank card), and 6 hours for payments made using other methods.
After the cancellation of a payment made from a YooMoney wallet, funds are returned to the user’s account immediately.

November 19

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.

October 15

b2b_sberbank

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

September 12

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

September 7

psb

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

July 31

locale

parameter added to

confirmation

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

July 20

authorization_details

object added to the Payment object.

July 17

google_pay

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

June 4

cancellation_details

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

April 17

installments

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

April 10

first6

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

April 4

airline

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

January 15

test

attribute added to the Payment object.

2017

November 30

description

parameter added to the Payment object.

November 22

Error
id
added to the Error object.
captured_at
parameter added to the Payment object.

October 30

expires_at

parameter added to the Payment object.

October 15

Launch of the YooMoney API.

Do you have any questions or comments regarding the documentation?

We can set up a call and discuss them: we'll help you solve the problem and you'll help us understand what we need to improve. To do that, share your contact information and select the time.

Yes, I'd like to set up a meeting