Платіжний модуль Hutko для WHMCS
Офіційний модуль для прийому оплат через платіжний сервіс Hutko. Забезпечте своїх клієнтів зручною оплатою картками Visa/Mastercard, а також через Apple Pay та Google Pay.
📋 Можливості
- 🔒 Безпечні платежі: Обробка даних карток на стороні шлюзу.
- 🔄 Автоматичне зарахування: Підтримка Callback (Webhooks) для миттєвої активації послуг після оплати.
- ↩️ Повернення коштів (Refunds): Можливість робити часткове або повне повернення коштів прямо з адмін-панелі WHMCS.
- 📱 Сумісність: Працює з WHMCS версій 6.x, 7.x, 8.x (PHP 7.0 - 8.2).
🚀 Встановлення
-
Завантаження: Розпакуйте архів з модулем на вашому комп'ютері.
-
Завантаження на сервер: Завантажте вміст папки
modulesу кореневу директорію вашої WHMCS установки. Шлях має виглядати так:/ваш-сайт/modules/gateways/hutko.php -
Активація:
- Увійдіть в адмін-панель 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.