Реселлерам и студиям

Модули ZRAZU для WHMCS

Как реселлеру установить модули «ZRAZU Domains» и «ZRAZU SSL» в WHMCS: скачать архив, проверить в песочнице, выпустить ключ для боевого режима.

Для WHMCS у нас готовы два модуля. «ZRAZU Domains» продаёт домены через EPP (модуль регистратора). «ZRAZU SSL» продаёт сертификаты через API (серверный модуль). Их можно ставить вместе или по одному.

Модули доступны реселлерам после договора: как стать реселлером. Всё ниже делается в разделе «Реселлер» кабинета, его видят владелец, администратор и техник.

Что понадобится

  • Действующий договор реселлера и логин песочницы EPP: подключение EPP.
  • Доступ к серверу WHMCS и его исходящий адрес IP (его нужно добавить к логину).
  • Для SSL: SSL в вашем договоре. Если он ещё не подключён, напишите менеджеру.

Шаг 1. Скачайте архив

  1. В разделе «Реселлер» найдите блок «Модули WHMCS».
  2. Выберите архив под свою версию: есть пакет для WHMCS 8 и новее (PHP 8.1+) и пакет для WHMCS 7.4–8.x на PHP 7.0–8.3.
  3. Нажмите «Скачать» и сверьте контрольную сумму с той, что показана рядом.

Архив закрытый: не публикуйте его и не передавайте третьим лицам. В нём оба модуля, их README, журнал изменений и инструкция EPP. Каждая загрузка записывается в журнал организации.

Шаг 2. Модуль «ZRAZU Domains»

  1. Распакуйте архив и скопируйте содержимое папки zrazu-domains/ в корень WHMCS.
  2. В WHMCS откройте «Система» → «Настройки» → «Регистраторы доменов» и активируйте «ZRAZU Domains».
  3. Впишите адрес EPP, логин и пароль, включите тестовый режим. Адрес и логин берите из раздела «Подключение EPP».
  4. Проверьте регистрацию, продление, перенос и удаление. Песочница отвечает на эти команды кодом 1001, а итог приходит в poll примерно через 30 секунд.
  5. Когда проверка пройдена, в WHMCS на странице цен на домены выберите «ZRAZU Domains» для нужных зон и переключите модуль на боевой логин, который вам заведёт менеджер.

Шаг 3. Модуль «ZRAZU SSL»

Сначала проверьте его в песочнице. Там те же права и ответы, что и в рабочем режиме, но деньги тестовые, а сертификаты от недоверенного тестового центра.

  1. Скопируйте содержимое папки zrazu-ssl/ в корень WHMCS вместе с хуком includes/hooks/zrazussl.php.
  2. В разделе «Реселлер» найдите блок «Тестовый ключ — песочница SSL». Укажите адреса сервера WHMCS и нажмите «Тестовый ключ». Скопируйте ключ сразу: больше мы его не покажем.
  3. В WHMCS: «Серверы» → Add New Server, тип «ZRAZU SSL». Впишите адрес API песочницы (он указан в блоке «Инструкция по интеграции») и ключ в поле Password. Нажмите Test Connection.
  4. Создайте товар типа Other, модуль «ZRAZU SSL», режим оплаты «По договору».
  5. Пройдите проверки из README модуля, в том числе имена-триггеры отказов.

Шаг 4. Боевой ключ для SSL

  1. В блоке «SSL по договору и модуль WHMCS» укажите адреса сервера вашего WHMCS: по одному в строке, публичные IPv4 или IPv6, сеть не шире /24 и /64.
  2. По желанию дайте ключу название и задайте дневной лимит трат в гривнах: сколько модуль может потратить с баланса за сутки. Сверх лимита заказы отклоняются с причиной. Изменить лимит можно новым ключом.
  3. Нажмите «Выпустить ключ «Модуль WHMCS (SSL)»».
  4. Скопируйте ключ и вставьте в настройки модуля, затем нажмите «Я скопировал(-а) ключ». Больше мы его не покажем. Все ключи потом видны в разделе «Ключи API».
  5. В WHMCS добавьте второй сервер «ZRAZU SSL» с боевым адресом API и этим ключом.

Ключ действует ограниченное время, работает только с адресов вашего сервера WHMCS, а выпуск сертификата требует второго фактора. Срок действия показан в кабинете.

Другие биллинги

Готовые модули есть для WHMCS. Другой биллинг подключается по EPP по инструкции: подключение EPP.

Если не получилось

  • Соединение закрывается с кодом 2501. Исходящего адреса вашего сервера WHMCS нет в белом списке логина EPP. Добавьте его в «Настроить» рядом с логином.
  • Боевой адрес не принимает тестовый ключ. Тестовый ключ работает только на адресе песочницы. Для боевого режима выпустите боевой ключ.
  • Ключ потерян. Показать его второй раз нельзя. Выпустите новый и замените в настройках модуля.
  • Заказ отклонён из-за лимита. Превышен дневной лимит трат ключа. Выпустите новый ключ с другим лимитом.
  • Кабинет пишет «Архив ещё не собран — напишите менеджеру». Напишите менеджеру через «Поддержку».
  • Другой вопрос по модулю. Посмотрите README в архиве, а если ответа там нет, напишите в «Поддержку».

Эта страница в Markdown