=== Hutko for WooCommerce ===
Contributors: catcode
Tags: hutko, payment, gateway, пумб, оплата частинами
Requires at least: 5.6
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Приймання оплати карткою і оплати частинами ПУМБ через Hutko: редірект на захищену сторінку оплати, автопідтвердження замовлення через server_callback-вебхук з перевіркою SHA1-підпису, звірка статусу та повернення коштів з адмінки.

== Description ==

Платіжний шлюз Hutko для WooCommerce.

**Безкоштовно:**

* Оплата карткою Visa/Mastercard, Apple Pay, Google Pay через захищену сторінку Hutko.
* Окремий спосіб «Оплата частинами ПУМБ»: покупець одразу бачить розстрочку від ПУМБ (3–24 платежі, підтвердження в застосунку ПУМБ), магазин отримує всю суму. Показується лише для замовлень у гривнях у межах мінімальної та максимальної суми (типово 500–300 000 грн).
* Автоматичне підтвердження замовлення через server_callback-вебхук (SHA1-підпис).
* Звірка статусу транзакції при поверненні покупця (Status API).
* Тестовий режим на публічному мерчанті `1700002` — працює одразу, без договору.
* Підтримка класичного та блокового (Gutenberg) чекауту.
* Валюти UAH, USD, EUR, GBP, CZK.

**Pro (ліцензія catcode.com.ua):**

* Повернення коштів (повне/часткове) прямо з картки замовлення (Reverse API).
* Двоетапна оплата: блокування (preauth) + списання (capture) при виконанні замовлення.
* Журнал платежів з ручною звіркою статусу.

== Installation ==

1. Завантажте плагін у `/wp-content/plugins/` і активуйте.
2. WooCommerce → Налаштування → Оплата → Hutko.
3. Для тесту лишіть «Тестовий режим» увімкненим. Для бойового — вимкніть і впишіть Merchant ID + Secret key з кабінету Hutko.
4. Оплата частинами ПУМБ: потрібні бізнес-рахунок у ПУМБ і заявка в підтримку hutko на підключення послуги. Потім WooCommerce → Налаштування → Оплата → «Hutko — оплата частинами ПУМБ» → Увімкнути. Merchant ID і ключ беруться з основного методу Hutko.
5. У кабінеті Hutko немає потреби вручну вказувати server_callback_url — плагін передає його при кожному платежі.

== Changelog ==

= 1.2.1 =
* Security: stored API keys are now encrypted with AES-256 (OpenSSL) instead of the old XOR obfuscation, which some hosting antivirus scanners flagged and deleted. Keys saved by earlier versions keep working.

= 1.2.0 =
* Новий спосіб оплати «Оплата частинами ПУМБ»: окремий пункт на чекауті (класичному і блоковому), сторінка Hutko відкривається одразу з розстрочкою ПУМБ.
* Межі суми для розстрочки в налаштуваннях; метод ховається для інших валют і сум поза межами, а змінений після завантаження кошик перевіряється ще раз перед оплатою.
* Якщо оплату частинами на мерчанті ще не підключено, покупець бачить зрозуміле повідомлення замість загальної помилки.
* Повернення з Hutko, поки покупець підтверджує розстрочку в застосунку ПУМБ, веде на сторінку «Дякуємо», а не на «Оплату не завершено»; у замовленні зʼявляється примітка про очікування.
* Журнал платежів показує і платежі частинами; метод оплати Hutko зберігається в замовленні.

= 1.1.1 =
* Подвійне «оплату отримано» на магазинах із HPOS: скидання класичного кешу замовлень там не діє — WooCommerce тримає власний OrderCache, тож кожен колбек перечитував докалбекову копію і проводив оплату вдруге.

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

= 1.0.0 =
* Перший реліз.
