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

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

:::info
**Завантажити:**
[Плагін з бібліотеки "WordPress">>](https://wordpress.org/plugins/xpay-payment-gateway/)
[GitLab "WordPress">>](https://gitlab.com/xpaygroup/wordpress)
:::

## Про плагін

Безкоштовний плагін **"XPAY Payment GateWay"** дозволяє інтегрувати прийом платежів через систему XPAY в магазинах, що розроблені на платформі WooCommerce.

## Функціональні можливості плагіну

* Проведення налаштування на тестовому середовищі XPAY з можливістю перемикання на продуктове середовище;
* Управління параметрами оплати без необхідності програмування;
* Вибір ідентифікатора клієнта при проведенні оплати (номер мобільного телефону чи пошта);
* Налаштування переадресації браузера клієнта після виконання оплати на визначену сторінку;
* Прийом "postback" з успішною оплатою;
* Відображення актуального статусу оплати.

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

Для інсталяції плагіну необхідно перейти у розділ [**"Плагіни"**](https://wordpress.org/plugins/), виконати пошук за назвою **"XPAY Payment GateWay"** та натиснути на кнопку **"Download"** для завантаження ZIP файлу з відповідним ім'ям (XPAY Payment GateWay).


Після отримання файлу необхідно в панелі адміністратора сайту перейти до розділу **"Плагіни"** -> **"Додати новий"** та натиснути на кнопку **"Завантажити плагін"**.


Наступним кроком є активація плагіну. Для цього необхідно перейти до розділу **"Плагіни"** -> **"Встановлені"** та знайти серед переліку **"XPAY Payment GateWay"**.


Активація плагіну також може бути проведена безпосередньо під час завантаження файлу, через кнопку **"Активувати плагін"**, що знаходиться в наступному повідомленні після успішного завантаження. 


Після активації плагіну необхідно перейти до розділу **"WooCommerce"** -> **"Налаштування"**. Серед варіантів налаштувань необхідно обрати **"Платежі"**, знайти у переліку метод **"XPAY"** та активувати чек-бокс.


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


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

* **Title** - назва методу оплати на сайті;
* **Description** - короткий опис методу оплати на сайті;
* **XPAY Service URL**:
- `Тестове середовище` - https://stage-mapi.xpay.com.ua/uk/frame/widget/banner-payment
- `Продуктове середовище` - https://mapi.xpay.com.ua/uk/frame/widget/banner-payment
* **XPAY Public Key** - публічний ключ XPAY продуктового чи тестового середовища для перевірки підпису;
* **Open in new windows** - дозволяє відкривати сторінку оплати у новому вікні;
* **Partner ID** - ідентифікатор Партнера у системі XPAY;
* **User identified by** - ідентифікатор клієнта, що визначає, яким чином клієнт магазину буде ідентифікований у системі XPAY: за електронною поштою або мобільним телефоном;
* **Return URL** - оберіть сторінку, на яку буде переадресовано браузер клієнта після здійснення оплати;
* **or manual link** - дозволяє вказати URL будь-якого ресурсу для переадресації браузера клієнта після здійснення оплати;
* **Show Payment info** - вказує на необхідність відображення деталізованої інформації про платіж у віджеті;
* **Payment item caption** - заголовок одиниці замовлення в деталях платежу у віджеті;
* **Service URL for Pay request** - URL обробника "postback" запиту "pay" на стороні магазину. Запит "pay" надсилається системою 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)
:::