Подключение Яндекс Пэй в 1С-Битрикс

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

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

Подробнее о модуле читайте на сайте партнера.

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

Установка модуля

Вы можете установить модуль Яндекс Пэй из Маркетплейс 1С-Битрикс:

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

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

2. Под названием модуля «Официальный модуль Яндекс Пэй» нажмите кнопку Установить.

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

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

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

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

1. Последовательно авторизуйтесь в Яндекс ID и личном кабинете Яндекс Пэй по шагам в разделе Регистрация.

2. В личном кабинете на вкладке Сервисы заполните данные о вашем магазине.

3. Перейдите в раздел Настройки и в выпадающем списке сверху выберите нужный магазин.

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

   Примечание

   Если вы не использовали API-ключ до этого, сначала его необходимо выпустить. О том, как это сделать, читайте в разделе Выпуск API-ключа.

5. На странице Сайт для получения уведомлений об оплатах укажите Callback URL: https://#DOMAIN#/bitrix/services/yandexpay.pay/trading/, где #DOMAIN# — адрес сайта в Битриксе.

Добавление платежной системы

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

2. Заполните основные параметры платежной системы:

   Параметр	Значение
   Обработчик	Яндекс Пэй (yandexpay)
   Название	Яндекс Пэй
   Доступные методы оплаты на платежной форме Яндекс Пэй	Выберите Пэй и Сплит, чтобы в вашем магазине были доступны оба способа оплаты.
   Кодировка	UTF-8
   Merchant ID	Укажите Merchant ID магазина, для которого вы настраиваете платежную систему.
   API-ключ	Укажите API-ключ, полученный в личном кабинете Яндекс Пэй. Примечание Если Merchant ID и API-ключ в параметрах платежной системы уже были заполнены, нажмите ссылку Показать все, отключите опцию По умолчанию и введите новые значения.
   Время жизни ссылки (в секундах)	Укажите время, в течение которого будет действительна ссылка на оплату заказа или оставьте значение по умолчанию, включив опцию По умолчанию. Доступный диапазон значений, в секундах: от 180 до 604 800, значение по умолчанию — 1800. Примечание После того, как пользователь перешел по ссылке, на завершение оплаты дополнительно отводится 15 минут. Если в течение отведенного времени оплата не произошла, заказ считается не оплаченным.

   Остальные параметры заполните самостоятельно по необходимости.

   Если вы хотите разделить кнопки оплат для Пэй и Сплит

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

   • с названием Яндекс Пэй и методом оплаты Пэй — для Пэй;
   • с названием Яндекс Сплит и методом оплаты Сплит — для Сплит.

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

Тестирование

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

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

2. В блоке Настройка обработчика ПС нажмите ссылку Показывать все и включите опцию Тестовый режим.

3. Включите опцию Активность.

   Примечание

   Если опция Активность уже была включена, то отключите ее и установите заново.

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

5. Чтобы проверить возвраты, на административной панели 1С-Битрикс зайдите на страницу просмотра заказа через Магазин → Заказы. Подробнее о возвратах читайте в главах Полный возрат и Частичный возврат.

Если вы используете копию сайта для разработчиков, в личном кабинете Яндекс Пэй отметьте Показать настройки тестовой среды и замените доменное имя в поле Callback URL. Копия для разработчиков должна быть доступна по HTTPS-протоколу без дополнительной авторизации (например, HTTP-авторизации).

Настройка онлайн-чеков

В соответствии с 54-ФЗ магазин должен печатать онлайн-чек.

1С-Битрикс поддерживает подключение для следующих касс:

• ККМ в офисе
• 1С
• Атол.Онлайн
• Orange Data
• Бизнес.Ру

Полный список касс смотрите в документации Битрикс.

Посмотреть настроенные кассы можно через Магазин → Кассы → Список касс.

Настройте печать чеков:

1. Проверьте, что в Битрикс уже была добавлена касса, или добавьте новую.
2. На вкладке Ограничения проверьте, что отсутствует ограничение по платежным системам. Разрешите системе использовать новую платежную систему, дважды нажав на строку с ограничением.
3. Зайдите в Магазин → Настройки → Платежные системы → Яндекс Пэй и включите опцию Разрешить печать чеков.

Если касса уже была подключена к 1С или CRM, а обмен заказами настроен, вы можете продолжить печать чеков без внесения дополнительных изменений.

Настройка журнала событий

Журнал событий, связанных с заказами, доступен на странице платежной системы на вкладке Журнал Яндекс Пэй.

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

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

2. В блоке Настройка обработчика ПС на вкладке По умолчанию в поле Содержание журнала событий выберите Информация.

3. Справа от поля включите опцию По умолчанию.

4. Внизу страницы нажмите кнопку Сохранить и проверьте запись событий в журнал.

   Если события не записываются

   Если вы включили запись событий, но они не отображаются в журнале:

   1. В блоке Настройка обработчика ПС проверьте, что для всех типов плательщика справа от поля Содержание журнала событий включена опция По умолчанию.

   2. Проверьте ошибки, которые происходят до обработки запроса yandexpay.pay — настройте логирование ошибок 1С-Битрикс с 'handled_errors_types' => 20853 и проверьте лог.

Публикация

После настройки и тестирования подготовьте Яндекс Пэй к приему оплат от покупателей:

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

2. В блоке Настройка обработчика ПС нажмите ссылку Показывать все и отключите опцию Тестовый режим.

3. Включите опцию Активность.

   Примечание

   Если опция Активность уже была включена, то отключите ее и установите заново.

4. Если вы выполняли настройку на копии сайта для разработчиков, в личном кабинете Яндекс Пэй снимите переключатель Показать настройки тестовой среды, а в поле Callback URL замените доменное имя сайта.

5. Оформите заказ и выполните оплату через Яндекс Пэй. Дождитесь печати чека и выполните возврат. Подробнее о возвратах читайте в главах Полный возрат и Частичный возврат.

Если у вас возникли сложности с настройкой или замечания по проведению платежей, напишите разработчикам модуля 1С-Bitrix.

Полный возврат

Для осуществления возврата:

1. В административной панели 1С-Битрикс перейдите в окно просмотра оформленного заказа через Магазин → Заказы.
2. В разделе Оплата нажмите на статус оплаты Оплачен и выберите в выпадающем меню Возврат.
3. Во всплывающем окне в поле Вернуть на выберите Яндекс Пэй и нажмите кнопку Сохранить.
4. Проверьте значение поля Статус заказа в разделе Параметры заказа.

Частичный возврат

Для корректного оформления частичного возврата товаров:

1. Сделайте полный возврат по заказу.
2. Скопируйте старый заказ.
3. Уберите ненужные позиции и сохраните новый заказ.
4. После оплаты нового заказа напечайте чек заново.

Частые проблемы

При возникновении проблем с подключением проверьте, что следующие параметры введены верно:

• Merchant ID
• API-ключ

Если эти настройки корректны, то посмотрите список самых частых проблем и их решений:

array ( 
    'CONDITION' => '#^/bitrix/services/yandexpay.pay/trading/#', 
    'RULE' => '', 
    'ID' => '', 
    'PATH' => '/bitrix/services/yandexpay.pay/trading/index.php', 
    'SORT' => 1, 
),

public function paymentTtl(Payment payment) : int { return (int)this->getParamValue($payment, 'PAYMENT_TTL');
}

Системные настройки модуля