# Модулі ZRAZU для WHMCS

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

URL: https://zrazu.com/docs/resellers-whmcs/

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

Модулі доступні реселерам після договору: [як стати реселером](https://zrazu.com/docs/resellers-program.md). Усе нижче робиться в розділі [«Реселер»](https://vse.zrazu.com/reseller/) кабінету, його бачать власник, адміністратор і технік.

## Що знадобиться

- Чинний договір реселера і логін пісочниці EPP: [підключення EPP](https://zrazu.com/docs/resellers-epp.md).
- Доступ до сервера 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](https://zrazu.com/docs/resellers-epp.md).

## Якщо не вийшло

- **З’єднання закривається з кодом 2501.** Вихідної адреси вашого сервера WHMCS немає у білому списку логіна EPP. Додайте її в «Налаштувати» біля логіна.
- **Бойова адреса не приймає тестовий ключ.** Тестовий ключ працює лише на адресі пісочниці. Для бойового режиму випустіть бойовий ключ.
- **Втрачено ключ.** Показати його вдруге неможливо. Випустіть новий і замініть у налаштуваннях модуля.
- **Замовлення відхилено через ліміт.** Перевищено денний ліміт витрат ключа. Випустіть новий ключ з іншим лімітом.
- **Написано «Архів ще не зібрано — напишіть менеджеру».** Напишіть менеджеру через «Підтримку».
- **Інше питання по модулю.** Подивіться README в архіві, а якщо відповіді там немає, напишіть у «Підтримку».