# Предоплата (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` не блокируется файерволом или кэшем.