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

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

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

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

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

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

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

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

4. В поле Callback URL в зависимости от используемой версии OpenCart укажите ссылку в формате:

   3 версия

   4 версия

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

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

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

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

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

1. Скачайте архив с плагином Яндекс Пэй и Сплит с маркетплейса OpenCart.

2. В зависимости от используемой версии OpenCart извлеките из архива папку v3 или v4 с установочным архивом.

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

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

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

   Для OpenCart 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 / Доступные методы оплаты	Выберите хотя бы один метод оплаты. По умолчанию выбраны оба метода — Яндекс Пэй и Сплит.
   Redirect URLs / Ссылки для перехода	On success redirect URL* / URL для перехода при успешной оплате	Укажите ссылку для переадресации пользователя в случае успешной оплаты.
   	On error redirect URL* / URL для перехода при ошибке оплаты	Укажите ссылку для переадресации пользователя, если возникла ошибка оплаты или срок ссылки на оплату истек.
   	On abort redirect URL / URL для перехода при отмене оплаты	Укажите ссылку для переадресации пользователя в случае, если процесс оплаты был отменен.
   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 / Ширина кнопки	Выберите фиксированную или адаптивную ширину кнопки оплаты.
   Yandex Pay badges / Бейджи Yandex Pay	Product card selector* / Селектор карточки товара	Укажите значение селектора, по которому бейдж встраивается в карточку товара.
   	Product page selector* / Селектор страницы товара	Укажите значение селектора, по которому бейдж встраивается на страницу товара.
   	Badge type / Тип бейджа	Выберите тип бейджа.
   	Badge size / Размер бейджа	Выберите размер бейджа.
   	Badge theme / Тема бейджа	Выберите тему бейджа.
   	Badge display variant / Вариант отображения бейджа	Выберите вариант отображения бейджа.
   	Badge color / Цвет бейджа	Выберите цвет бейджа.
   	Badge align / Расположение бейджа	Выберите расположение бейджа.

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

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

Как настроить селекторы

Чтобы бейджи появились в карточке или на странице товара, настройте селекторы:

1. Перейдите на сайт вашего магазина и откройте панель разработчика.

   Как открыть панель разработчика

   • Нажмите клавишу F12 на клавиатуре.
   • В Яндекс Браузере — в любом месте страницы нажмите правую кнопку мыши и в открывшейся панели выберите Исследовать элемент.

2. В верхней части открывшегося окна выберите вкладку Elements:

   

3. Слева на панели с вкладками нажмите и выберите нужный элемент на странице магазина. Вы увидите иерархическую структуру HTML-страницы, где выбранный элемент будет подсвечен.

4. Наведите указатель мыши на значение атрибута class, дважды нажмите левой кнопкой мыши и скопируйте его с помощью сочетания клавиш CTRL + С на клавиатуре.

   Пример

   Здесь значение атрибута класса для выделенного элемента равно term__value:

   

5. В настройках плагина Яндекс Пэй и Сплит вставьте скопированное значение в поле Селектор карточки товара или Селектор страницы товара и добавьте перед ним точку (без пробела), например .term__value.

6. Сохраните настройки плагина.

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

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

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

2. В поле Callback URL Тестовый в зависимости от используемой версии OpenCart укажите ссылку в формате:

   3 версия

   4 версия

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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