# Передоплата (LiqPay) для WooCommerce

Платіжний плагін для WooCommerce, що реалізує **післяплату з онлайн-передоплатою**: покупець вносить фіксовану суму передоплати через LiqPay під час оформлення замовлення, а решту сплачує при отриманні товару. Сума передоплати та ключі LiqPay налаштовуються в адмінці.

## Опис для картки товару

> **Післяплата без ризику: фіксована передоплата через LiqPay**
>
> Найбільший біль продажів із доставкою «при отриманні» — невикуплені посилки. Цей плагін вирішує проблему: покупець вносить невелику **фіксовану передоплату онлайн через LiqPay** (наприклад, 300 грн), а решту сплачує вже при отриманні. Замовлення стає підтвердженим, а кількість «забутих» відправлень падає.
>
> **Що отримує магазин:**
> – Новий спосіб оплати на чекауті — «Післяплата (передоплата онлайн)».
> – **Фіксована** сума передоплати, яку ви задаєте самі (за замовчуванням 300 грн).
> – Оплата через офіційну захищену форму LiqPay (API v3) з перевіркою підпису.
> – Автоматичне підтвердження замовлення: у примітках фіксуються сума передоплати, статус, номер транзакції та **скільки лишилося сплатити при отриманні**.
> – Тестовий режим (sandbox) для перевірки без реальних списань.
> – Повна сумісність із новим сховищем замовлень WooCommerce (HPOS).
>
> Менше невикупів, передбачуваний грошовий потік і довіра покупців — без складних інтеграцій.
>
> *Працює з гривнею (UAH). Потрібен акаунт мерчанта LiqPay (Public + Private key).*

## Можливості

– Окремий спосіб оплати «Післяплата з онлайн-передоплатою».
– Фіксована сума передоплати, що задається в налаштуваннях (за замовчуванням 300 грн); ніколи не перевищує суму замовлення.
– Оплата через офіційну форму LiqPay (Client-Server, API v3) з підписом приватним ключем.
– Server-to-server колбек із перевіркою підпису — гарантія, що статус прийшов саме від LiqPay.
– Після успішної передоплати замовлення автоматично переходить у статус оплати WooCommerce; у примітку додаються сума, статус, транзакція та залишок до сплати.
– Тестовий режим (sandbox) — без реальних списань.
– Сумісність із HPOS (Custom Order Tables).
– Захист ліцензією за моделлю «1 ключ = 1 сайт».

## Вимоги

| Параметр | Значення |
|—|—|
| WordPress | 5.5 або новіше |
| PHP | 7.2 або новіше |
| WooCommerce | 4.0 або новіше |
| Валюта магазину | гривня (UAH) |
| Доступ LiqPay | акаунт мерчанта, **Public key** + **Private key** (кабінет LiqPay → Налаштування мерчанта → API) |
| Сайт | доступний ззовні по **HTTPS** (для колбеку від LiqPay) |
| Ліцензія | дійсний ключ ліцензії від продавця плагіна |

## Встановлення

1. У панелі WordPress відкрийте **Плагіни → Додати новий → Завантажити плагін**.
2. Оберіть файл `prepayment-liqpay.zip`, натисніть **Встановити**, далі **Активувати**.
3. Перейдіть у **WooCommerce → Налаштування → Платежі**, знайдіть **«Передоплата (LiqPay)»** і натисніть **Керування**. (Швидке посилання «Налаштування» також є на сторінці плагінів.)

## Налаштування

1. **Увімкнути / Вимкнути** спосіб оплати.
2. **Назва способу оплати** — те, що бачить покупець на чекауті (це і є «кнопка» післяплати).
3. **Опис** — коротке пояснення під назвою.
4. **Сума передоплати, грн** — фіксована сума онлайн-оплати (за замовчуванням 300). Якщо вона більша за суму замовлення — спишеться рівно сума замовлення.
5. **Public key** і **Private key** — ключі з кабінету LiqPay. Приватний ключ зберігайте в таємниці.
6. **Тестовий режим (sandbox)** — увімкніть для перевірки без реальних грошей.
7. **Ключ ліцензії** — введіть отриманий ключ і збережіть зміни (активація автоматична, статус з’явиться нижче).
8. Натисніть **Зберегти зміни**.

### Колбек LiqPay

Плагін автоматично передає LiqPay адресу для server-to-server статусу виду:

“`
https://ваш-сайт/wc-api/prepayment_liqpay
“`

Окремо налаштовувати в кабінеті LiqPay зазвичай не потрібно — адреса передається в кожному запиті. Головне, щоб сайт був доступний ззовні по HTTPS і не блокувався фаєрволом/кешем.

## Активація ліцензії

Поле **«Ключ ліцензії»** — у тих самих налаштуваннях шлюзу. Введіть ключ → **Зберегти зміни**. Плагін сам звернеться до сервера ліцензій і прив’яже ваш домен до ключа.

– Статус ліцензії показано під полем (активна / неактивна, домен, час останньої перевірки).
– Кнопка **«Перевірити / активувати зараз»** — ручна перевірка.
– Кнопка **«Відв’язати цей сайт»** — звільняє ключ для переїзду на інший домен.
– Перевірка повторюється автоматично раз на добу. Якщо сервер ліцензій тимчасово недоступний — плагін продовжує працювати ще до 14 днів (грейс-період), тож короткі збої не зупиняють магазин.

> Без дійсної ліцензії спосіб оплати **не показується** покупцям на чекауті (решта сайту працює як завжди).

## Як це виглядає для покупця

1. На чекауті покупець обирає «Післяплата (передоплата онлайн)».
2. Його перенаправляє на захищену сторінку LiqPay для оплати фіксованої передоплати.
3. Після успішної оплати замовлення автоматично підтверджується; у примітці видно внесену суму та залишок до сплати при отриманні.

## Часті питання

**Чи можна задати передоплату у відсотках від суми?**
Ні, сума передоплати **фіксована** (наприклад, 300 грн). Якщо вона перевищує вартість замовлення — спишеться рівно вартість замовлення.

**Чому спосіб оплати не видно на чекауті?**
Перевірте: валюта магазину — UAH; заповнені Public + Private key; ліцензія активна (статус у налаштуваннях).

**Як перевірити роботу без реальних грошей?**
Увімкніть **Тестовий режим (sandbox)** у налаштуваннях.

**Замовлення не підтверджується після оплати.**
Це колбек: переконайтесь, що сайт доступний ззовні по HTTPS, а адреса `/wc-api/prepayment_liqpay` не блокується фаєрволом чи кешем.