---
# System prepended metadata

title: Налаштування плагіна Joomla

---

УКР | [ENG](https://hackmd.io/1XXGyaDXSVqd3sEeNp4ykw)
![](https://i.imgur.com/ULmPUgP.jpg)
:arrow_left: [На Головну](/Mj2ZqCVpSq6A6Jzm6ladlw)

# Налаштування плагіна Joomla

:::info
**Завантажити:**
[GitLab "Joomla!"](https://gitlab.com/xpaygroup/joomla)
:::

## Інсталяція

Встановлення аддону для прийому платежів через систему XPAY у магазині **"JoomShopping"** відбувається через розділ **"Встановлення та оновлення"**.

Необхідно обрати файл архіву аддону та натиснути на кнопку **"Завантажити"**.

*Для Joomla 3:*

![](https://i.imgur.com/BXJ6lLN.png)

*Для Joomla 4:*

![](https://i.imgur.com/7U62DM3.png)


Після встановлення аддону необхідно перейти до розділу **"JoomShopping"** -> **"Методи оплати"**, де буде відображатись встановлений метод оплати.

*Для Joomla 3:*

![](https://i.imgur.com/5QgdZWw.png)

*Для Joomla 4:*

![](https://i.imgur.com/Pwkwx7S.png)

Для використання плагіну та можливості прийому платежів необхідно завершити конфігурацію, натиснувши кнопку **"Редагування методу оплати/XPAY"**, та перейти до параметрів.


*Для Joomla 3:*

![](https://i.imgur.com/ypomDFt.png)

*Для Joomla 4:*

![](https://i.imgur.com/Xm5Pby0.png)


## Параметри налаштувань XPAY

* **Test mode** - налаштування режиму роботи аддону. Якщо обрано тестовий режим - платежі не будуть прийматись, застосовується для тестування роботи аддону у вашому магазині. Ви зможете перейти на оплату через XPAY та ввести тестові дані, наприклад:
    - картка `888 8888 8888 8888`
    - дата `12/29`
    - CVV `111`
    Необхідно обрати відповідь, що віддає XPAY: успіх або скасування. Реальної оплати не відбудеться, але ви можете перевірити роботу аддону та переглянути, чи змінюється статус замовлення і як саме. Якщо у тестовому режимі все коректно працює, ви можете переключитись у робочий режим та почати приймати оплати через сервіс XPAY.
* **Токен (PID)**  - ідентифікатор вашого магазину у системі XPAY, який ви отримаєте у сервісі XPAY. Обов'язковий параметр.
* **Ідентифікатор клієнта** – параметр, що визначає, яким чином клієнт магазину буде ідентифікований у системі XPAY: за електронною поштою або мобільним телефоном. Рекомендуємо обирати "email" тому, що він обов’язковий при замовленні. Якщо ви обрали телефон - включіть його у налаштуваннях "JoomShopping" в адресі доставки та зробіть обов’язковим.
* **Вміст PaymentInfo** – заголовок одиниці замовлення в деталях платежу: номер замовлення або перелік товарів у замовленні. Зверніть увагу, якщо у замовленні буде платна доставка, її буде включено, як окремий товар/послугу до переліку товарів.
* **Статус замовлення для незавершених транзакцій** – статус, який буде призначено для замовлень, які ще не сплачені. Зазвичай, дефолтний статус "Очікує оплати".
* **Статус замовлення для успішних транзакцій** - статус, який буде призначено для замовлень, за якими успішно здійснено оплату на сервісі XPAY. Зазвичай, дефолтний статус "Сплачено".
* **Статус замовлення для неуспішних транзакцій** - статус, який буде призначено для замовлень, за якими оплату не здійснено або скасовано на сервісі XPAY. Зазвичай, дефолтний статус "Скасовано".


## Оформлення замовлення

Після виконання всіх налаштувань для клієнта при оформленні замовлення на сайті буде відображатись варіант оплати через **"XPAY"**. 

Натискаючи кнопку **"Оформити"**, клієнт буде переходити до платіжної сторінки з деталями замовлення та реквізитами оплати. 

Інформація про актуальний статус оплати відображається у розділі **"Замовлення"**. 

![](https://i.imgur.com/HwRdFQr.jpg)


## Cлужба підтримки XPAY

<details>
<summary>Контакти</summary>
</br>

Телефон: +38 (096) 099 20 59
email: info@xpay.com.ua
Telegram: @xpaysupportbot
</details>
</br>

:::info
**Навігація по API:**

:bookmark_tabs: [XPAY API Зміст](/Mj2ZqCVpSq6A6Jzm6ladlw)

:arrow_left: [Інтеграція Checkout через CMS плагіни](https://hackmd.io/rNPV-bbERBWrsr0ut8tcnA)
:::











