Technical Settings

The core thing is to select your Implementation method. This might require technical specialist's advice, but this is not obligatory. The selected implementation method determines how we will send you notifications on successful payments and errors.

Important. If your company is registered in Russia, fill out the settings under your Merchant Profile. If it is registered somewhere else, our manager will send you a technical questionnaire. Apart from that, technical integration does not depend on the country.

 

Additional feature: we can help you integrate with an online sales register (to comply with Federal Law No. 54). In this case, you will transmit details required for creating a receipt to us. And we will transmit these details to your online sales register.

What is Federal Law No. 54 (FZ-54)

Integrating with an online sales register

 

Notificaitons about payments

You receive these notifications after each successful payment. You can get them using one of the following methods:

  • Via email—we send notifications on every payment to your email address (which you provided under your Merchant Profile). In this case, you need to process each message manually. You will not get messages about failed payments.
  • Via HTTP—we send notifications to a special address (URL) of your site or service (which you provide under your Merchant Profile). These notifications can be processed automatically: in a self-build service or the CMS.

What is the automated notification processing for

It serves for uploading information about payments to your system. For instance, for changing the payment status in your online store to 'Paid'. Or for uploading information about payments to accounting systems as 1C.

Example

Imagine that Alice and Peter made a purchase at an online store. Alice paid for her order with a bank card right away, while Peter chose payment upon delivery.

The store receives HTTP notifications and processes the payment information in a real-time mode. The manager will open the dashboard, view the order list, and see Alice's order is paid and Peter's order is not paid.

Implementation Method

The implementation method determines how you will receive notifications about payments. We support three methods for Yandex.Checkout:

  • Email protocol: you receive notifications via email. This method works fine if you do not process your orders automatically. It is easy to implement on any site.
  • HTTP protocol: you receive notifications directly into your system. This method allows for processing orders automatically. It requires additional developer's work for integration via the payment acceptance protocol.
  • Payment module: you receive notifications directly into your system. This method suits you if your site works using the CMS. SaaS, or framework with Yandex.Checkout's module. Additional developer's work is not required: you only need to install and set up the module. List of modules using Yandex.Checkout

Important. Non-Russian companies can work with our payment modules. But you need to make sure this module supports our currency scheme. More about currencies

Settings in Merchant Profile

They depend on the implementation method. Start with choosing it first:

Email Protocol

HTTP protocol

Payment Module

How it looks like under your Merchant Profile

You can change the method if you are yet to send us the questionnaire. You can save settings in progress and return to them later for filling in the things you need.

When everything is filled, push Send—your settings will be transmitted to our technical specialist for check. If something goes wrong, we will get in touch with you. If everything is correct, we will send you implementing manual and add Settings section to your Merchant Profile. In this section, you can see parameters to set up on your side.

Email Protocol

How it looks like under your Merchant Profile

Specify the address where you want to get notifications on payments to, and you are ready to send the settings to our manager right away.

HTTP protocol

How it looks like under your Merchant Profile

Specify addresses for the notifications:

checkUrl—to this address you will get requests for checking payment parameters before executing the payment.

avisoUrl—to this address you will get notifications about successful payments.

Important! Notifications we send only work via HTTPS: to receive them, you need an SSL certificate to be installed. Just adding https at the beginning of the address will not work.

You can specify pages where your buyers, after paying on your site, will be redirected to either upon hitting a special button (set by default) or automatically (set by request).

If you need these pages, turn on Use success and error pages with dynamic addresses and specify these addresses:

shopSuccessUrl—a page the buyer will see after successful payment.

shopFailUrl—a page the buyer will see if the payment returns error.

To get notifications to other addresses in the course of test payments, turn on I want to try test payments and specify the required addresses.

Fill out the remaining parameters:

Email address for registers—you will get your daily payment registers to this address.

shopPassword—a secret word that you will need when processing the notifications from our service.

Payment Module

How it looks like under your Merchant Profile

Firstly, select the system your site or service operates under. All addresses are filled in automatically: you can adjust them, but only if you are sure it is necessary.

If you did not find one, check with our manager to make sure whether we have a payment module for your system. In this case, you nevertheless can sign up for Yandex.Checkout, but using another method. Without integration, with email notifications. Or with integration via our protocols—in this case, you will need to create a module for your system.

Fill out the remaining parameters:

Email address for registers—you will get your daily payment registers to this address.

shopPassword—a secret word; you will need to enter it in the module settings on your side.

Free SSL Certificate

You need to issue the certificate for the domain if you implement our payment solution via Payment module or HTTP protocol. In this case, our partner, REG.RU, issues the certificates for free. If you entered into contract with Yandex.Checkout, you can get these certificates under your Merchant Profile in the Settings section.

Collecting a certificate under your Merchant Profile:

  1. Fill out our questionnaire about your company, sign the contract and send it to us for check.
  2. Fill in the technical settings. Save them, but do not send them for review.
  3. As soon as the contract is checked, a button Get certificate will appear under your Settings.
How it looks like

You can only get the certificate for one site signed up for Yandex.Checkout. If you cannot collect the certificate in your Merchant Profile, request it from our manager. In certain cases, you can get an additional certificate for the second site.

Settings on Your Side

In any circumstance, you will need the following:

  • shopId—internal identifier of the store in Yandex.Checkout
  • scid—internal identifier of the payment form in Yandex.Checkout
  • shopPassword—secret word (you create it under your Merchant Account when signing up).

The rest depends on the selected implementation method, on the method you are going to process our notifications.

Email Protocol

You only need to embed our payment form in your site. Your buyers will see a button Pay with Yandex (or any other you choose). You can ask our manager for the form or build one of your own (view parameters and sample).

The form's code is an ordinary html code, which you can simply add to your site's code; the most important thing about it is using proper parameters.

Note

You can edit the form using any text editing program. You need to enter the parameters exactly as shown in the technical documentation.

HTTP protocol

For onboarding a store you need a development after Payment acceptance protocol.

More about steps of onboarding and development

Payment Module

Depends on your system and the version of the module you use. You can check with instructions to know for sure, the instruction is usually built in the module. If it is not, check it with the module or CMS developers.

You can download most of instructions in our list of modules.