Модуль регистратора доменов WHMCS

Модуль WHMCS от Domain Name API — это плагин регистратора, который напрямую подключает вашу установку WHMCS к инфраструктуре Domain Name API для регистрации доменов и SSL. После установки WHMCS автоматически выполняет от имени ваших клиентов регистрацию доменов, продление, трансферы, управление DNS и обновления WHOIS — без необходимости каких-либо ручных действий с вашей стороны или со стороны вашей команды. Выставление счетов, отслеживание платежей и уведомления о сроке действия также управляются автоматически.

Модуль поддерживает более 700 доменных расширений, включая все основные gTLD, такие как .com, .net и .org, а также региональные ccTLD, такие как .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in и .ge. Он совместим с cPanel, Plesk, DirectAdmin, SolusVM и всеми основными панелями управления хостингом.

💡 Вы можете представить модуль WHMCS как мост между вашей витриной и доменным регистратором. Без него каждый заказ требует ручной обработки; после установки весь ваш доменный бизнес работает на автопилоте. Для реселлеров, ориентированных на Турцию и регион MENA, встроенная поддержка .tr и .com.tr, а также сопоставление полей для турецкого идентификационного номера и налогового номера упрощают соблюдение правовых требований с самого начала.

Установка модуля WHMCS от Domain Name API обычно занимает около 10 минут. Пошаговое руководство со скриншотами есть в нашей базе знаний, а видео на этой странице показывает те же шаги.

1. Скачайте последний релиз со страницы GitHub Releases. Не используйте зелёную кнопку «Code → Download ZIP» — она скачивает ветку разработки.

2. Распакуйте архив и скопируйте папку modules в корневой каталог WHMCS (например, /home/whmcs/public_html). Файлы .gitignore, README.md и LICENSE загружать не нужно.

3. В панели администратора WHMCS откройте System Settings → Domain Registrars. Когда файлы на месте, в списке появляется DomainNameAPI.

4. Активируйте модуль и введите Reseller ID и API Key. Оба значения находятся в панели Domain Name API (dm.apiname.com) в разделе API Settings; логин и пароль от панели здесь не подойдут. После сохранения отобразится ваш баланс.

5. Если вы продаёте домены .tr, сопоставьте поля турецкого идентификационного номера и налогового номера с соответствующими пользовательскими полями клиента.

6. Импортируйте цены через Utilities → Registrar TLD Sync → DomainNameApi или задайте их вручную.

7. В разделе System Settings → General Settings → Domains включите регистрацию, трансферы, заказы на продление, автопродление при оплате, синхронизацию доменов и поддержку IDN. В разделе Automation Settings включите Domain Sync и Sync Next Due Date.

⚠ Важно: если вы обновляетесь с предыдущей версии, сделайте резервную копию текущих файлов модуля перед их перезаписью.

💡 Самая частая ошибка при установке — файлы в неправильном каталоге: тогда WHMCS просто не видит модуль и не сообщает об этом. Для отладки используйте Utilities → Logs → Module Log с включённым debug logging, а в рабочей среде снова отключайте его.

Требования модуля WHMCS от Domain Name API:

WHMCS 7.8 или выше (рекомендуется последняя стабильная версия)

PHP 7.4 или выше (рекомендуется PHP 8.1)

Расширения PHP cURL и JSON (на большинстве хостинг-серверов включены по умолчанию)

Пользовательские поля клиента для идентификационного номера, налогового номера и налоговой инспекции — нужны только для регистрации доменов .tr

💡 Всегда используйте последнюю стабильную версию WHMCS: обновления безопасности выходят регулярно, а устаревшие версии — частая цель атак. Если вы работаете с турецким рынком, создайте поля турецкого идентификационного номера и налогового номера ещё при первоначальной настройке: их требует реестр .tr.

WHMCS — самая широко используемая в мире платформа автоматизации хостинга благодаря доступной модели лицензирования, обширной экосистеме интеграций и зрелой инфраструктуре автоматизации. Одна установка WHMCS управляет клиентскими данными, выставлением счетов, автоматической активацией услуг, отслеживанием платежей и сценариями приостановки/завершения. Система уведомлений по электронной почте и SMS информирует клиентов на каждом этапе без необходимости ручного вмешательства.

💡 Если вы выбираете платформу сейчас, прежде чем принять решение, сравните стоимость WHMCS с WiseCP (особенно конкурентоспособна на рынках Турции и региона MENA) и Blesta (разовая покупка, данные полностью под вашим контролем). Domain Name API поддерживает все три платформы собственными модулями.

Полностью совместимые с Domain Name API и активно развиваемые альтернативы WHMCS:

Blesta — удобен для разработчиков, разовая лицензия, высокая переносимость данных

HostBill — корпоративный уровень, более 150 интеграций, идеально подходит для реселлеров с большим объемом

WiseCP — современный интерфейс, быстро растет в Турции и регионе MENA

ClientExec — более простой набор функций, бюджетный вариант для старта

HostFact — широко распространен в Нидерландах и Западной Европе

Старые платформы, такие как AWBS, WHMAutoPilot, Lpanel, Modernbill и PerlBill, больше не развиваются активно и не рекомендуются для новых установок.

💡 Выбор платформы должен зависеть от вашего целевого рынка. WHMCS — самый надежный выбор для глобальных операций. WiseCP — быстро набирающая популярность альтернатива среди реселлеров на турецком рынке и полностью поддерживается через специализированный модуль WiseCP от Domain Name API. HostBill рекомендуется корпоративным реселлерам, которым требуется более 150 интеграций, тогда как Blesta идеально подходит операторам, которым важны полный контроль над данными и разовый расход.

WHMCS — коммерческий продукт по лицензии WHMCS Ltd.; стоимость тарифов зависит от количества активных клиентов, оплата помесячная. Перед покупкой проверьте актуальные тарифы и варианты пробного периода на whmcs.com.

Сам модуль WHMCS от Domain Name API бесплатен и работает с любым уровнем лицензии WHMCS. Вы платите только за регистрируемые домены — по своим реселлерским ценам.

Да. WHMCS Ltd. позволяет переходить между уровнями лицензии; актуальные условия перехода уточняйте на whmcs.com. Модуль Domain Name API работает с любым уровнем лицензии WHMCS, поэтому смена тарифа не затрагивает настройки регистратора.

💡 Начните с уровня, который соответствует текущему количеству активных клиентов, и повышайте его по мере роста — настройки модуля останутся прежними.

Модуль WHMCS от Domain Name API поддерживает более 700 доменных расширений, включая все основные gTLD, такие как .com, .net, .org, .info и .biz, а также .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in, .ge и многие другие ccTLD. Также поддерживается регистрация premium-доменов для реестров, предлагающих premium-ценообразование.

💡 Реселлеры, ориентированные на определенные географические рынки, должны организовывать свои таблицы цен TLD, отдавая приоритет местным расширениям. Реселлерам в Турции следует выделять .tr и .com.tr — эти расширения формируют сильные сигналы доверия у местных клиентов и повышают конверсию. Локализованное позиционирование TLD — одна из тактик с самым высоким ROI в GEO-ориентированных SEO-кампаниях.

По умолчанию WHMCS проверяет даты истечения доменов с помощью автоматического cron job, который выполняется каждые пять минут. Когда срок действия домена приближается к концу, WHMCS автоматически создает счет на продление для клиента, отправляет уведомления об истечении срока с настраиваемыми интервалами (обычно за 60, 30, 14 и 7 дней) и автоматически выполняет продление, если на клиентском аккаунте достаточно средств или указан действительный способ оплаты.

Чтобы этот процесс работал корректно, параметр Domain Sync должен быть активен в разделе Системные настройки > Общие настройки > Domains, чтобы WHMCS всегда получал от Domain Name API актуальные даты истечения срока.

💡 Несколько напоминаний, распределённых по неделям до окончания срока, пропустить сложнее, чем одно письмо. Также убедитесь, что в Automation Settings включена опция Sync Next Due Date: расхождения между датами в WHMCS и фактическими датами окончания в реестре — одна из главных причин неожиданной потери доменов у реселлеров.

Цены на домены можно вводить вручную для каждого TLD или импортировать автоматически с помощью инструмента Registrar TLD Sync. Для автоматической синхронизации: перейдите в Utilities > Registrar TLD Sync, выберите DomainNameApi и дождитесь завершения сравнения. Экран результатов показывает маржу прибыли/убытка для каждого расширения и позволяет импортировать цены оптом.

Вы также можете назначить Domain Name API в качестве Lookup Provider (Системные настройки > Цены на домены > Lookup Provider > Изменить > DomainNameApi). Благодаря этому проверка доступности в реальном времени будет выполняться через инфраструктуру Domain Name API вместо общих WHOIS-серверов.

💡 Автоматическая синхронизация цен — одна из наименее используемых функций WHMCS. Ежемесячный запуск TLD Sync гарантирует, что ваши розничные цены останутся выше себестоимости даже после изменения цен поставщика. Правило фиксированной маржи (например, себестоимость + 25%) защищает рентабельность более чем по 700 расширениям без необходимости ручного пересмотра.

WHMCS предоставляет встроенную систему журналов модулей для диагностики проблем интеграции. Перейдите в Utilities > Logs > Module Log. Если отображается кнопка Enable Debug Logging, нажмите на нее, чтобы включить журналирование. После активации все запросы и ответы между WHMCS и Domain Name API записываются. Вы можете нажать на дату любой записи журнала, чтобы просмотреть полные сведения о запросе, ответе и отфильтрованном ответе.

Распространенные проблемы:

Файлы модуля загружены в неправильный каталог — WHMCS не распознает модуль и не показывает явную ошибку

Неверные API-учетные данные — после сохранения баланс не отображается

Domain Sync отключен — даты истечения устаревают, а продления тихо завершаются с ошибкой

💡 Прежде чем обращаться в поддержку, получите запись Module Log для неудачной операции. Раздел отфильтрованного ответа показывает точную ошибку, возвращенную Domain Name API; в большинстве случаев проблема сразу становится очевидной. Наличие этого журнала значительно сокращает время решения. В продуктивной среде держите debug logging отключенным, чтобы избежать влияния на производительность.

Трансферы доменов автоматически обрабатываются через модуль регистратора. Когда клиент инициирует входящий трансфер, WHMCS передает запрос на трансфер в Domain Name API, используя EPP-код авторизации, предоставленный клиентом. Статус трансфера и фактические даты начала/завершения можно отслеживать в режиме реального времени в административной панели. Администраторы также могут напрямую создавать запрос на отмену трансфера из панели управления доменом.

💡 Ошибки трансфера чаще всего возникают из-за просроченных EPP-кодов, блокировок трансфера у текущего регистратора или 60-дневного периода ICANN lock после недавней регистрации. Особенно внимательно относитесь к трансферам доменов .tr: турецкий идентификационный номер и налоговый номер в аккаунте принимающего клиента должны совпадать с данными у регистратора; расхождения могут приводить к тихому отклонению трансфера, которое трудно диагностировать без анализа журналов.