Перейти к содержанию

Установка и настройка WHMCS для работы с биллингом HOSTKEY

В этой статье


Необходимое ПО

  • модуль реселлера для WHMCS: скачать;
  • WHMCS версия 8.8 и выше.

Подключение модуля

Распакуйте содержимое архива в корень вашей биллинговой системы.

Активация модуля в WHMCS

После копирования модуля в директорию WHMCS и настройки прав файловой системы нужно активировать модуль. Для этого:

  1. Заходим в раздел >> System Settings >> Apps & Integrations >> Addon Modules;
  2. Находим в списке модуль HOSTKEY VPS/Dedicated и включаем его, нажав на кнопку Activate;

  3. Настраиваем модуль, нажав на кнопку Configure

    • API Url - путь до биллинг-системы HOSTKEY. По умолчанию для RU-биллинга https://invapi.hostkey.ru/;
    • API key - ключ для доступа к биллинг-системе. Получаем по данной инструкции;
    • Preset name prefix - префикс для именования VPS/VDS, чтобы их можно было отличить в списке WHMCS. По умолчанию HKP-;
    • Default product group - название группы продуктов. По умолчанию Hostkey servers;
    • Access Control - список групп пользователей, имеющих доступ к данному модулю.

    Внимание

    Если не поставить галочку у группы в разделе Access Control, модуль для нее не будет доступен и не будет отображаться в меню, в том числе и для администратора.

    Если все сделано правильно (в том числе установлены права), то в меню Addons появится раздел HOSTKEY VPS/Dedicated.

  4. Заходим в раздел Addons >> HOSTKEY VPS/Dedicated и выбираем продукты для реселлинга:

    • Import VPS products - перепродажа VPS серверов;
    • Import bare metal products - перепродажа выделенных серверов;
    • Import GPU products - перепродажа GPU-серверов;

    Далее нажимаем на кнопку Activate Products.

    Примечание

    При первом запуске рекомендуем воспользоваться другим способом, поскольку при загрузке большого количества информации страница может завершиться с кодом 504. Для этого из командной строки в корне биллинга запустите команду:

    php modules/addons/hostkeyresellermod/cron.php.
    

При верном подключении и активации модуля появится сообщение об успешной загрузке продуктов HOSTKEY.

и предложение перейти к настройке конкретных продуктов в меню System Settings >> Product Services

Примечание

При большом объеме информации страница может завершиться с кодом 504 Gateway Timeout. Для первоначальной загрузки списка продуктов рекомендуем в корне биллинга запустите команду

php modules/addons/presetsload/cron.php
В любом случае информация о доступных продуктах будет запрошена с сервера HOSTKEY и загружена в БД биллинга.

Настройка конкретных продуктов для перепродажи

Перейдя в меню System Settings >> Product Services вы увидите таблицу всех доступных вам для перепродажи продуктов

Нажав на значки в крайних правых колонках вы можете изменить параметры продукта или удалить его из списка. Большая часть настроек определяется настройками WHMCS и мы остановимся только на критичных для перепродажи.

Редактирование конкретного продукта

Нажав на значок Edit вы попадаете в раздел изменения параметров Edit Product.

Вкладка Detail

На этой вкладке вы можете поменять Product Name продукта, который будет отображаться на вашей витрине.

Также выбрав чекбокс Hidden вы можете скрыть продукт из формы заказа не удаляя его.

Вкладка Price

На этой вкладке вы можете установить свою цену продукта в доступных вам валютах.

Вам доступна установка трех видов типа платежей (Payment Type):

  • Free - продукт распространяется бесплатно;
  • One Time - единовременный платеж за месяц использования;
  • Recurring - возобновляемый платеж за период.

Цена устанавливается вами для каждого периода и валюты отдельно, позволяя вам гибко регулировать политику ценообразования:

  • One Time/Monthly - единоразовый платеж или рекуррентный помесячно.
  • Quarterly - платеж раз в квартал (3 месяца)
  • Semi-Annually - платеж раз в полгода (6 месяцев)
  • Annually - платеж за год (12 месяцев)

Вам доступны две отдельные цены:

  • Setup Fee - цена за установку продукта;
  • Price - цена продажи продукта.

Внимание

Ваша цена должна быть больше показываемой в полях Price, так как иначе вы будете продавать продукт "в минус".

Изменив параметры и цену нажимаем кнопку Save Changes и сохраняем настройки для данного продукта.

После подтверждения успешного сохранения настроек, нажимаем и кнопку в правом верхнем углу Back to Product list для возврата к таблице продуктов.

После настройки продукты появляются на клиентской витрине.

Активация оплаты заказанных продуктов

Все заказанные продукты будут оплачиваться с баланса вашего аккаунта HOSTKEY. Для этого он должен иметь и у на нем должен быть включен режим автоматической оплаты с баланса.