# ПриватБанк — Оплата частинами (PayParts) для WooCommerce
Платіжний плагін для WooCommerce, що додає окремий спосіб оплати **«Оплата частинами / Миттєва розстрочка»** від ПриватБанку (сервіс `payparts2`). Покупець обирає кількість платежів прямо на сторінці оформлення замовлення, а калькулятор ПриватБанку одразу показує орієнтовний щомісячний платіж.
## Опис для картки товару
> **Оплата частинами від ПриватБанку — прямо у вашому WooCommerce**
>
> Дайте покупцям змогу купувати зараз, а платити рівними частинами. Плагін підключає офіційний сервіс ПриватБанку «Оплата частинами / Миттєва розстрочка» (payparts2) окремою кнопкою на чекауті — це **не** «Оплата частинами» всередині LiqPay, а самостійний платіжний шлюз.
>
> **Що отримує магазин:**
> – Окремий спосіб оплати «Оплата частинами» на сторінці замовлення.
> – Покупець сам обирає кількість платежів (від 1 до 25 — межі задаєте ви).
> – Орієнтовний платіж за місяць рахується вбудованим калькулятором ПриватБанку в реальному часі.
> – Два режими роботи: **PP** — «Оплата частинами» (комісію сплачує продавець, гроші надходять одразу) та **II** — «Миттєва розстрочка» (комісію сплачує покупець).
> – Повернення коштів (повне або часткове) прямо з картки замовлення WooCommerce.
> – Надійне підтвердження оплати через server-to-server колбек із перевіркою підпису.
> – Повна сумісність із новим сховищем замовлень WooCommerce (HPOS).
>
> Збільшуйте середній чек і конверсію — розстрочка знижує бар’єр для дорогих покупок.
>
> *Працює з гривнею (UAH). Потрібен договір із ПриватБанком на сервіс «Оплата частинами» та дані магазину (Store ID + Password) з кабінету payparts2.*
## Можливості
– Окремий платіжний шлюз ПриватБанк PayParts (payparts2 API), незалежний від LiqPay.
– Вибір кількості платежів покупцем на чекауті; нижня та верхня межі налаштовуються (банк дозволяє 1–25).
– Орієнтовний щомісячний платіж через офіційний калькулятор ПриватБанку.
– Режими **PP** (Оплата частинами) та **II** (Миттєва розстрочка).
– Повернення коштів через `/payment/decline` (повне або часткове) з адмінки WooCommerce.
– Server-to-server колбек із перевіркою підпису SHA-1.
– Логування запитів/відповідей у **WooCommerce → Статус → Журнали** (джерело `payparts`).
– Сумісність із HPOS (Custom Order Tables).
– Захист ліцензією за моделлю «1 ключ = 1 сайт».
## Вимоги
| Параметр | Значення |
|—|—|
| WordPress | 6.0 або новіше |
| PHP | 7.4 або новіше |
| WooCommerce | 7.0 або новіше |
| Валюта магазину | гривня (UAH) |
| Сума замовлення | від 300 до 5 000 000 грн |
| Доступ ПриватБанку | договір на сервіс «Оплата частинами», **Store ID** + **Password** із кабінету `payparts2.privatbank.ua/ipp/admin` |
| Сайт | доступний ззовні по **HTTPS** (для колбеку від банку) |
| Ліцензія | дійсний ключ ліцензії від продавця плагіна |
## Встановлення
1. У панелі WordPress відкрийте **Плагіни → Додати новий → Завантажити плагін**.
2. Оберіть файл `payparts-woocommerce.zip`, натисніть **Встановити**, далі **Активувати**.
3. Перейдіть у **WooCommerce → Налаштування → Платежі**, знайдіть **«ПриватБанк — Оплата частинами (PayParts)»** і натисніть **Керування**.
## Налаштування
1. **Увімкнути** спосіб оплати.
2. **Назва** та **Опис** — текст, який бачить покупець на чекауті.
3. **Store ID** і **Password** — дані вашого магазину з кабінету payparts2.
4. **Recipient ID** — за потреби (для повернень, якщо одержувач не основний; зазвичай можна лишити порожнім).
5. **Тип сервісу** — PP або II (див. опис вище).
6. **Мінімум / Максимум платежів** — межі вибору для покупця (у діапазоні 1–25).
7. **Логування** — увімкніть на час налагодження.
8. **Ключ ліцензії** — введіть отриманий ключ і збережіть зміни (активація відбудеться автоматично, статус з’явиться нижче).
9. Натисніть **Зберегти зміни**.
### Колбек ПриватБанку (обов’язково)
У налаштуваннях плагіна показано **URL для колбеку** виду:
“`
https://ваш-сайт/?wc-api=wc_payparts
“`
Цю адресу потрібно вказати в кабінеті payparts2, а **IP-адреси ПриватБанку** додати до довірених на вашому фаєрволі/хостингу. URL має бути доступний ззовні без авторизації та кешування — інакше банк не зможе підтвердити оплату.
## Активація ліцензії
Поле **«Ключ ліцензії»** — у тих самих налаштуваннях шлюзу. Введіть ключ → **Зберегти зміни**. Плагін сам звернеться до сервера ліцензій і прив’яже ваш домен до ключа.
– Статус ліцензії показано під полем (активна / неактивна, домен, час останньої перевірки).
– Кнопка **«Перевірити / активувати зараз»** — ручна перевірка.
– Кнопка **«Відв’язати цей сайт»** — звільняє ключ для переїзду на інший домен.
– Перевірка повторюється автоматично раз на добу. Якщо сервер ліцензій тимчасово недоступний — плагін продовжує працювати ще до 14 днів (грейс-період), тож короткі збої не зупиняють магазин.
> Без дійсної ліцензії спосіб оплати **не показується** покупцям на чекауті (решта сайту працює як завжди).
## Як це виглядає для покупця
1. На чекауті покупець обирає «Оплата частинами», задає кількість платежів і бачить орієнтовний платіж/міс.
2. Після оформлення його перенаправляє на захищену сторінку ПриватБанку для підтвердження розстрочки.
3. Після підтвердження банк надсилає колбек, замовлення автоматично позначається як оплачене.
## Часті питання
**Чим це відрізняється від «Оплати частинами» в LiqPay?**
Це окремий сервіс ПриватБанку (payparts2) з власним API та кабінетом. Кнопка на чекауті — самостійна, не пов’язана з LiqPay.
**Чому спосіб оплати не видно на чекауті?**
Перевірте: валюта магазину — UAH; сума в кошику в межах 300–5 000 000 грн; заповнені Store ID + Password; ліцензія активна (статус у налаштуваннях).
**Не приходить підтвердження оплати.**
Зазвичай це колбек: переконайтесь, що URL колбеку доступний ззовні по HTTPS і IP ПриватБанку в довірених. Увімкніть логування й перевірте **WooCommerce → Статус → Журнали** (джерело `payparts`).