--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://pay.yandex.ru/docs/en/cms/bitrix/index.md - https://pay.yandex.ru/docs/ru/cms/bitrix/index.md --- > **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/ru/llms.txt # Интеграция с 1С-Битрикс Бесплатный модуль {% note alert %} Данный модуль Яндекс Пэй для 1С-Битрикс не дорабатывается и не поддерживается. Рекомендуем использовать новую версию модуля — ознакомьтесь с инструкцией по интеграции по [ссылке](https://pay.yandex.ru/docs/ru/cms/bitrix/1c-bitrix.md). {% endnote %} Чтобы оплачивать покупки при помощи Яндекс Пэй и Сплит в 1С-Битрикс, нужно установить специальный модуль. Модуль предоставляет [ООО «Яндекс»](https://pay.yandex.ru/business/modules?utm_source=yandex_pay_docs) **бесплатно**. Описанные функциональные возможности доступны в модуле версии 1.4.6 и выше. Версия 1С-Битрикс должна быть не ниже 19.0.0. Подробнее о модуле читайте на [сайте партнера](https://marketplace.1c-bitrix.ru/solutions/yandexpay.pay/#tab-about-link). ## Возможности модуля {#features} #| || Прием оплаты | || || Полный возврат | || || Частичный возврат | * || || Бейджи Яндекс Пэй / Сплит | || || Виджеты Яндекс Пэй / Сплит | || || Получение прямого QR | Неприменимо || || Получение обратного QR | Неприменимо || |# * Возврат доступен в разделе [Платежи](https://pay.yandex.ru/docs/ru/custom/refund-payments#console-refund) личного кабинета Яндекс Пэй. ## Установка модуля {#module-install} Вы можете установить модуль Яндекс Пэй из Маркетплейс 1С-Битрикс: 1. Откройте страницу модуля одним из способов: - перейдите по [прямой ссылке](https://marketplace.1c-bitrix.ru/solutions/yandexpay.pay/) на страницу в браузере; - в 1С-Битрикс перейдите в **Магазин** → **Настройки** → **Платежные системы**, нажмите на значок стрелки на кнопке **Добавить платежную систему** и выберите опцию **Установить из маркетплейса**. В появившемся списке выберите «Официальный модуль Яндекс Пэй». 1. Под названием модуля «Официальный модуль Яндекс Пэй» нажмите кнопку **Установить**. 1. Во всплывающем окне введите адрес вашего сайта и нажмите кнопку **Установить**. 1. В новом окне браузера откроется панель управления указанного сайта. В списке обновлений будет доступна установка модуля «Официальный модуль Яндекс Пэй». Нажмите кнопку **Загрузить** и примите условия лицензионных соглашений. 1. После скачивания модуля в том же окне появится возможность установить решение — нажмите кнопку **Установить**. ## Регистрация в Яндекс Пэй {#settings} 1. Последовательно авторизуйтесь в [Яндекс ID](https://id.yandex.ru/) и личном кабинете Яндекс Пэй по шагам в разделе [Регистрация](https://pay.yandex.ru/docs/ru/console/registration.md). 1. В личном кабинете на вкладке [Сервисы](https://console.pay.yandex.ru/services) заполните данные о вашем магазине. 1. Перейдите в раздел [Настройки](https://console.pay.yandex.ru/settings) и в выпадающем списке сверху выберите нужный магазин. 1. Скопируйте **Merchant ID** и **API-ключ**. Эти данные понадобятся вам при [добавлении платежной системы](https://pay.yandex.ru/docs/ru/cms/bitrix/index.md#add-ps) в 1С-Битрикс. {% note info %} Если вы не использовали API-ключ до этого, сначала его необходимо выпустить. О том, как это сделать, читайте в разделе [Выпуск API-ключа](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#merchant-api-keys). {% endnote %} 1. На странице **Сайт** для получения уведомлений об оплатах укажите **Callback URL**: `https://#DOMAIN#/bitrix/services/yandexpay.pay/trading/`, где `#DOMAIN#` — адрес сайта в Битриксе. ## Добавление платежной системы {#add-ps} 1. В 1С-Битрикс зайдите в **Магазин** → **Настройки** → **Платежные системы**. В правом верхнем углу нажмите кнопку **Добавить платежную систему**. 1. Заполните основные параметры платежной системы: #| || **Параметр** | **Значение** || || Обработчик | `Яндекс Пэй (yandexpay)` || || Название | `Яндекс Пэй` || || Доступные методы оплаты на платежной форме Яндекс Пэй | Выберите `Пэй` и `Сплит`, чтобы в вашем магазине были доступны оба способа оплаты. || || Кодировка | `UTF-8` || || Merchant ID | Укажите [Merchant ID](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#merchant-id) магазина, для которого вы настраиваете платежную систему. || || API-ключ | Укажите [API-ключ](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#merchant-api-keys), полученный в личном кабинете Яндекс Пэй. {% note info %} Если **Merchant ID** и **API-ключ** в параметрах платежной системы уже были заполнены, нажмите ссылку **Показать все**, отключите опцию **По умолчанию** и введите новые значения. {% endnote %} || || Время жизни ссылки (в секундах) | Укажите время, в течение которого будет действительна ссылка на оплату заказа или оставьте значение по умолчанию, включив опцию **По умолчанию**. Доступный диапазон значений, в секундах: от `180` до `604 800`, значение по умолчанию — `1800`. {% note info %} После того, как пользователь перешел по ссылке, на завершение оплаты дополнительно отводится 15 минут. Если в течение отведенного времени оплата не произошла, заказ считается не оплаченным. {% endnote %} || |# Остальные параметры заполните самостоятельно по необходимости. {% cut "Если вы хотите разделить кнопки оплат для Пэй и Сплит" %} Чтобы полная оплата и Сплит на сайте магазина были доступны через отдельные кнопки, добавьте платежную систему дважды: - с названием `Яндекс Пэй` и методом оплаты `Пэй` — для Пэй; - с названием `Яндекс Сплит` и методом оплаты `Сплит` — для Сплит. {% endcut %} 1. Внизу страницы нажмите кнопку **Применить**, чтобы продолжить настройку платежной системы, или **Сохранить**, чтобы сохранить изменения и выйти из настроек. ## Тестирование {#sandbox} Чтобы проверить корректность обработки платежей c помощью Яндекс Пэй, включите тестовый режим: 1. В административной панели 1С-Битрикс перейдите в **Магазин** → **Настройки** → **Платежные системы** → **Яндекс Пэй** и нажмите кнопку **Изменить**. 1. В блоке **Настройка обработчика ПС** нажмите ссылку **Показывать все** и включите опцию **Тестовый режим**. 1. Включите опцию **Активность**. {% note info %} Если опция **Активность** уже была включена, то отключите ее и установите заново. {% endnote %} 1. Создайте заказ на сайте магазина, выберите платежную систему Яндекс Пэй и оплатите покупку одной из тестовых карт. 1. Чтобы проверить возвраты, на административной панели 1С-Битрикс зайдите на страницу просмотра заказа через **Магазин** → **Заказы**. Подробнее о возвратах читайте в главах [Полный возрат](https://pay.yandex.ru/docs/ru/cms/bitrix/index.md#full-refund) и [Частичный возврат](https://pay.yandex.ru/docs/ru/cms/bitrix/index.md#partial-refund). Если вы используете копию сайта для разработчиков, в [личном кабинете Яндекс Пэй](https://console.pay.yandex.ru/settings) отметьте **Показать настройки тестовой среды** и замените доменное имя в поле **Callback URL**. Копия для разработчиков должна быть доступна по HTTPS-протоколу без дополнительной авторизации (например, HTTP-авторизации). ## Настройка онлайн-чеков {#online-checks} В соответствии с [54-ФЗ](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=9251&LESSON_PATH=3912.9179.9251) магазин должен печатать онлайн-чек. 1С-Битрикс поддерживает подключение для следующих касс: - [ККМ в офисе](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&CHAPTER_ID=09181&LESSON_PATH=3912.9179.9373.9181) - [1С](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=9261&LESSON_PATH=3912.9179.9373.9261) - [Атол.Онлайн](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&CHAPTER_ID=09187&LESSON_PATH=3912.9179.9373.10177.9187) - [Orange Data](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=7363&LESSON_PATH=3912.9179.9373.10177.7363) - [Бизнес.Ру](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=21864&LESSON_PATH=3912.9179.9373.10177.21864) Полный список касс смотрите в [документации Битрикс](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&CHAPTER_ID=010177&LESSON_PATH=3912.9179.9373.10177). Посмотреть настроенные кассы можно через **Магазин** → **Кассы** → **Список касс**. Настройте печать чеков: 1. Проверьте, что в Битрикс уже была добавлена касса, или добавьте новую. 1. На вкладке **Ограничения** проверьте, что отсутствует ограничение по платежным системам. Разрешите системе использовать новую платежную систему, дважды нажав на строку с ограничением. 1. Зайдите в **Магазин** → **Настройки** → **Платежные системы** → **Яндекс Пэй** и включите опцию **Разрешить печать чеков**. Если касса уже была подключена к 1С или CRM, а обмен заказами настроен, вы можете продолжить печать чеков без внесения дополнительных изменений. ## Настройка журнала событий {#log} Журнал событий, связанных с заказами, доступен на странице платежной системы на вкладке **Журнал Яндекс Пэй**. По умолчанию после создания платежной системы журнал работает в режиме отладки. Чтобы включить запись в журнал ошибок и любых действий с заказами: 1. В административной панели 1С-Битрикс перейдите в **Магазин** → **Настройки** → **Платежные системы** → **Яндекс Пэй** и нажмите кнопку **Изменить**. 1. В блоке **Настройка обработчика ПС** на вкладке **По умолчанию** в поле **Содержание журнала событий** выберите **Информация**. 1. Справа от поля включите опцию **По умолчанию**. 1. Внизу страницы нажмите кнопку **Сохранить** и проверьте запись событий в журнал. {% cut "Если события не записываются" %} Если вы включили запись событий, но они не отображаются в журнале: 1\. В блоке **Настройка обработчика ПС** проверьте, что для всех типов плательщика справа от поля **Содержание журнала событий** включена опция **По умолчанию**. 2\. Проверьте ошибки, которые происходят до обработки запроса `yandexpay.pay` — настройте [логирование ошибок 1С-Битрикс](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=2795#exception_handling) с `'handled_errors_types' => 20853` и проверьте лог. {% endcut %} ## Публикация {#public} После настройки и тестирования подготовьте Яндекс Пэй к приему оплат от покупателей: 1. В административной панели 1С-Битрикс перейдите в **Магазин** → **Настройки** → **Платежные системы** → **Яндекс Пэй** и нажмите кнопку **Изменить**. 1. В блоке **Настройка обработчика ПС** нажмите ссылку **Показывать все** и отключите опцию **Тестовый режим**. 1. Включите опцию **Активность**. {% note info %} Если опция **Активность** уже была включена, то отключите ее и установите заново. {% endnote %} 1. Если вы выполняли настройку на копии сайта для разработчиков, в [личном кабинете Яндекс Пэй](https://console.pay.yandex.ru/settings) снимите переключатель **Показать настройки тестовой среды**, а в поле **Callback URL** замените доменное имя сайта. 1. Оформите заказ и выполните оплату через Яндекс Пэй. Дождитесь печати чека и выполните возврат. Подробнее о возвратах читайте в главах [Полный возрат](https://pay.yandex.ru/docs/ru/cms/bitrix/index.md#full-refund) и [Частичный возврат](https://pay.yandex.ru/docs/ru/cms/bitrix/index.md#partial-refund). Если у вас возникли сложности с настройкой или замечания по проведению платежей, [напишите разработчикам модуля 1С-Bitrix](https://forms.yandex.ru/surveys/10033903.63f6c399661c2134dc8ff581939c3cab3599c055/?utm_source=pay&utm_medium=checkout&utm_campaign=cms). ## Полный возврат {#full-refund} Для осуществления возврата: 1. В административной панели 1С-Битрикс перейдите в окно просмотра оформленного заказа через **Магазин** → **Заказы**. 1. В разделе **Оплата** нажмите на статус оплаты **Оплачен** и выберите в выпадающем меню **Возврат**. 1. Во всплывающем окне в поле **Вернуть на** выберите Яндекс Пэй и нажмите кнопку **Сохранить**. 1. Проверьте значение поля **Статус заказа** в разделе **Параметры заказа**. ## Частичный возврат {#partial-refund} {% note alert %} На текущий момент 1С-Битрикс [не поддерживает частичные возвраты](https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=42&LESSON_ID=9293). При ручном изменении состава товаров или стоимости в оплаченном заказе возникшая разница в итоговой стоимости заказа будет начислена на внутренний счет покупателя, однако в этом случае не будет выбит чек, что [не соответствует законодательству](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=9251&LESSON_PATH=3912.9179.9251). {% endnote %} Для корректного оформления частичного возврата товаров: 1. Сделайте [полный возврат](https://pay.yandex.ru/docs/ru/cms/bitrix/index.md#full-refund) по заказу. 2. Скопируйте старый заказ. 3. Уберите ненужные позиции и сохраните новый заказ. 4. После оплаты нового заказа напечайте чек заново. ## Частые проблемы {#faq} При возникновении проблем с подключением проверьте, что следующие параметры введены верно: - Merchant ID - API-ключ Если эти настройки корректны, то посмотрите список самых частых проблем и их решений: #| || **Ошибка** | **Варианты решения** || || Ошибка `"response_status": 404`. Возникает при запросе к Callback URL. | В личном кабинете Яндекс Пэй проверьте **Сallback URL**, скорее всего, он введен неверно. {% note alert %} При регистрации аккаунта в Яндекс Пэй через кнопку **Настроить Яндекс Пэй** Callback URL **НЕ** передается, поэтому его необходимо выставить вручную в [личном кабинете Яндекс Пэй](https://console.pay.yandex.ru/settings): `https://#DOMAIN#/bitrix/services/yandexpay.pay/trading/`. {% endnote %} || || Ошибка редиректов со слешем «/» или без слеша при запросе на [/bitrix/services/yandexpay.pay/trading/](https://elineshop.ru/bitrix/services/yandexpay.pay/trading/button/data/#rout#). | В файле `.htaccess` добавьте исключение `RewriteCond %{REQUEST_URI} !^/bitrix/` перед пользовательскими правилами `RewriteRule`. {% note alert %} Исключение нельзя добавлять перед `RewriteRule ^(.*)$ /bitrix/urlrewrite.php`. {% endnote %} || || Ошибка `"reasonCode": "OTHER", "reason": "orderId is missing"`. Возникает, если при запросе из-за редиректа с адреса без «/» на адрес с «/» потерян `orderId`. | ^ || || После оформления через Битрикс не выводится кнопка оплаты на финальной странице заказа. | - Проверьте шаблон страницы `confim.php` компонента `sale.order.ajax` на наличие вывода кода обработчика из переменной ``. - Проверьте, для какого идентификатора платежной системы включен указанный выше код. Идентификатор платежной системы Яндекс Пэй должен подходить под условие, заданное в коде. - Если идентификатор платежной системы в коде задан корректно, но кнопка не отображается, то проверьте, корректны ли значения переменных, содержащих информацию о платежной системе. {% cut "Пример" %} ![image](_assets/code-example.png){.c-screenshot width=700} В этом примере предусмотрен вывод только для платежных систем с индентификаторами `3` и `5`, поэтому кнопка оплаты Яндекс Пэй не будет отображаться. {% endcut %} || || ЧПУ для карточки товара формируется кастомно: не только по правилу формирования из инфоблока, но, например, где-то в коде. | Установите опцию для расширения конечного шаблона ЧПУ: `\YandexPay\Pay\Config::setOption('injection_engine_element_greedy', '#GREEDY#/');`, где `#GREEDY#` — конечный шаблон. {% cut "Пример" %} - `#GREEDY#/` - `#GREEDY#.html` - `#GREEDY#/#GREEDY#.html` {% endcut %} || || Отладка ошибок при запросах на `/bitrix/services/yandexpay.pay/trading/button/data/#rout#`.| В настройках платежной системы или чекаута установите опцию **Содержание журнала событий** в режим «Отладка». В этом режиме все запросы в платежной системе будут записываться и отображаться на вкладке **Журнал Яндекс Пэй**. || || Ошибка с `render html\text` в ответе. В результате возвращается HTML-страница. | - Отключите HTTP-авторизацию, если она настроена. - Проверьте, что указан верный **Сallback URL** для тестового режима. - Проверьте, установлен ли на тестовой среде SSL-сертификат. Если нет, установите его, чтобы сайт был доступен по протоколу HTTPS. - Установите правило в `urlrewrite.php` на стороне клиента: ```php 24 => array ( 'CONDITION' => '#^/bitrix/services/yandexpay.pay/trading/#', 'RULE' => '', 'ID' => '', 'PATH' => '/bitrix/services/yandexpay.pay/trading/index.php', 'SORT' => 1, ), ``` || || Включено боевое окружение, но страница оплаты открывается в sandbox. | 1. В настройках платежной системы 1С-Битрикс на вкладке **Физическое лицо** или **Юридическое лицо** проверьте, что установлены индивидуальные настройки для сайта. 2. На вкладке **По умолчанию** проверьте, какой режим работы включен. Если включен тестовый режим, отключите его. Когда включен тестовый режим, все настройки берутся с вкладки **По умолчанию**. || || Ошибка `404` на одном из доменов, которые управляются из одной административной панели Битрикса. {% cut "Пример" %} У партнера два домена: `https://m.merchant.com` и `https://merchant.com`. {% endcut %} | Если на втором сайте с поддоменом есть `urlrewrite`, установите правило: ```php array ( 'CONDITION' => '#^/bitrix/services/yandexpay.pay/trading/#', 'RULE' => '', 'ID' => '', 'PATH' => '/bitrix/services/yandexpay.pay/trading/index.php', 'SORT' => 1, ), ``` || || Ошибка `Incorrect payment params` в консоли сайта при попытке оплаты и сообщение «Что-то пошло не так» на кнопке оплаты. | Проверьте, что вы указали верные [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) из личного кабинета Яндекс Пэй. Для тестовой среды эти значения должны совпадать. || || Ошибка `404` в консоли сайта при попытке оплаты и сообщение «Что-то пошло не так» на кнопке оплаты. | Проверьте, что: - в корне сайта мобильной версии в файле `urlrewrite.php` присутствует правило для скрипта `bitrix/services/yandexpay.pay/trading/index.php`; - в файле [.htaccess](https://dev.1c-bitrix.ru/api_help/main/general/urlrewrite.php) присутствует правило для `bitrix/urlrewrite.php`; - во вложенных директориях `bitrix, bitrix/services`, `bitrix/services/yandexpay.pay`, `bitrix/services/yandexpay.pay/trading` отсутствует файл `.htaccess`, который отключает обработку `mod_rewrite`; - для конфигурации `nginx+php-fpm` — `location` для [URL](https://m.merchant.com/bitrix/services/yandexpay.pay/trading/orders) содержит правило `urlrewrite`. Чтобы определить параметр `location`, который используется для обработки адреса, установите директиву [add_header](https://nginx.org/en/docs/http/ngx_http_headers_module.html). Для отладки потребуются файлы `.htaccess` и `urlrewrite.php`, а также конфигурация nginx для мобильной версии. Если вы используете shared-сервер, уточните у хостинг-провайдера, какие оптимизации веб-сервера включены для мобильной версии сайта. Для отладки shared-хостинга потребуется ответ хостинг-провайдера с описанием включенных услуг. || || После оплаты заказа не выставляется флаг `Y` у **Статус оплаты**. | В файле модуля `lib/trading/action/rest/orderwebhook/stage/orderpay.php` добавьте строку: `$data['PS_STATUS'] = 'Y';`. {% cut "Скриншот" %} ![image](./_assets/faq-bug.png){.c-screenshot} {% endcut %} || || Ошибка `Return value must be of type ?int, string returned` после обновления версии PHP. | Установите верный тип данных: ```php public function paymentTtl(Payment payment) : int { return (int)this->getParamValue($payment, 'PAYMENT_TTL'); } ``` || |# ## Системные настройки модуля {#system-settings} #| || **Настройка модуля** | **Расшифровка** || || `Pay\Config::getOption('check_product_available', 'Y')` | Включает проверку доступности на js при изменении офера, чтобы не делать запросы на бэк. Работает в карточке товара. По умолчанию включено. Выключать в том случае, если не используется стандартный механизм вывода торговых предложений. || || `Pay\Config::getOption('check_product_validate', 'Y')` | Включает проверку офера: является ли офер потомком основного товара. Работает в карточке товара. По умолчанию включено. Выключать в том случае, если не используется стандартный механизм вывода торговых предложений. || || `Pay\Config::getOption('library_query')` | Показывает, какая версия jquery установлена. Работает в административной панели. || || `Pay\Config::getOption('injection_engine_element_greedy', '')` | Используется для установки кастомного ЧПУ для карточки товара. || || `Pay\Config::getOption('log_expire_days', 10)` | Используется для установки количества дней для очистки логов. || || `Pay\Config::getOption('set_http_host', 'N')` | Передает `http host` в запросы от Яндекс Пэй. || || `Pay\Config::getOption('region_cookie', '')` | Используется для установки региона в куки при запросах для Аспро решений. || || `Pay\Config::getOption('stores_by_available')` | Используется для установки стратегии получения складов магазина, `”all”` — учитывает наличие корзины товаров на всех складах. || || `Pay\Config::getOption('catalog_store_description', '#DESCRIPTION#')` | Используется для установки шаблона для описания складов, `”#DESCRIPTION#”` — описание будет состоять только из значения поля **Описание**. || || `Pay\Config::getOption('environment_product_provider', '')` | Используется для установки кастомного `product provider`. Указывается класс для провайдера товаров формирования корзины. || |#