whmcs/hutko-whmcs-module
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a0602080e0e62d1572a5474f0131bac31c3e978f
hutko-whmcs-module/README.md
panariga 366693ca8e Add README.md
2026-01-24 11:44:01 +02:00

3.7 KiB
Raw Blame History

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

Офіційний модуль для прийому оплат через платіжний сервіс Hutko. Забезпечте своїх клієнтів зручною оплатою картками 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.