Интеграция с OpenCart (Яндекс)

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

Модуль OpenCart позволяет подключить прием платежей через Яндекс Пэй и Сплит на ваш сайт, созданный на базе OpenCart. Модуль предоставляет ООО «Яндекс» бесплатно.

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

* Возврат доступен в разделе Платежи личного кабинета Яндекс Пэй.

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

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

2. Дождитесь одобрения заявки и подключения сервиса.

3. В личном кабинете Яндекс Пэй выберите в селекторе ваш магазин и перейдите в раздел Настройки.

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

   Где выпустить ключ API

   

   Также скопируйте и сохраните значение Merchant ID. Эти данные понадобятся вам при дальнейшей настройке.

   Где найти Merchant ID

   

Шаг 2. Установка плагина

1. Скачайте архив с плагином Яндекс Пэй и Сплит с маркетплейса OpenCart — в зависимости от используемой версии OpenCart выберите Plugin_V2, Plagin_V3 или Plugin_V4 для 2, 3 или 4 версии соответственно.

   Используемая версия OpenCart указана в административной панели внизу каждой страницы.

2. В интерфейсе OpenCart перейдите в раздел Установка расширений и нажмите кнопку Загрузить. Выберите скачанный установочный архив и дождитесь окончания загрузки.

3. Для OpenCart 4 версии — дополнительно после загрузки установочного архива найдите загруженный плагин Яндекс Пэй и Сплит и в строке с плагином нажмите Активировать.

   Для OpenCart 2 и 3 версии активация не требуется.

Шаг 3. Настройка плагина

1. В интерфейсе OpenCart перейдите в раздел Расширения и в выпадающем списке выберите тип расширения Оплата.

2. В списке расширений найдите плагин Яндекс Пэй и Сплит и нажмите Редактировать.

3. В открывшемся окне укажите параметры:

   Раздел настроек	Параметр	Описание
   Вкладка General / Основное
   Opencart	Status / Статус	Статус плагина. Отвечает за включение/выключение плагина.
   	Sort order / Порядок сортировки	Позиция Яндекс Пэй в списке методов оплаты при оформлении заказа. Чтобы метод отображался в списке первым, укажите 0, вторым — 1 и т. д.
   Merchant	Merchant ID*	Укажите Merchant ID из личного кабинета Яндекс Пэй.
   	API-key / API-ключ*	Укажите API-ключ из личного кабинета Яндекс Пэй.
   	Available payment methods / Доступные методы оплаты	Выберите хотя бы один метод оплаты. По умолчанию выбраны оба метода — Яндекс Пэй и Сплит.
   Other / Другое	Enable the test environment? / Переключить настройки на тестовый контур?	Параметр для включения/выключения тестового окружения.
   	Time to live of the payment form / Время на оплату (время жизни, ttl)	Укажите время, в течение которого пользователь может воспользоваться ссылкой на форму оплаты заказа.
   Вкладка Orders / Заказы
   Statuses / Статусы	Pending order status / Статус обрабатываемого заказа	Укажите статус заказа, который выставляется при его создании.
   	Success order status / Статус успешного заказа	Укажите статус заказа, который выставляется при успешной оплате.
   	Error order status / Статус неуспешного заказа	Укажите статус заказа, который выставляется при ошибке оплаты.
   Other / Другое	Payment purpose / Назначение платежа	Укажите назначение, которое будет выставляться для платежа в заказе.
   Вкладка Design / Дизайн
   Yandex Pay button / Кнопка Yandex Pay	Use the Yandex Pay button / Использовать кнопку Yandex Pay	Выберите режим использования кнопки оплаты Yandex Pay: Enabled / Включен — на сайте отображается кнопка оплаты Yandex Pay; Disabled / Выключен — на сайте отображается стандартная кнопка от OpenCart.
   	Button theme / Тема кнопки	Выберите тему кнопки оплаты Yandex Pay.
   	Button width / Ширина кнопки	Выберите фиксированную или адаптивную ширину кнопки оплаты Yandex Pay.

   * Обязательный параметр

4. Нажмите Применить.

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

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

1. В личном кабинете Яндекс Пэй:

   1. Перейдите в раздел Настройки и в правом верхнем углу включите опцию Тестовые данные.

   2. В блоке Подключение нажмите Добавить Callback URL Тестовый и в зависимости от используемой версии OpenCart укажите ссылку в формате:

      2–3 версия

      4 версия

      {url_адрес_сайта}/index.php?route=extension/payment/ya_pay_api
      

      {url_адрес_сайта}/index.php?route=extension/ya_pay/payment/ya_pay_api
      

      где {url_адрес_сайта} — URL вашего сайта.

      Используемая версия OpenCart указана в административной панели внизу каждой страницы.

      Куда добавить тестовый Callback URL

      

   3. Нажмите кнопку Сохранить.

2. В интерфейсе OpenCart перейдите в настройки плагина Яндекс Пэй и Сплит → вкладка Основное → Другое и включите опцию Переключить настройки на тестовый контур.

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

   Для тестирования возврата платежей используйте раздел Платежи личного кабинета.

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

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

1. В личном кабинете Яндекс Пэй:

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

   2. В блоке Подключение нажмите Добавить Callback URL и в зависимости от используемой версии OpenCart укажите ссылку в формате:

      2–3 версия

      4 версия

      {url_адрес_сайта}/index.php?route=extension/payment/ya_pay_api
      

      {url_адрес_сайта}/index.php?route=extension/ya_pay/payment/ya_pay_api
      

      где {url_адрес_сайта} — URL вашего сайта.

      Используемая версия OpenCart указана в административной панели внизу каждой страницы.

2. В интерфейсе OpenCart перейдите в настройки плагина Яндекс Пэй и Сплит → вкладка Основное → раздел Другое и выключите опцию Переключить настройки на тестовый контур.

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