commit 366693ca8e65a743f5337597b07f45743f80bf0c
Author: panariga <panariga@gmail.com>
Date:   Sat Jan 24 11:44:01 2026 +0200

    Add README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..342d3aa
--- /dev/null
+++ b/README.md
@@ -0,0 +1,55 @@
+# Платіжний модуль Hutko для WHMCS
+
+Офіційний модуль для прийому оплат через платіжний сервіс [Hutko](https://hutko.org/uk/).
+Забезпечте своїх клієнтів зручною оплатою картками Visa/Mastercard, а також через Apple Pay та Google Pay.
+
+## 📋 Можливості
+
+*   🔒 **Безпечні платежі**: Обробка даних карток на стороні шлюзу (PCI DSS).
+*   🔄 **Автоматичне зарахування**: Підтримка Callback (Webhooks) для миттєвої активації послуг після оплати.
+*   ↩️ **Повернення коштів (Refunds)**: Можливість робити часткове або повне повернення коштів прямо з адмін-панелі WHMCS.
+*   📱 **Сумісність**: Працює з WHMCS версій 5.x, 6.x, 7.x, 8.x (PHP 5.3 - 8.2).
+
+## 🚀 Встановлення
+
+1. **Завантаження:**
+   Розпакуйте архів з модулем на вашому комп'ютері.
+
+2. **Завантаження на сервер:**
+   Завантажте вміст папки `modules` у кореневу директорію вашої WHMCS установки.
+   *Шлях має виглядати так:* `/ваш-сайт/modules/gateways/hutko.php`
+
+3. **Активація:**
+   *   Увійдіть в адмін-панель WHMCS.
+   *   Перейдіть у **Налаштування** (Configuration) -> **Системні налаштування** (System Settings) -> **Платіжні шлюзи** (Payment Gateways).
+   *   Знайдіть у списку **"All Payment Gateways"** модуль **hutko** та натисніть на нього для активації.
+
+## ⚙️ Налаштування
+
+Після активації модуля введіть наступні дані, які ви отримали від менеджера Hutko:
+
+*   **Merchant ID**: Ідентифікатор вашого магазину.
+*   **Secret Key**: Секретний ключ для підпису запитів.
+*   **Select Default Currency**: Оберіть валюту, в якій працює ваш мерчант-акаунт (наприклад, UAH).
+
+Натисніть **Save Changes** (Зберегти зміни).
+
+### Callback URL (Webhook)
+Модуль автоматично передає необхідний Callback URL при кожному платежі.
+Однак, якщо менеджер Hutko вимагає вказати URL для сповіщень вручну в налаштуваннях кабінету, використовуйте це посилання:
+
+`https://ваш-домен-whmcs.com/modules/gateways/callback/hutko.php`
+
+## 🛠 Вирішення проблем
+
+**Помилка "Invalid hutko signature"**
+Переконайтеся, що `Secret Key` скопійовано без зайвих пробілів. Якщо проблема не зникає, перевірте логи шлюзу:
+*Адмін-панель -> Billing -> Gateway Log*.
+
+**Рахунок оплачено, але в WHMCS статус "Unpaid"**
+Перевірте, чи доступний ваш сайт ззовні для серверів Hutko (чи не блокує Firewall вхідні POST-запити на файл `callback/hutko.php`).
+
+---
+
+**Технічна підтримка**
+Якщо у вас виникли питання щодо інтеграції, зверніться до підтримки на сайті [hutko.org](https://hutko.org/uk/).
\ No newline at end of file