---
metadata:
- name: generator
content: Diplodoc Platform v5.52.0
alternate:
- https://pay.yandex.ru/docs/ru/cms/bitrix/1c-bitrix.md
- href: ru/cms/bitrix/1c-bitrix.md
type: text/markdown
title: Markdown version
- href: ../../llms.txt
type: text/markdown
title: llms.txt
title: "Модуль Яндекс\_Пэй для 1С-Битрикс\_— установка и настройка | Документация"
description: "Подключите платежи Яндекс\_Пэй к сайту на 1С-Битрикс. Готовый модуль для интернет-магазина с полной интеграцией."
---
> **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/ru/llms.txt
# Интеграция с 1С-Битрикс
Бесплатный модуль
Модуль **1С-Битрикс** позволяет подключить прием платежей через Яндекс Пэй и Сплит для вашего сайта. Модуль предоставляет [ООО «Яндекс»](https://pay.yandex.ru/business/modules?utm_source=yandex_pay_docs) **бесплатно**.
{% note warning "Совместимость версий" %}
1С-Битрикс версии 17 и выше.
{% endnote %}
{% note alert %}
Если у вас установлена [старая версия](https://pay.yandex.ru/docs/ru/cms/bitrix/index.md) модуля 1С-Битрикс, рекомендуем удалить ее в настройках вашего магазина. Это поможет избежать конфликтов при одновременной работе двух модулей.
{% cut "Как это сделать" %}
1. В административной панели 1С-Битрикс перейдите в раздел **Магазин** → **Настройки** → **Платежные системы** и в списке подключенных платежных систем выберите систему Яндекс Пэй и Сплит, которую вы подключили с помощью модуля более ранней версии.
{width=90%}
1. В настройках платежной системы в правом верхнем углу нажмите кнопку **Удалить систему**.
{width=90%}
{% endcut %}
{% endnote %}
## Возможности модуля {#features}
#|
|| Прием оплаты |  ||
|| Полный возврат |  ||
|| Частичный возврат |  ||
|| Бейджи Яндекс Пэй / Сплит |  ||
|| Виджеты Яндекс Пэй / Сплит |  ||
|| Тестовый режим |  ||
|| Контроль наличия товара |  ||
|| Синхронизация статуса оплаты |  ||
|| Получение прямого QR | Неприменимо ||
|| Получение обратного QR | Неприменимо ||
|#
## Шаг 1. Регистрация в Яндекс Пэй {#registration}
1. [Зарегистрируйтесь](https://pay.yandex.ru/docs/ru/console/registration.md) в личном кабинете Яндекс Пэй и [подайте заявку](https://pay.yandex.ru/docs/ru/console/registration.md#application) на подключение сервиса Яндекс Пэй и Сплит в ваш магазин.
1. Дождитесь одобрения заявки и подключения сервиса.
1. В [личном кабинете Яндекс Пэй](https://console.pay.yandex.ru) выберите в [селекторе](*selector) ваш магазин и перейдите в раздел **Настройки**.
1. В блоке **Подключение** нажмите **Выпустить ключ Merchant API**, скопируйте и сохраните значение выпущенного ключа.
{% cut "Где выпустить ключ API" %}
{.c-screenshot width=500px}
{% endcut %}
Также скопируйте и сохраните значение **Merchant ID**. Эти данные понадобятся вам при дальнейшей настройке.
{% cut "Где найти Merchant ID" %}
{.c-screenshot width=500px}
{% endcut %}
## Шаг 2. Установка модуля {#module-install}
Чтобы установить модуль из маркетплейса 1С-Битрикс:
1. Откройте страницу модуля одним из способов:
- перейдите по [прямой ссылке](https://marketplace.1c-bitrix.ru/solutions/yandexpay.payment/);
- в 1С-Битрикс перейдите в **Магазин** → **Настройки** → **Платежные системы**, нажмите на значок стрелки на кнопке **Добавить платежную систему** и выберите опцию **Установить из маркетплейса**. В появившемся списке выберите «Официальный модуль Яндекс Пэй».
1. Под названием модуля нажмите кнопку **Установить**.
1. Во всплывающем окне введите адрес вашего сайта и нажмите кнопку **Установить**.
1. В новом окне браузера откроется панель управления указанного сайта. В списке обновлений будет доступна установка модуля «Официальный модуль Яндекс Пэй». Нажмите кнопку **Загрузить** и примите условия лицензионных соглашений.
1. После скачивания модуля в том же окне появится возможность установить решение — нажмите кнопку **Установить**.
## Шаг 3. Настройка модуля {#module-settings}
### Общие настройки
1. В административной панели 1С-Битрикс перейдите в раздел **Магазин** → **Настройки** → **Платежные системы** и нажмите кнопку **Добавить платежную систему**.
{.c-screenshot}
1. В параметрах платежной системы в поле **Обработчик** выберите **Яндекс Пэй (yapay)**. Отобразятся адреса Callback URL для режима отладки сервиса и рабочего режима.
{.c-screenshot}
1. В параметрах платежной системы укажите [Merchant ID](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#merchant-id) и [API-ключ](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#merchant-api-keys) из личного кабинета Яндекс Пэй.
{.c-screenshot}
{% note tip %}
Предзаполненные поля по умолчанию скрыты. Чтобы просмотреть все настройки нажмите **Показать все**.
{% endnote %}
1. Сохраните изменения.
1. При необходимости [настройте](#badges-widgets) бейджи и виджеты Яндекс Пэй.
### Настройка внешнего вида кнопки оплаты {#button-settings}
В разделе **Внешний вид кнопки** можно адаптировать вид кнопки оплаты в соответствии с дизайном вашего сайта:
{.c-screenshot}
Чтобы отредактировать ширину, высоту и радиус кнопки, включите опцию **Свои стили** и укажите необходимые размеры.
### Настройка смены статусов {#statuses-settings}
В разделе **Соответствие статусов** при необходимости можно настроить смену статуса заказа по событиям:
{.c-screenshot}
Если значения оставить пустыми, статус заказа меняться не будет.
{% note warning %}
Вне зависимости от настроенных статусов после оплаты заказ будет отмечаться оплаченным, а при возврате отметка об оплате будет сниматься.
{% endnote %}
## Шаг 4. Тестирование оплаты {#testing-mode}
Чтобы проверить корректность обработки платежей c помощью Яндекс Пэй, включите тестовый режим:
1. В личном кабинете Яндекс Пэй:
1. Перейдите в раздел **Настройки** и в правом верхнем углу включите опцию **Тестовые данные**.
1. В блоке **Подключение** нажмите **Добавить Callback URL `Тестовый`** и укажите Callback URL для режима отладки — он указан в административной панели 1С-Битрикс в параметрах платежной системы.
{% cut "Куда добавить тестовый Callback URL" %}
{.c-screenshot width=500px}
{% endcut %}
1. В административной панели 1С-Битрикс в параметрах платежной системы включите опцию **Режим песочницы**.
{.c-screenshot}
1. Выполните несколько тестовых платежей и [возвратов](#refunds) в вашем магазине, чтобы проверить, что модуль установлен успешно.
{% note info %}
Дополнительную информации о тестировании см. в разделе [Тестирование](https://pay.yandex.ru/docs/ru/testing.md#pay-split).
{% endnote %}
## Шаг 5. Переход в рабочий режим {#working-mode}
{% note tip "Фискализация" %}
Если вы еще не подключили в ваш магазин фискализацию чеков, вы можете подключить ее через облачную кассу АТОЛ Онлайн или CloudKassir в личном кабинете Яндекс Пэй — как это сделать, см. в разделе [{#T}](#fiscalization).
{% endnote %}
После тестирования оплаты переключите среду с тестовой на боевую:
1. В личном кабинете Яндекс Пэй:
1. Перейдите в раздел **Настройки** и отключите опцию **Тестовые данные**, чтобы скрыть тестовые настройки.
1. В блоке **Подключение** нажмите **Добавить Callback URL** и укажите Callback URL для рабочего режима — он указан в административной панели 1С-Битрикс в параметрах платежной системы.
1. В административной панели 1С-Битрикс в параметрах платежной системы отключите опцию **Режим песочницы** и сохраните изменения.
Настройка модуля завершена. Теперь клиенты в вашем магазине могут оплачивать покупки при помощи Яндекс Пэй и Сплит.
{% note info %}
Если у вас остались вопросы по настройке плагина, обратитесь в нашу [службу поддержки](https://forms.yandex.ru/surveys/13490261.f4adc83a2c75b10abe163bf264af4e3842a535e0/).
{% endnote %}
## Дополнительно
### Оформление возвратов {#refunds}
Чтобы оформить возврат платежа:
1. В административной части сайта перейдите в раздел **Яндекс Пэй** и у платежа, который необходимо вернуть, нажмите **Возврат**.
{.c-screenshot}
1. Выберите позиции для возврата, укажите количество или сумму и нажмите кнопку **Выполнить возврат**.
{.c-screenshot width=50%}
### Подключение бейджей и виджетов Яндекс Пэй {#badges-widget}
#### Бейджи {#bages}
Чтобы подключить готовые [бейджи](https://pay.yandex.ru/docs/ru/custom/web-sdk/badges.md) Яндекс Пэй на ваш сайт, в шаблон компонента `catalog.element` добавьте вызов компонента `yandex:yandexpay.badge`:
```php
IncludeComponent(
"yandex:yandexpay.badge",
".default",
array(
"PRODUCT_ID" => $arResult["ID"],
"PRODUCT_NAME" => $arResult["~NAME"],
"PRODUCT_CAN_BUY" => $arResult["CAN_BUY"],
"OFFERS" => $arResult["OFFERS"],
"USERCONSENT_ID" => "1",
"PERSON_TYPE_ID" => "1",
),
$component,
array('HIDE_ICONS' => 'Y')
);?>
```
{% cut "**Где найти шаблон компонента**" %}
Чтобы найти шаблон компонента, в 1C-Битрикс перейдите в раздел **Контент** → **Структура сайта** → **Файлы и папки**.
Компоненты хранятся в папках:
- `/bitrix/components/bitrix` (по умолчанию) — папка для хранения системных компонентов;
- `/bitrix/components/собственное_имя` — папка для хранения пользовательских компонентов;
- `/local/components` — рекомендуется для хранения компонентов сторонних разработчиков.
Пользовательские компоненты могут храниться в папке `/bitrix/components`, в любых ее подпапках (кроме `/bitrix`) или в папке `/local/components`.
Пример пути до файла шаблона компонента — `/local/components/bitrix/catalog.element/…/template.php`.
{% endcut %}
{% note info %}
Если у вас возникли сложности с размещением или подключением компонента, воспользуйтесь [инструкцией](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=2826&LESSON_PATH=3913.2704.2881.2826) от 1C-Битрикс.
{% endnote %}
Чтобы настроить бейджи:
1. В 1C-Битрикс перейдите в раздел **Настройки** → **Настройки продукта** → **Настройки модулей** → **Официальный модуль Яндекс Пэй и Сплит**.
1. Выберите платежную систему **Яндекс Пэй и Сплит** и в блоке **Настройки бейджей** задайте параметры отображения бейджей.
{.c-screenshot width=85%}
#### Виджеты {#widgets}
Чтобы подключить готовые [виджеты](https://pay.yandex.ru/docs/ru/custom/web-sdk/ultimate-widget.md) Яндекс Пэй на ваш сайт, в шаблон компонента `catalog.element` добавьте вызов компонента `yandex:yandexpay.widget`:
```php
IncludeComponent(
"yandex:yandexpay.widget",
".default",
array(
"PRODUCT_ID" => $arResult["ID"],
"PRODUCT_NAME" => $arResult["~NAME"],
"PRODUCT_CAN_BUY" => $arResult["CAN_BUY"],
"OFFERS" => $arResult["OFFERS"],
"USERCONSENT_ID" => "1",
"PERSON_TYPE_ID" => "1",
),
$component,
array('HIDE_ICONS' => 'Y')
);?>
```
{% cut "**Где найти шаблон компонента**" %}
Чтобы найти шаблон компонента, в 1C-Битрикс перейдите в раздел **Контент** → **Структура сайта** → **Файлы и папки**.
Компоненты хранятся в папках:
- `/bitrix/components/bitrix` (по умолчанию) — папка для хранения системных компонентов;
- `/bitrix/components/собственное_имя` — папка для хранения пользовательских компонентов;
- `/local/components` — рекомендуется для хранения компонентов сторонних разработчиков.
Пользовательские компоненты могут храниться в папке `/bitrix/components`, в любых ее подпапках (кроме `/bitrix`) или в папке `/local/components`.
Пример пути до файла шаблона компонента — `/local/components/bitrix/catalog.element/…/template.php`.
{% endcut %}
{% note info %}
Если у вас возникли сложности с размещением или подключением компонента, воспользуйтесь [инструкцией](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=2826&LESSON_PATH=3913.2704.2881.2826) от 1C-Битрикс.
{% endnote %}
Чтобы настроить виджеты:
1. В 1C-Битрикс перейдите в раздел **Настройки** → **Настройки продукта** → **Настройки модулей** → **Официальный модуль Яндекс Пэй и Сплит**.
1. Выберите платежную систему **Яндекс Пэй и Сплит** и в блоке **Настройки виджета** задайте параметры отображения виджета.
{.c-screenshot width=90%}
{% note tip %}
Если вы одновременно добавляете бейджи и виджеты, разместите их в отдельные блоки `div` и добавьте отступ, чтобы они не располагались вплотную друг к другу.
{% cut "Пример" %}
```php
IncludeComponent(
"yandex:yandexpay.widget",
".default",
array(
"PRODUCT_ID" => $arResult["ID"],
"PRODUCT_NAME" => $arResult["~NAME"],
"PRODUCT_CAN_BUY" => $arResult["CAN_BUY"],
"OFFERS" => $arResult["OFFERS"],
"USERCONSENT_ID" => "1",
"PERSON_TYPE_ID" => "1",
),
$component,
array('HIDE_ICONS' => 'Y')
);?>
```
{% endcut %}
{% endnote %}
#### Обновление и очистка кеша {#cache}
При тестировании отображения бейджей и виджетов можно обновлять кеш сайта с помощью кнопки **Сбросить кеш**:
{.c-screenshot width=90%}
По окончании настройки очистите кеш сайта:
1. Перейдите в **Настройки продукта** → **Автокеширование** → вкладка **Очистка файлов кеша**.
1. Выберите вариант **Все** и нажмите кнопку **Начать**.
{.c-screenshot width=70%}
{% note info %}
Если у вас возникли проблемы при настройке бейджей и виджетов, обратитесь в нашу [службу поддержки](https://forms.yandex.ru/surveys/13490261.f4adc83a2c75b10abe163bf264af4e3842a535e0/).
{% endnote %}
### Подключение фискализации {#fiscalization}
{% note alert "Ограничение" %}
При продаже маркированных товаров чеки не формируются из-за ограничений сервиса Яндекс Пэй, данные не передаются в систему маркировки Честный знак.
{% endnote %}
Если вы используете для фискализации АТОЛ Онлайн или CloudKassir, вы можете настроить автоматическую передачу данных в кассу для формирования кассовых чеков:
1. Выполните настройку в [личном кабинете Яндекс Пэй](https://console.pay.yandex.ru):
1. Выберите в [селекторе](*selector-1) нужный магазин и перейдите в раздел **Настройки** → **Облачная касса** → **Подключить облачную кассу**.
{.c-screenshot width=400px}
1. Выберите из списка кассу и нажмите кнопку **Продолжить**.
1.
Последовательно заполните данные в зависимости от кассы, которую выбрали:
{% list tabs %}
- АТОЛ
- адрес сайта вашего магазина — будет отображен покупателю в чеке;
- электронная почта для связи — будет отображена покупателю в чеке;
- система налогообложения, которую вы используете;
- логин, пароль и код группы касс в системе АТОЛ.
{% note info %}
Адрес сайта магазина и электронная почта могут отличаться от тех данных, которые вы указали при регистрации в личном кабинете Яндекс Пэй.
{% endnote %}
- CloudKassir
- адрес сайта вашего магазина — будет отображен покупателю в чеке;
- электронная почта для связи — будет отображена покупателю в чеке;
- система налогообложения, которую вы используете;
- Public ID — идентификатор магазина из личного кабинета CloudKassir;
- Пароль для API — секретный ключ из личного кабинета CloudKassir.
{% endlist %}
1. Нажмите кнопку **Продолжить**. В течение нескольких минут касса будет подключена.
1.
Настройте НДС для ваших товаров в личном кабинете 1C-Битрикс — используйте для этого [материалы обучающего курса](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&CHAPTER_ID=03069&LESSON_PATH=3912.4580.4828.3069) от 1С-Битрикс.
1.
После того как вы завершите настройку фискализации, убедитесь, что транзакции проходят корректно и чеки формируются без ошибок.
### Ошибки {#errors}
Данные по ошибкам, которые возникли при создании оплаты, записываются в таблицу **b_sale_pay_system_err_log**.
Чтобы просмотреть таблицу, перейдите в раздел **Настройки** → **Производительность** → **Таблицы**.
[*selector-1]: Выпадающий список в верхней части страницы личного кабинета Яндекс Пэй, с помощью которого можно переключаться между юридическими лицами и магазинами.
{.c-screenshot width=300px}
[*selector]:
Выпадающий список в верхней части страницы личного кабинета Яндекс Пэй, с помощью которого можно переключаться между юридическими лицами и магазинами.
{.c-screenshot width=300px}