Guide for developing the Yandex.Checkout module interface

Интерфейс настроек

This is what the settings section of the Yandex.Checkout module should look like when a user views it for the first time.
Block 1

User is required to fill out both fields with the parameters they received from Yandex.Checkout. The fields have limitations:

shopId — only for numbers, no limitations on the number of characters.

Secret key — for numbers and Latin alphabet letters, no limitations on the number of characters.

Technical documentation: authentication

Block 2

This block determines where the payment process will be performed, at Yandex.Checkout’s website, or at the user’s website.

Block 3

For our users to be able to work with sales register equipment via Yandex.Checkout, you need to send the name, price, and VAT rate of the product to us upon every payment. The client can use a special switcher to configure the data transmission.

Block 4

The address for notifications is generated by you: the user won’t be able to edit it, only copy. The user only needs this address for contacting Yandex.Checkout’s Support Service.

Technical documentation: notifications

Block 5

This button enables payment acceptance. If everything is filled out correctly, confirm it with a success message after the click: Settings saved.

When user starts filling in the settings, more blocks are shown. A fully loaded form looks like this:
Block 1

If the user selects On Yandex.Checkout’s side, an option to Use the ’Pay with Yandex’ button is offered.

More about this button at the Yandex.Checkout's website
Block 2

If the user selects On the store’s side, an option to Select payment methods from the contract is offered.

Users aren’t allowed to select both or neither options, they’re required to select only one. The default option is On Yandex.Checkout’s side.

Payment method selection on Yandex.Checkout's side
Block 3

If your users always specify VAT for products, or you have rate set by default, this switcher is enough.

If VAT is optional information within your system, users will have to specify the rate on this page: in this case, the VAT block is shown, composed of two fields: Default rate and Rate at your store.

Default rate

This is an drop-down list of six VAT rate options: No VAT, 0%, 10%, 20%, Calculated rate 10/110, Calculated rate 20/120.

Only one option can be selected; the default is set at 10%.

Compare the rates

In this section, user compares the rates already set at the store with the rates Yandex.Checkout sends to the Tax Service.

Number on the left — is the VAT rate set by the user in your system.

Drop-down list on the right — contains VAT rates included in the receipt sent to the Tax Service.

Number of lines depends on how many VAT rates user set out in your system. If the user haven’t set any rates at the website, this block won’t be shown.

Technical documentation: payments made under 54-FZ

If there are any errors, please let us know and help us fix them.

Important nuances

Make sure the module’s settings in your system are identical or at least similar to reduce the number of possible input errors.
Even if user wants to set up ten payment methods, these settings should only be filled out once: please do not make users fill out the settings for each payment method.

Interface copy

Copy the text from the file and add them to your interface.

Refunds interface

If your system supports payment refunds, please use this template for the refund page.
If the user enabled the option to send details for payment receipts via Yandex.Checkout, the interface appears as follows:
It’s important for the user to specify not the amonut of the refund but the products the refund is supposed to be issued for. The refund amount will be set automatically, and a new payment receipt containing the remaining products and the corresponding amount will be generated and sent to the Tax Service.

Interface copy

Copy the text from the file and add them to your interface.

Titles, logos, and service description

Service name

Yandex.Checkout—both words capitalized, full stop in between, no spaces.
  • Yandex.Checkout onboarding,

  • pay via Yandex.Checkout,

  • Yandex.Checkout settings.

Only use quotes when the title is followed by the word «service». Like this: «Yandex.Checkout» service.

Payment methods

Please use the same names for the payment methods as presented here: it will help your users to quicker navigate in the settings.
  • Bank cards: Visa, Mastercard and Maestro, Mir

  • YooMoney

  • WebMoney

  • QIWI Wallet

  • Cash

  • Alfa-Click

  • Promsvyazbank

  • Sberbank Online

  • Direct carrier billing — Beeline, Megafon, MTS, Tele2

  • Loans — the «Installments» service


Please include the Yandex.Checkout’s logo in the list of payment systems, on the page with the payment module’s settings, and within the setup guide.
Placement requirements:
  • field width identical to two letters Y in the logo

  • color:

colored logo for white background
Download the logo
white logo for black or dark backgrounds
Download the logo
black logo for colored and bright backgrounds
Download the logo


If you need a description of the Yandex.Checkout service (for instance, for the payment systems list), use the following:
Yandex.Checkout is the leading service for accepting online payments in Russia, according to a 2018 survey by MARC. Yandex.Checkout received the Emerging Payment Award at the Merchant Payments Ecosystem conference (Berlin) in 2017. With this payment solution, merchants from all over the world can offer Russian consumers the online payment methods most popular among Russians and CIS-citizens: bank cards, e-wallets, mobile phones, and cash via mobile retailers and payment kiosks (there are over 250 thousand cash-acceptance points all over CIS). Currently, more than 90,000 online stores across the globe use Yandex.Checkout.
Yandex.Checkout was launched by YooMoney in 2013. YooMoney is the joint venture of search engine Yandex (NASDAQ: YNDX), and Sberbank, the largest bank in Russia.
Visit the Yandex.Checkout website

Configuration manual

The guide will help your users to quicker set up payment acceptance. You can use it to answer the most frequently asked questions. We will post a link to your guide at the YooMoney’s website, and you can post it at your website next to the module or directly in the module’s settings.
You can use a template to create the guide: edit it in accordance with your module’s capabilities and interface and add screenshots.
Download the guide template