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

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

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

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

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

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

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

3. Нажмите кнопку Выпустить ключ, скопируйте значение из поля Ключ, а также Merchant ID. Эти данные понадобятся вам при настройке плагина в OpenCart.

4. В поле 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
   

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

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

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

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

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

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

   Для 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	Button theme / Тема кнопки	Выберите тему кнопки оплаты.
   	Button width / Ширина кнопки	Выберите фиксированную или адаптивную ширину кнопки оплаты.

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

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

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

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

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
   

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

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

4. В интерфейсе OpenCart перейдите в настройки плагина Яндекс Пэй и Сплит → вкладка Основное → Другое.

5. Включите опцию Переключить настройки на тестовый контур и сохраните изменения.

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

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

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

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

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

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

3. Выключите опцию Переключить настройки на тестовый контур.

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

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

Если у вас остались вопросы по настройке плагина, обратитесь в нашу службу поддержки.