Интеграция с 1С-Битрикс

Бесплатный модуль

Чтобы оплачивать покупки при помощи Яндекс Пэй и Сплит в 1С-Битрикс, установите специальный модуль. Модуль предоставляет Яндекс бесплатно.

Возможности модуля

Шаг 1. Регистрация в Яндекс Пэй

1. Зарегистрируйтесь в личном кабинете Яндекс Пэй и подайте заявку на подключение сервиса Яндекс Пэй и Сплит.

2. После того как сервис Яндекс Пэй и Сплит будет подключен, перейдите в раздел Настройки и выберите в селекторе нужный магазин.

3. В блоке Ключи Yandex Pay Merchant API нажмите кнопку Выпустить ключ и скопируйте значение API-ключа.

   Также скопируйте значение Merchant ID. Эти данные понадобятся вам при настройке платежной системы в 1С-Битрикс.

Шаг 2. Установка модуля

Чтобы установить модуль из маркетплейса 1С-Битрикс:

1. Откройте страницу модуля одним из способов:

   • перейдите по прямой ссылке;
   • в 1С-Битрикс перейдите в Магазин → Настройки → Платежные системы, нажмите на значок стрелки на кнопке Добавить платежную систему и выберите опцию Установить из маркетплейса. В появившемся списке выберите «Официальный модуль Яндекс Пэй».

2. Под названием модуля нажмите кнопку Установить.

3. Во всплывающем окне введите адрес вашего сайта и нажмите кнопку Установить.

4. В новом окне браузера откроется панель управления указанного сайта. В списке обновлений будет доступна установка модуля «Официальный модуль Яндекс Пэй». Нажмите кнопку Загрузить и примите условия лицензионных соглашений.

5. После скачивания модуля в том же окне появится возможность установить решение — нажмите кнопку Установить.

Шаг 3. Настройка модуля

Общие настройки

1. В административной панели 1С-Битрикс перейдите в раздел Магазин → Настройки → Платежные системы и нажмите кнопку Добавить платежную систему.

   

2. В параметрах платежной системы в поле Обработчик выберите Яндекс Пэй (yapay). Отобразятся адреса Callback URL для режима отладки сервиса и рабочего режима.

   

3. В параметрах платежной системы укажите Merchant ID и API-ключ из личного кабинета Яндекс Пэй.

   

   Совет

   Предзаполненные поля по умолчанию скрыты. Чтобы просмотреть все настройки нажмите Показать все.

4. Сохраните изменения.

Настройка внешнего вида кнопки оплаты

В разделе Внешний вид кнопки можно адаптировать вид кнопки оплаты в соответствии с дизайном вашего сайта:

Чтобы отредактировать ширину, высоту и радиус кнопки, включите опцию Свои стили и укажите необходимые размеры.

Настройка смены статусов

В разделе Соответствие статусов при необходимости можно настроить смену статуса заказа по событиям:

Если значения оставить пустыми, статус заказа меняться не будет.

Шаг 4. Тестирование оплаты

Чтобы проверить корректность обработки платежей c помощью Яндекс Пэй, включите тестовый режим:

1. В административной панели 1С-Битрикс в параметрах платежной системы включите опцию Режим песочницы.

   

2. В личном кабинете Яндекс Пэй перейдите в раздел Настройки, выберите в селекторе нужный магазин и в правом верхнем углу включите опцию Тестовая среда.

3. В поле Callback URL Тестовый укажите Callback URL для режима отладки — он указан в административной панели 1С-Битрикс в параметрах платежной системы.

   

4. Выполните несколько тестовых платежей и возвратов в вашем магазине, чтобы проверить, что модуль установлен успешно.

   Примечание

   Дополнительную информации о тестировании см. в разделе Тестирование.

Шаг 5. Переход в рабочий режим

После тестирования оплаты переключите среду с тестовой на боевую:

1. В личном кабинете Яндекс Пэй перейдите в раздел Настройки и отключите опцию Тестовая среда, чтобы скрыть тестовые настройки.

2. В поле Callback URL укажите Callback URL для рабочего режима — он указан в административной панели 1С-Битрикс в параметрах платежной системы.

   

3. В административной панели 1С-Битрикс в параметрах платежной системы отключите опцию Режим песочницы и сохраните изменения.

Настройка модуля завершена. Теперь клиенты в вашем магазине могут оплачивать покупки при помощи Яндекс Пэй и Сплит.

Оформление возвратов

Чтобы оформить возврат платежа:

1. В административной части сайта перейдите в раздел Яндекс Пэй и у платежа, который необходимо вернуть, нажмите Возврат.

   

2. Выберите позиции для возврата, укажите количество или сумму и нажмите кнопку Выполнить возврат.

   

Подключение бейждей и виджетов Яндекс Пэй

Бейджи

Чтобы подключить готовые бейджи Яндекс Пэй на ваш сайт, в шаблон компонента catalog.element добавьте вызов компонента yandex:yandexpay.badge:

<?
 $APPLICATION->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')
);?>

Чтобы настроить бейджи:

1. Перейдите в настройки модуля Официальный модуль Яндекс Пэй и Сплит.

2. Выберите платежную систему Яндекс Пэй и Сплит и в блоке Настройки бейджей задайте параметры отображения бейджей.

   

Виджеты

Чтобы подключить готовые виджеты Яндекс Пэй на ваш сайт, в шаблон компонента catalog.element добавьте вызов компонента yandex:yandexpay.widget:

<?
 $APPLICATION->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')
);?>

Чтобы настроить виджеты:

1. Перейдите в настройки модуля Официальный модуль Яндекс Пэй и Сплит.

2. Выберите платежную систему Яндекс Пэй и Сплит и в блоке Настройки виджета задайте параметры отображения виджета.

   

<div style="margin-top:20px">
<?
 $APPLICATION->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')
);?>
</div>

Обновление и очистка кеша

При тестировании отображения бейджей и виджетов можно обновлять кеш сайта с помощью кнопки Сбросить кеш:

По окончании настройки очистите кеш сайта:

1. Перейдите в Настройки продукта → Автокеширование → вкладка Очистка файлов кеша.

2. Выберите вариант Все и нажмите кнопку Начать.

   

Ошибки

Данные по ошибкам, которые возникли при создании оплаты, записываются в таблицу b_sale_pay_system_err_log.

Чтобы просмотреть таблицу, перейдите в раздел Настройки → Производительность → Таблицы.