=== Mono Acquiring for WooCommerce ===
Contributors: catcode
Tags: woocommerce, payment gateway, monobank, acquiring, ukraine
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Приймання оплати карткою через еквайринг monobank: створення рахунку, редірект на сторінку оплати, підтвердження замовлення вебхуком з перевіркою підпису.

== Description ==

Платіжний шлюз для WooCommerce, що інтегрує **Monobank Acquiring** (еквайринг monobank).

Можливості:

* Створення рахунку та перенаправлення покупця на захищену сторінку оплати monobank.
* Автоматичне підтвердження замовлення через вебхук з перевіркою **ECDSA-підпису** (X-Sign).
* Резервний запит статусу при поверненні покупця (на випадок затримки вебхука).
* Повернення коштів (повне та часткове) прямо з адмінки WooCommerce — Pro.
* Двоетапна оплата (hold): блокування коштів і списання при переведенні замовлення у статус «Виконано» — Pro.
* Журнал платежів зі звіркою статусу в один клік, збереження картки (оплата в 1 клік) і автофіскалізація — Pro.
* Передача складу кошика (basketOrder) для чеків/фіскалізації.
* Підтримка класичного та блокового (Checkout Blocks) чекауту, сумісність з HPOS.
* Тестовий режим з окремим тестовим токеном — можна перевірити інтеграцію без договору.

= Токен =

Бойовий токен видається у кабінеті мерчанта monobank після підписання договору.
Тестовий токен створюється безкоштовно на https://api.monobank.ua/ (кнопка «Створити тестовий токен»).

== Installation ==

1. Завантажте плагін у `/wp-content/plugins/` та активуйте.
2. WooCommerce → Налаштування → Платежі → **Mono Acquiring**.
3. Увімкніть, вставте токен (тестовий або бойовий), збережіть.
4. URL вебхука встановлюється автоматично при кожному платежі.

== Frequently Asked Questions ==

= Чи потрібен договір з monobank? =
Для реальних платежів — так. Для тесту достатньо безкоштовного тестового токена.

= Які валюти підтримуються? =
Основна — гривня (UAH). Також обробляються USD та EUR за наявності у мерчанта.

= Free і Pro =

Базове приймання оплат працює безкоштовно і без обмежень за часом. Pro-можливості
(журнал платежів, повернення з адмінки, двоетапна оплата hold, збереження картки,
автофіскалізація) вмикаються ключем ліцензії з catcode.com.ua. Пробний період на
7 днів видається **тільки за вашим кліком** — нічого не вмикається саме собою і
не гасне потім без попередження.

== Changelog ==

= 1.1.0 =
* Free = free: свіжий інстал більше не вмикає Pro сам. Пробний період стартує лише кліком «Спробувати Pro 7 днів» — e-mail, справжній ключ, активація як при покупці.
* Ліцензія перевіряється на сервері CatCode (`/license`, `/trial`) з пільговим періодом 14 днів; раніше Pro відкривався будь-яким непорожнім рядком у полі ключа.
* Pro-можливості лишаються видимими на своїх місцях — сірими, з бейджем «Pro» і рядком, що саме вони дають.
* Журнал платежів більше не зникає з меню без ліцензії.
* Один ненавʼязливий нотіс після першої успішної дії, який закривається назавжди.
* Кнопка «Перевірити токен» — живий запит до monobank прямо з налаштувань.
* Токени мерчанта зберігаються у БД зашифровано і більше не калічаться при збереженні форми.
* Виправлено: гонка вебхука й повернення покупця могла провести оплату двічі.
* Виправлено: пізній колбек «processing» затирав кінцевий статус рахунку.
* Виправлено: часткове повернення закривало замовлення як повністю повернене.
* Виправлено: валюта рахунку бралася з магазину, а сума — із замовлення.

= 1.0.0 =
* Перший реліз: створення рахунку, вебхук з перевіркою підпису, повернення коштів, hold, підтримка Blocks та HPOS.
