---
metadata:
- name: generator
content: Diplodoc Platform v5.52.0
alternate:
- https://pay.yandex.ru/docs/ru/cms/joomla/index.md
- href: ru/cms/joomla/index.md
type: text/markdown
title: Markdown version
- href: ../../llms.txt
type: text/markdown
title: llms.txt
title: "Плагин Яндекс\_Пэй для Joomla\_— прием платежей на сайте | Документация"
description: "Установите плагин Яндекс\_Пэй для Joomla от Яндекса. Простая интеграция платежной системы с популярной CMS."
---
> **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/ru/llms.txt
# Интеграция с Joomla
Бесплатный модуль
Модуль **Joomla** позволяет подключить прием платежей через Яндекс Пэй и Сплит на ваш сайт, созданный на базе Joomla. Модуль предоставляет [ООО «Яндекс»](https://pay.yandex.ru/business/modules?utm_source=yandex_pay_docs) **бесплатно**.
{% note warning "Совместимость версий" %}
Joomla версии 3.x совместно с компонентом VirtueMart.
{% endnote %}
## Возможности модуля {#features}
#|
|| Прием оплаты | ||
|| Полный возврат |  ||
|| Частичный возврат |  ||
|| Тестовый режим | ||
|| Синхронизация статуса оплаты | ||
|| Бейджи Яндекс Пэй / Сплит |  ||
|| Виджеты Яндекс Пэй / Сплит |  ||
|| Контроль наличия товара |  ||
|| Получение прямого QR | Неприменимо ||
|| Получение обратного QR | Неприменимо ||
|#
## Шаг 1. Регистрация в Яндекс Пэй {#registration-ya-pay}
1. [Зарегистрируйтесь](https://pay.yandex.ru/docs/ru/console/registration.md) в личном кабинете Яндекс Пэй и [подайте заявку](https://pay.yandex.ru/docs/ru/console/registration.md#application) на подключение сервиса Яндекс Пэй и Сплит в ваш магазин.
1. Дождитесь одобрения заявки и подключения сервиса.
1. В [личном кабинете Яндекс Пэй](https://console.pay.yandex.ru) выберите в [селекторе](*selector) ваш магазин и перейдите в раздел **Настройки**.
1. В блоке **Подключение** нажмите **Выпустить ключ Merchant API**, скопируйте и сохраните значение выпущенного ключа.
{% cut "Где выпустить ключ API" %}
{.c-screenshot width=500px}
{% endcut %}
Также скопируйте и сохраните значение **Merchant ID**. Эти данные понадобятся вам при дальнейшей настройке.
{% cut "Где найти Merchant ID" %}
{.c-screenshot width=500px}
{% endcut %}
## Шаг 2. Установка плагина {#setup}
{% note warning %}
Перед установкой плагина убедитесь, что ваш сайт соответствует [системным требованиям](https://pay.yandex.ru/docs/ru/custom/web-sdk/index.md#requirements) для подключения Яндекс Пэй и Сплит.
В случае если сайт не соответствует требованиям, плагин работать не будет — вы можете воспользоваться личным кабинетом, чтобы создать [ссылку на оплату](https://pay.yandex.ru/docs/ru/console/create-link.md#console-create) вручную.
{% endnote %}
1. Скачайте архив с плагином с [маркетплейса Joomla](https://extensions.joomla.org/extension/e-commerce/payment-gateway/yandex-pay-and-split/) или по [ссылке](https://yandex-pay-cms.s3.yandex.net/joomla/pkg_yandex_pay_and_split.zip).
1. В административной панели Joomla перейдите в раздел **Расширения** → **Установка**.
{.c-screenshot}
1. На вкладке **Загрузить файл пакета** загрузите скачанный установочный архив и дождитесь окончания загрузки.
## Шаг 3. Настройка плагина {#settings}
1. Перейдите в раздел **Плагины** и выберите в списке расширений плагин **Yandex Pay and Split**, чтобы перейти на страницу включения плагина.
1. В открывшемся окне включите плагин и настройте для него значения в полях:
- **Доступ** — права доступа к плагину;
- **Порядок** — порядок, в котором плагин будет отображаться в списке платежных плагинов.
{.c-screenshot}
1. Добавьте новый способ оплаты — откройте раздел **VirtueMart** → **Способы оплаты** и нажмите кнопку **Создать**.
{.c-screenshot}
1. В открывшемся окне заполните данные на вкладке **Способы оплаты** и нажмите кнопку **Сохранить**, чтобы перейти к настройке способа оплаты на вкладке **Конфигурация**.
{.c-screenshot}
1. Заполните данные на вкладке **Конфигурация**:
#|
|| **Раздел настроек** | **Параметр** | **Описание** ||
|| **Мерчант** / **Merchant** | Мерчант ID / Merchant ID[*](*required) | Укажите [Merchant ID](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#merchant-id) из личного кабинета Яндекс Пэй. ||
|| ^ | API-ключ / API-key[*](*required) | Укажите [API-ключ](../../console/settings-pay-split#merchant-api-keys) из личного кабинета Яндекс Пэй. ||
|| ^ | Доступные методы оплаты / Available payment methods[*](*required) | Выберите доступные методы оплаты, которые будут отображаться в платежной форме Яндекс Пэй. ||
|| **Заказы** / **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-options) кнопки оплаты. ||
|| ^ | Ширина кнопки / Button width | Выберите фиксированную или адаптивную [ширину](*button-options) кнопки оплаты. ||
|| **Другое** / **Other** | TTL | Укажите время в секундах, в течение которого пользователь может воспользоваться ссылкой на форму оплаты заказа. ||
|| ^ | Окружение / Environment | Выберите боевое или тестовое окружение. ||
|| ^ | Перенаправление на страницу при успешной оплате / On success payment redirect page | Выберите страницу, куда будет перенаправлен пользователь при успешной оплате. ||
|| ^ | Перенаправление на страницу при ошибке оплаты / On error payment redirect page | Выберите страницу, куда будет перенаправлен пользователь при ошибке оплаты в форме оплаты. ||
|| ^ | Перенаправление на страницу при отказе от оплаты / On abort payment redirect page | Выберите страницу, куда будет перенаправлен пользователь при отказе от оплаты в форме оплаты. ||
|#
\* Обязательный параметр
1. При необходимости [настройте](#badges-widgets) бейджи и виджеты Яндекс Пэй.
1. Нажмите кнопку **Сохранить**.
## Шаг 4. Тестирование оплаты {#testing-mode}
Чтобы проверить корректность обработки платежей c помощью Яндекс Пэй, включите тестовый режим:
1. В личном кабинете Яндекс Пэй:
1. Перейдите в раздел **Настройки** и в правом верхнем углу включите опцию **Тестовые данные**.
1. В блоке **Подключение** нажмите **Добавить Callback URL `Тестовый`** и укажите:
```
{url_адрес_сайта}/index.php?option=com_virtuemart&view=pluginresponse&task=pluginNotification&pm={ID_метода_оплаты}&route=
```
где:
- `{url_адрес_сайта}` — URL вашего сайта;
- `{ID_метода_оплаты}` — идентификатор способа оплаты Яндекс Пэй и Сплит из личного кабинета Joomla.
{% cut "Где найти идентификатор способа оплаты" %}
В разделе **VirtueMart** перейдите на вкладку **Способы оплаты** и скопируйте значение из столбца **Id**:
{.c-screenshot}
{% endcut %}
{% cut "Куда добавить тестовый Callback URL" %}
{.c-screenshot width=500px}
{% endcut %}
1. Нажмите кнопку **Сохранить**.
1. В интерфейсе Joomla:
1. Откройте раздел **VirtueMart** → **Способы оплаты** и перейдите в настройки добавленного способа оплаты.
1. На вкладке **Конфигурация** в разделе **Другое** для параметра **Окружение** выберите значение **Тестовое** и сохраните изменения.
1. Выполните несколько тестовых платежей и [возвратов](#refund) в вашем магазине, чтобы проверить, что плагин установлен успешно.
## Шаг 5. Переход в рабочий режим {#working-mode}
После тестирования оплаты переключите среду с тестовой на боевую:
1. В личном кабинете Яндекс Пэй:
1. Перейдите в раздел **Настройки** и отключите опцию **Тестовые данные**, чтобы скрыть тестовые настройки.
1. В блоке **Подключение** нажмите **Добавить Callback URL** и укажите:
```
{url_адрес_сайта}/index.php?option=com_virtuemart&view=pluginresponse&task=pluginNotification&pm={ID_метода_оплаты}&route=
```
где:
- `{url_адрес_сайта}` — URL вашего сайта;
- `{ID_метода_оплаты}` — идентификатор способа оплаты Яндекс Пэй и Сплит из личного кабинета Joomla.
1. В интерфейсе Joomla:
1. Откройте раздел **VirtueMart** → **Способы оплаты** и перейдите в настройки добавленного способа оплаты.
1. На вкладке **Конфигурация** в разделе **Другое** для параметра **Окружение** выберите значение **Боевое** и сохраните изменения.
Настройка модуля завершена. Теперь клиенты в вашем магазине могут оплачивать покупки при помощи Яндекс Пэй и Сплит.
{% note info %}
Если у вас остались вопросы по настройке плагина, обратитесь в нашу [службу поддержки](https://forms.yandex.ru/surveys/13490261.f4adc83a2c75b10abe163bf264af4e3842a535e0/).
{% endnote %}
## Дополнительно
### Оформление возвратов {#refund}
В административной панели Joomla вы можете оформить полный или частичный возврат средств по заказу:
1. Откройте страницу заказа, для которого необходимо оформить возврат, и перейдите в блок способа оплаты:
{.c-screenshot width=500px}
1. Выберите товары, которые требуется вернуть, укажите количество товаров или сумму для возврата и в левом нижнем углу нажмите кнопку **Оформить возврат**.
{% note info %}
Также вы можете оформить полный или частичный возврат в разделе **Платежи** [личного кабинета Яндекс Пэй](https://pay.yandex.ru/docs/ru/custom/refund-payments.md#payment-refund).
{% endnote %}
### Подключение бейджей и виджетов Яндекс Пэй {#badges-widgets}
#### Бейджи {#badges}
Бейджи Яндекс Пэй могут отображаться на странице с товарами и в карточке товара:
{% list tabs %}
- Страница с товарами
{.c-screenshot width=550px}
- Карточка товара
{.c-screenshot}
{% endlist %}
Чтобы подключить и настроить в вашем магазине бейджи Яндекс Пэй:
1. В административной панели Joomla перейдите в настройки плагина и в разделе **Бейджи** / **Badges** активируйте опцию **Включить бейджи** / **Enable badges**.
1. Настройте параметры бейджей в двух подразделах:
- **Бейджи на странице товара** / **Single page badges** — настройки бейджей на странице с товарами.
- **Бейджи в карточке** / **Card badges** — настройки бейджей в карточке товара.
#|
|| **Раздел настроек** | **Параметр** | **Описание** ||
|| **BNPL** (Сплит) | Тема / Theme | Выберите [тему](*badge-options) бейджа. ||
|| ^ | Размер / Size | Выберите [размер](*badge-options) бейджа. ||
|| ^ | Выравнивание / Align | Выровняйте бейдж. ||
|| ^ | Цвет / Color | Выберите [цвет](*badge-options) бейджа. ||
|| ^ | Вариант / Variant | Выберите [вариант](*badge-options) бейджа. ||
|| **Кешбэк** / **Cashback** | Тема / Theme | Выберите [тему](*badge-options) бейджа. ||
|| ^ | Размер / Size | Выберите [размер](*badge-options) бейджа. ||
|| ^ | Выравнивание / Align | Выровняйте бейдж. ||
|| ^ | Цвет / Color | Выберите [цвет](*badge-options) бейджа. ||
|| ^ | Вариант / Variant | Выберите [вариант](*badge-options) бейджа. ||
|#
1. Сохраните изменения.
#### Виджет {#widget}
{% note warning %}
Виджет не будет отображаться, если включены бейджи.
{% endnote %}
Виджеты Яндекс Пэй могут отображаться в карточке товара:
{.c-screenshot width=80%}
Чтобы подключить и настроить в вашем магазине виджет Яндекс Пэй:
1. В административной панели Joomla перейдите в настройки плагина и в разделе **Виджет** / **Widget** активируйте опцию **Включить виджет** / **Enable widget**.
1. Настройте параметры виджета:
#|
|| **Параметр** | **Описание** ||
|| Тема / Theme | Выберите [тему](*widget-options) виджета. ||
|| Отступы / Padding | Добавьте [отступы](*widget-options) для виджета. ||
|| Размер / Size | Выберите [размер](*widget-options) виджета. ||
|| Включить обводку / Outlined | Включите [обводку](*widget-options) у виджета. ||
|| Задний фон / Background | Выберите цвет [заднего фона](*widget-options) виджета. ||
|| Скрыть шапку / Hide header | Скройте информацию о Сплите и кешбэке в [заголовке (шапке)](*widget-options) виджета. ||
|#
1. Сохраните изменения.
[*button-options]: Как влияет значение параметра на внешний вид кнопки см. в [таблице параметров кнопки](https://pay.yandex.ru/docs/ru/custom/web-sdk/buttons#options).
[*widget-options]: Как влияет значение параметра на внешний вид виджета, см. в [таблице параметров виджета](https://pay.yandex.ru/docs/ru/custom/web-sdk/ultimate-widget#options).
[*badge-options]: Как влияет значение параметра на внешний вид бейджа, см. в [таблице параметров бейджа](https://pay.yandex.ru/docs/ru/custom/web-sdk/badges#options).
[*required]: Обязательный параметр.
[*selector]:
Выпадающий список в верхней части страницы личного кабинета Яндекс Пэй, с помощью которого можно переключаться между юридическими лицами и магазинами.
{.c-screenshot width=300px}