WHMCS модул

WHMCS модулът на Domain Name API е разширение за регистратор, което свързва вашата WHMCS инсталация директно с инфраструктурата на Domain Name API за регистрация на домейни и SSL. След инсталирането WHMCS автоматично извършва от името на вашите клиенти регистрация на домейни, подновяване, трансфер, DNS управление и WHOIS актуализации — без да е необходимо вие или екипът ви да извършвате каквито и да било ръчни действия. Фактурирането, проследяването на плащанията и известията за изтичане на срока също се управляват автоматично.

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

💡 Можете да мислите за WHMCS модула като за мост между вашия витринен сайт и домейн регистратора. Без него всяка поръчка изисква ръчна обработка; след инсталирането целият ви домейн бизнес работи на автопилот. За дистрибутори, насочени към Турция и MENA региона, вградената поддръжка за .tr и .com.tr, заедно със съпоставянето на полетата за турски личен номер и данъчен номер, улеснява правното съответствие още от самото начало.

Инсталацията отнема по-малко от 15 минути. Поетапното ръководство за инсталиране е достъпно на адрес domainnameapi.com/tr/bilgi-bankasi/moduller/whmcs-nasil-kurulur, а видео ръководството е налично на youtube.com/watch?v=LEw_iMnquSo.

Изтеглете най-актуалния пакет на модула от github.com/domainreseller.

Разархивирайте ZIP файла и копирайте папката modules в директорията, в която е инсталиран WHMCS (напр. /home/whmcs/public_html). Не изтривайте файловете .gitignore, README.md и LICENSE.

В административния панел на WHMCS отидете на Системни настройки > Регистратори на домейни. Ако файловете са поставени в правилната директория, „Domain Name API“ ще се появи в списъка.

Активирайте модула и въведете предоставените от Domain Name API потребителско име и парола. След запазване балансът ви ще се покаже на екрана.

Ако продавате .tr домейни, съпоставете полетата за турски личен номер и данъчен номер с персонализираните клиентски полета в WHMCS.

Въведете ценообразуването ръчно или импортирайте на едро актуалните цени с настройки за печалбен марж чрез Utilities > Registrar TLD Sync > DomainNameApi.

От Системни настройки > Общи настройки > Domains активирайте регистрация на домейни, разрешения за трансфер, поръчки за подновяване, автоматично подновяване при плащане, синхронизация на домейни и поддръжка на IDN.

Под Настройки за автоматизация активирайте опциите Domain Sync и Sync Next Due Date.

Важно: ако извършвате актуализация, направете резервно копие на съществуващите файлове на модула, преди да ги презапишете.

💡 Най-често срещаната грешка при инсталиране е качването на файловете на модула в грешна директория — в такъв случай WHMCS се проваля безшумно. След инсталацията потвърдете, че балансът ви в Domain Name API се вижда на екрана за конфигурация на регистратора. За отстраняване на проблеми използвайте раздела Utilities > Logs > Module Log с активирано debug logging. Поддържайте debug logging изключен в продукционна среда.

Изисквания за WHMCS модула на Domain Name API:

WHMCS 7.8 или по-нова версия (препоръчва се най-новата стабилна версия)

PHP 7.4 или по-нова версия (препоръчва се PHP 8.1)

PHP разширението SOAPClient трябва да бъде активирано на сървъра

Персонализирани клиентски полета за турски личен номер, данъчен номер и данъчна служба — задължителни за регистрация на .tr домейни

💡 Винаги използвайте най-новата стабилна версия на WHMCS; корекции по сигурността се публикуват редовно. Ако обслужвате турския пазар, полетата за турски личен номер и данъчен номер са законово изискване за .tr регистрация. Дефинирайте тези полета още на етапа на настройка, преди да имате активни клиенти.

WHMCS е най-широко използваната платформа за хостинг автоматизация в света благодарение на достъпния си лицензионен модел, обширната интеграционна екосистема и зрелата си автоматизационна инфраструктура. Една единствена WHMCS инсталация управлява клиентските записи, фактурирането, автоматичната активация на услуги, проследяването на плащанията и потоците за спиране/прекратяване. Системата за e-mail и SMS известия информира клиентите на всяка стъпка, без да е необходима ръчна намеса.

💡 Доживотният лиценз, предлаган до 2017 г., направи потребителската база на WHMCS много стабилна. За нови бизнеси, които оценяват решението през 2025–2026 г., е добре да сравнят месечната цена на WHMCS с WiseCP (конкурентен на пазарите в Турция и MENA) и Blesta (еднократно плащане, силен контрол върху данните). Domain Name API поддържа и трите платформи чрез специализирани модули.

Алтернативи на WHMCS, които са напълно съвместими с Domain Name API и се развиват активно:

Blesta — удобен за разработчици, лиценз с еднократно плащане, силна преносимост на данните

HostBill — корпоративно ниво, над 150 интеграции, идеален за дистрибутори с голям обем

WiseCP — модерен интерфейс, бързо растящ в Турция и MENA региона

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

HostFact — широко използван в Нидерландия и Западна Европа

По-старите платформи като AWBS, WHMAutoPilot, Lpanel, Modernbill и PerlBill вече не се развиват активно и не се препоръчват за нови инсталации.

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

WHMCS е платен лицензионен софтуер с четири плана, структурирани според броя на активните клиенти: Starter, Plus, Business и Direct. Таксуването е на месечна база. Предлага се безплатен пробен период, за да оцените платформата преди поемане на ангажимент.

Domain Name API предлага WHMCS Starter и Mega инсталационни пакети, които се доставят с вече завършена инсталация на темата и конфигурация на модула. Тези пакети значително намаляват времето и разходите, необходими за стартиране на нов домейн reseller бизнес.

💡 Ако тепърва започвате, планът WHMCS Starter е достатъчен за до 250 активни клиенти. Готовите пакети на Domain Name API премахват 2–3 дни работа, които обикновено се изразходват за инсталация на тема и свързване на модула; можете да стартирате брандирана витрина само за няколко часа.

Да. Можете по всяко време да преминавате между лицензионните нива на WHMCS и инсталационните пакети WHMCS на Domain Name API. Промяната влиза в сила през следващия фактурен период. WHMCS модулът на Domain Name API е съвместим с всички лицензионни нива на WHMCS, включително Starter, Plus, Business и Direct.

💡 Започнете с WHMCS Starter. Когато клиентската ви база надхвърли 250, преминете към Plus или Business за неограничени записи на клиенти и услуги. Пакетите Starter и Mega на Domain Name API предлагат готова среда за продажби за тези, които не искат да конфигурират всичко от нулата.

WHMCS модулът на Domain Name API поддържа над 800 домейн разширения, включително всички основни 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 актуалните дати на изтичане.

💡 Последователност от 4 e-mail съобщения на 60/30/14/7 дни намалява загубата на домейни с до 60% в сравнение с едно-единствено напомняне. Активирайте и опцията Sync Next Due Date в Настройки за автоматизация — разминаванията в датите между WHMCS и регистратора са сред най-честите причини за неочаквана загуба на домейни.

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

Можете също да зададете Domain Name API като Lookup Provider (Системни настройки > Цени на домейни > Lookup Provider > Промени > DomainNameApi). Така вместо чрез общи WHOIS сървъри, проверката за наличност в реално време се извършва чрез инфраструктурата на Domain Name API.

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

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 домейн трансферите: турският личен номер и данъчният номер в акаунта на получаващия клиент трябва да съвпадат с данните при регистратора; несъответствията могат да доведат до безшумни откази на трансфера, които трудно се диагностицират без преглед на логовете.