# Платіжний модуль Hutko для WHMCS

Офіційний модуль для прийому оплат через платіжний сервіс [Hutko](https://hutko.org/uk/).
Забезпечте своїх клієнтів зручною оплатою картками Visa/Mastercard, а також через Apple Pay та Google Pay.

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

*   🔒 **Безпечні платежі**: Обробка даних карток на стороні шлюзу.
*   🔄 **Автоматичне зарахування**: Підтримка Callback (Webhooks) для миттєвої активації послуг після оплати.
*   ↩️ **Повернення коштів (Refunds)**: Можливість робити часткове або повне повернення коштів прямо з адмін-панелі WHMCS.
*   📱 **Сумісність**: Працює з WHMCS версій 6.x, 7.x, 8.x (PHP 7.0 - 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/).