Technical Settings

The core thing is to select your Implementation method. This might require technical specialist's advice, but this is not obligatory. Implementation method determines the way you will get notified about successfule 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

 

Getting Notified about Payments

  • Via email—we will send you an email after each successful payment to the address you specified under your Merchant Profile. In this case, you need to process each message manually. You will not get notifications about failed payments.
  • Via HTTP—you send requests about payments' statuses or wait for notifications (we send them to a special URL on your site or service, which you specify in your Merchant Profile under the store's settings). You need this for automated order processing: for custom-made service or the CMS.

Purpose of automated order processing

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 method you select for implementing Yandex.Checkout determines how you get notified about the payments. We provide the following options:

  • Email protocol: we send notifications about successful payments at an email address. This method works fine if you do not process your orders automatically. It is easy to implement on any site.
  • API: you request an order status from us or wait for our notification. This method allows for processing orders automatically. It requires additional development with an integration via the Yandex.Checkout API.
  • Payment module: your system will learn about new payments automatically. 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

We also have an implementation method called HTTP Protocol: it is used for work under the outdated Protocol of Accepting Payments. We support this protocol, but do not sign up new stores using it.

More about implementation methods

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

API

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.

API

How it looks like under your Merchant Profile

Specify the address in your system to which you want to receive out notifications about payments. More about notifications in documentation

Payment module

How it looks like under your Merchant Profile

Firstly, select the system your site or service operates under. 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.

All addresses are filled in automatically: you can adjust them, but only if you are sure it is necessary.

The addresses we will send notifictions to go first:

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.

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; you will need to enter it in the module settings on your side.

Free SSL Certificate

Activating some modules require the SSL certificate. You can issue one for free from our partner REG.RU directly in your Merchant Profile under Settings (if you have already entered into contract with Yandex.Checkout).

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

It 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. You can copy these parameters in your Merchant Profile under Settings:
  • shopId — merchant ID
  • scid—identifier of the payment form.

Note

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

API

Signing up a store requires a development via the Yandex.Checkout API.

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.