Интеграция с Joomla

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

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

Внимание

Модуль предназначен для работы с Joomla версии 3.x совместно с компонентом VirtueMart.

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

Прием оплаты

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

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

Тестовый режим

Синхронизация статуса оплаты

Бейджи Яндекс Пэй / Сплит

Виджеты Яндекс Пэй / Сплит

Контроль наличия товара

Получение прямого QR

Неприменимо

Получение обратного QR

Неприменимо

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

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

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

  3. Нажмите Выпустить ключ Merchant API и скопируйте значение из поля Ключ.

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

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

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

Важно

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

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

  1. Скачайте архив с плагином с маркетплейса Joomla или по ссылке.

  2. В административной панели Joomla перейдите в раздел Расширения → Установка.

  3. На вкладке Загрузить файл пакета загрузите скачанный установочный архив и дождитесь окончания загрузки.

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

  1. Перейдите в раздел Плагины и выберите в списке расширений плагин Yandex Pay and Split, чтобы перейти на страницу включения плагина.

  2. В открывшемся окне включите плагин и настройте для него значения в полях:

    • Доступ — права доступа к плагину;
    • Порядок — порядок, в котором плагин будет отображаться в списке платежных плагинов.

  3. Добавьте новый способ оплаты — откройте раздел VirtueMart → Способы оплаты и нажмите кнопку Создать.

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

  5. Заполните данные на вкладке Конфигурация. Параметры, отмеченные *, обязательны для заполнения:

    Раздел настроек

    Параметр

    Описание

    Мерчант / Merchant

    Мерчант ID* / Merchant ID

    Укажите Merchant ID из личного кабинета Яндекс Пэй.

    API-ключ* / API-key

    Укажите API-ключ из личного кабинета Яндекс Пэй.

    Доступные методы оплаты* / Available payment methods

    Выберите доступные методы оплаты, которые будут отображаться в платежной форме Яндекс Пэй.

    Заказы / Orders

    Статус обрабатываемого заказа / Pending order status

    Укажите статус заказа, который выставляется при его создании.

    Статус успешного заказа / Success order status

    Укажите статус заказа, который выставляется при успешной оплате.

    Статус неуспешного заказа / Error order status

    Укажите статус заказа, который выставляется при ошибке оплаты.

    Статус возвращенного заказа / Refunded order status

    Укажите статус заказа, который выставляется при возврате оплаты.

    Статус частично возвращенного заказа / Partially refunded order status

    Укажите статус заказа, который выставляется при частичном возврате оплаты.

    Статус неуспешного заказа / Refund failed status

    Укажите статус заказа, который выставляется при возникновении ошибки в процессе возврата оплаты.

    Назначение платежа / Payment purpose

    Укажите назначение, которое будет выставляться для платежа в заказе.

    Комиссия за транзакцию / Fee per transaction

    Укажите фиксированную сумму комиссии, которая применяется к каждому заказу.

    Процент от общей суммы / Percent of the total amount

    Укажите дополнительный процент комиссии, который будет применяться к общей сумме заказа (от 0 до 100).

    Заголовок комиссии / Fee title

    Укажите название поля, где будет отображаться сумма комиссии в корзине на форме оплаты и в личном кабинете Яндекс Пэй.

    Кнопка Яндекс Пэй / Yandex Pay button

    Тема кнопки / Button theme

    Выберите тему кнопки оплаты.

    Ширина кнопки / Button width

    Выберите фиксированную или адаптивную ширину кнопки оплаты.

    Другое / Other

    TTL

    Укажите время в секундах, в течение которого пользователь может воспользоваться ссылкой на форму оплаты заказа.

    Окружение / Environment

    Выберите боевое или тестовое окружение.

    Перенаправление на страницу при успешной оплате / On success payment redirect page

    Выберите страницу, куда будет перенаправлен пользователь при успешной оплате.

    Перенаправление на страницу при ошибке оплаты / On error payment redirect page

    Выберите страницу, куда будет перенаправлен пользователь при ошибке оплаты в форме оплаты.

    Перенаправление на страницу при отказе от оплаты / On abort payment redirect page

    Выберите страницу, куда будет перенаправлен пользователь при отказе от оплаты в форме оплаты.

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

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

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

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

  2. Нажмите Добавить Callback URL Тестовый укажите:

    {url_адрес_сайта}/index.php?option=com_virtuemart&view=pluginresponse&task=pluginNotification&pm={ID_метода_оплаты}&route=

    где:

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

    • {ID_метода_оплаты} — идентификатор способа оплаты Яндекс Пэй и Сплит из личного кабинета Joomla.

      Где найти идентификатор способа оплаты

      В разделе VirtueMart перейдите на вкладку Способы оплаты и скопируйте значение из столбца Id:

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

  4. В интерфейсе Joomla откройте раздел VirtueMart → Способы оплаты и перейдите в настройки добавленного способа оплаты.

  5. На вкладке Конфигурация в разделе Другое выберите для параметра Окружение значение Тестовое и сохраните изменения.

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

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

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

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

  2. В поле Callback URL укажите:

    {url_адрес_сайта}/index.php?option=com_virtuemart&view=pluginresponse&task=pluginNotification&pm={ID_метода_оплаты}&route=

    где:

    • {url_адрес_сайта} — URL вашего сайта;
    • {ID_метода_оплаты} — идентификатор способа оплаты Яндекс Пэй и Сплит из личного кабинета Joomla.

  3. В интерфейсе Joomla откройте раздел VirtueMart → Способы оплаты и перейдите в настройки добавленного способа оплаты.

  4. На вкладке Конфигурация в разделе Другое выберите для параметра Окружение значение Боевое и сохраните изменения.

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

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

Оформление возвратов

В административной панели Joomla вы можете оформить полный или частичный возврат средств по заказу:

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

  2. Выберите товары, которые требуется вернуть, укажите количество товаров или сумму для возврата и в левом нижнем углу нажмите кнопку Оформить возврат.

Примечание

Также вы можете оформить полный или частичный возврат в разделе Платежи личного кабинета Яндекс Пэй.

Подключение бейджей и виджетов Яндекс Пэй

Бейджи

Бейджи Яндекс Пэй могут отображаться на странице с товарами и в карточке товара:

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

  1. В административной панели Joomla перейдите в настройки плагина и в разделе Бейджи / Badges активируйте опцию Включить бейджи / Enable badges.

  2. Настройте параметры бейджей в двух подразделах:

    • Бейджи на странице товара / Single page badges — настройки бейджей на странице с товарами.
    • Бейджи в карточке / Card badges — настройки бейджей в карточке товара.

    Раздел настроек

    Параметр

    Описание

    BNPL (Сплит)

    Тема / Theme

    Выберите тему бейджа.

    Размер / Size

    Выберите размер бейджа.

    Выравнивание / Align

    Выровняйте бейдж.

    Цвет / Color

    Выберите цвет бейджа.

    Вариант / Variant

    Выберите вариант бейджа.

    Кешбэк / Cashback

    Тема / Theme

    Выберите тему бейджа.

    Размер / Size

    Выберите размер бейджа.

    Выравнивание / Align

    Выровняйте бейдж.

    Цвет / Color

    Выберите цвет бейджа.

    Вариант / Variant

    Выберите вариант бейджа.

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

Виджет

Важно

Виджет не будет отображаться, если включены бейджи.

Виджеты Яндекс Пэй могут отображаться в карточке товара:

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

  1. В административной панели Joomla перейдите в настройки плагина и в разделе Виджет / Widget активируйте опцию Включить виджет / Enable widget.

  2. Настройте параметры виджета:


    Параметр

    Описание

    Тема / Theme

    Выберите тему виджета.

    Отступы / Padding

    Добавьте отступы для виджета.

    Размер / Size

    Выберите размер виджета.

    Включить обводку / Outlined

    Включите обводку у виджета.

    Задний фон / Background

    Выберите цвет заднего фона виджета.

    Скрыть шапку / Hide header

    Скройте информацию о Сплите и кешбэке в заголовке (шапке) виджета.

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

Как влияет значение параметра на внешний вид кнопки см. в таблице параметров кнопки.

Как влияет значение параметра на внешний вид виджета, см. в таблице параметров виджета.

Как влияет значение параметра на внешний вид бейджа, см. в таблице параметров бейджа.

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

Предыдущая
inSales (OmniPay)
Следующая
RetailCRM