55 lines
3.7 KiB
Markdown
55 lines
3.7 KiB
Markdown
# Платіжний модуль 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/). |