Yandex Pay merchant console

Merchant registration

  1. Go to the Yandex Pay console.
  2. Enter your contact details and select the integration method:
    1. To connect over the API, click API integration.
    2. To connect through a CMS module, select your module and follow the instructions.
  3. Specify the registration credentials for your company.
  4. Select a payment provider and enter their details. If you only want to provide payments by Split or you do not have a payment provider, skip this step.
Example

skip-psp

Setting up a test environment

To connect over the API, set up the Yandex Pay test environment:

  1. Go to the developer page and enable the Show test environment settings option. On the page, you can get the Merchant ID and the API key for the Yandex Pay API used to test the integration.
  2. Enable emulation of a payment provider so you can make test payments by bank cards.
  3. Set up the Callback URL to which Yandex Pay will send requests and webhooks to the Merchant API. This item is optional if you're integrating a simplified workflow with link generation to a payment form.

Setting up Callback URL

The Callback URL is an HTTPS URL on your backend that is exposed on the internet. The URLs should be different for the test and production environments.

The Callback URL is set up on the developer page:

console-callback-url

Tip

To set up the Callback URL for the test environment, enable the option Show test environment settings.

As the URL, specify the Merchant API request prefix. For example, if you specify https://sandbox.example.merchant.ru/yandex-pay in your settings, then on the backend side, you need to implement webhook handling at the path https://sandbox.example.merchant.ru/yandex-pay/v1/webhook.

Note

You need to double-check the digital signature for the requests arriving at the Callback URL. For more information, see Yandex Pay request authentication.

What's next

Read about the API integration and go ahead with the technical procedure.