---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://pay.yandex.ru/docs/en/cms/bitrix/payment-system-setup.md
  - https://pay.yandex.ru/docs/ru/cms/bitrix/payment-system-setup.md
---
> **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/en/llms.txt

# Connecting a payment system

1. Open the 1C-Bitrix dashboard.
1. In the left panel, select **Store** → **Payment systems**.

   ![payment-systems](_assets/payment-systems.jpg)

1. Find **Yandex Pay** in the list and open its settings. To do so, double-click it.
1. Configure the payment system settings.

## Payment system parameters {#payment-system-settings}

- **Handler**: Yandex Pay (yandexpay).
- **Payment system type**: The payment system that you have a contract with.

You can connect to one of the payment systems that Yandex Pay supports:

{% list tabs %}

- Alpha Bank (RBS)

   Fill out the [signup form](https://alfabank.ru/sme/payservice/internet-acquiring/#form). The bank's manager will contact you.

- MTS Bank

   Fill out the [signup form](https://www.mtsbank.ru/malomu-biznesu/torgovye-resheniya/internet-acquiring/). The bank's manager will contact you. They'll start working on your application within one business day. If you submit all the required documents and the site is ready, the connection process takes 2-4 days.

- RSHB

   [Send an application](https://www.rshb.ru/smallbusiness/acquiring/internet/) or contact the bank's office.

- Best2Pay

   Fill out the [signup form](https://best2pay.net/#main_form_container). The bank's manager will contact you.

   ![best2pay](_assets/best2pay.png)

- My payment system isn't on the list

   If your payment system is not on the list, contact Payture, a partner of Yandex. You will get a 25% discount off the provider services (the manager will tell you about that). Leave a request [on the site](https://payture.com) or write to [business@payture.com](mailto:business@payture.com). Managers will respond to you within 3-4 hours on business days.

{% endlist %}

## Payment system handler settings {#handler}

Only fill out the **By default** tab unless you need specific settings for individuals and legal entities:

- **Test mode**: If the option is enabled, no funds will be charged.
- **Merchant ID** and **Merchant name**: Filled out automatically. To fill them out, click **Request** next to the boxes.
- **Button color**: Button design. To learn more, go to [Yandex Pay branding rules](https://yandex.ru/dev/yandex-pay/doc/design/index.html).
- **Button width**: Button size.
- **Notification address**: The address of the script that receives the payment status. It's filled out automatically, but you can change it if your site uses a different script path.

   ![handler](_assets/handler.png)

Orders created via Yandex Pay Checkout get a corresponding order source mark. In user event handlers, you can find an order by checking the [payment system](https://dev.1c-bitrix.ru/api_d7/bitrix/sale/classes/order/getpaymentcollection.php) or [merchant platform](https://dev.1c-bitrix.ru/api_d7/bitrix/sale/classes/order/gettradebindingcollection.php) with the `yapay_checkout` code.

![himage](_assets/order-source.png)

## Additional data for payment system types {#additional-info}

You can get them from the payment system that you have a contract with:

{% list tabs %}

- Payture

   Contact your manager or write to [business@payture.com](mailto:business@payture.com).

- Alpha Bank (RBS)

   Specify the login that you received from the bank by email, and the password. The bank's email subject: "Details for connecting to the productive environment (Alpha Bank internet acquiring) [login]". The Merchant ID isn't necessary.

- MTS Bank

   Specify the login that you received from the bank by email. Also specify the password that you set.

- RSHB

   Specify the login and password: they should have been sent to the email that you entered in one of the forms when concluding the contract.

- Best2Pay

   Specify the unique account ID and password to the electronic signature.

- RBK.money

   Use the store key and the public key. To fill out these boxes, write to [support@rbkmoney.com](mailto:support@rbkmoney.com). In your email, specify the CMS name (Bitrix) and the module name (Yandex Pay) and briefly explain your question.

{% endlist %}

## What's next {#next}

When you've connected a payment system, you can go to the [general settings](https://pay.yandex.ru/docs/en/cms/bitrix/settings.md) tab. To do this, select **Yandex Pay Checkout** on the top panel.