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

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

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

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

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

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

*Для Joomla 3:*


*Для Joomla 4:*


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

*Для Joomla 3:*


*Для Joomla 4:*


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

*Для Joomla 3:*


*Для Joomla 4:*


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

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

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

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

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

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


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

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

Телефон: [phone]
email: [e-mail]
Telegram: @xpaysupportbot
</details>
</br>

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

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

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