Moduł WHMCS

Moduł WHMCS Domain Name API to wtyczka rejestratora, która bezpośrednio łączy instalację WHMCS z infrastrukturą rejestracji domen i SSL Domain Name API. Po instalacji WHMCS automatycznie realizuje w imieniu Twoich klientów rejestrację domen, odnowienia, transfery, zarządzanie DNS oraz aktualizacje WHOIS — bez potrzeby wykonywania jakichkolwiek ręcznych działań przez Ciebie lub Twój zespół. Fakturowanie, śledzenie płatności oraz powiadomienia o dacie wygaśnięcia również są zarządzane automatycznie.

Moduł obsługuje ponad 800 rozszerzeń domen, w tym wszystkie główne gTLD, takie jak .com, .net i .org, a także regionalne ccTLD, takie jak .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in i .ge. Jest kompatybilny z cPanel, Plesk, DirectAdmin, SolusVM oraz wszystkimi głównymi panelami hostingowymi.

💡 Możesz postrzegać moduł WHMCS jako pomost między Twoją witryną sprzedażową a rejestratorem domen. Bez niego każde zamówienie wymaga ręcznej obsługi; po instalacji cała działalność domenowa działa na autopilocie. Dla resellerów kierujących ofertę do Turcji i regionu MENA wbudowana obsługa .tr i .com.tr oraz mapowanie pól tureckiego numeru identyfikacyjnego i numeru podatkowego ułatwiają zgodność prawną od samego początku.

Instalacja zajmuje mniej niż 15 minut. Instrukcja krok po kroku jest dostępna pod adresem domainnameapi.com/tr/bilgi-bankasi/moduller/whmcs-nasil-kurulur, a materiał wideo pod adresem youtube.com/watch?v=LEw_iMnquSo.

Pobierz najnowszy pakiet modułu z github.com/domainreseller.

Rozpakuj plik ZIP i skopiuj folder modules do katalogu, w którym zainstalowano WHMCS (np. /home/whmcs/public_html). Nie usuwaj plików .gitignore, README.md i LICENSE.

W panelu administracyjnym WHMCS przejdź do Ustawienia systemowe > Rejestratorzy domen. Jeśli pliki zostały umieszczone we właściwym katalogu, na liście pojawi się „Domain Name API”.

Aktywuj moduł i wprowadź nazwę użytkownika oraz hasło dostarczone przez Domain Name API. Po zapisaniu saldo zostanie wyświetlone na ekranie.

Jeśli sprzedajesz domeny .tr, przypisz pola tureckiego numeru identyfikacyjnego i numeru podatkowego do niestandardowych pól klienta w WHMCS.

Wprowadź ceny ręcznie lub zaimportuj hurtowo aktualne ceny z ustawieniami marży zysku przez Utilities > Registrar TLD Sync > DomainNameApi.

W sekcji Ustawienia systemowe > Ustawienia ogólne > Domains aktywuj rejestrację domen, uprawnienia transferu, zamówienia odnowień, automatyczne odnawianie po opłaceniu, synchronizację domen oraz obsługę IDN.

W Ustawieniach automatyzacji włącz opcje Domain Sync i Sync Next Due Date.

Ważne: jeśli wykonujesz aktualizację, zrób kopię zapasową istniejących plików modułu przed ich nadpisaniem.

💡 Najczęstszym błędem instalacyjnym jest przesłanie plików modułu do niewłaściwego katalogu — w takim przypadku WHMCS kończy działanie z błędem po cichu. Po instalacji upewnij się, że saldo Domain Name API jest widoczne na ekranie konfiguracji rejestratora. Do rozwiązywania problemów używaj sekcji Utilities > Logs > Module Log z włączonym debug logging. W środowisku produkcyjnym pozostaw debug logging wyłączony.

Wymagania dla modułu WHMCS Domain Name API:

WHMCS 7.8 lub nowszy (zalecana jest najnowsza stabilna wersja)

PHP 7.4 lub nowszy (zalecany PHP 8.1)

Rozszerzenie PHP SOAPClient musi być włączone na serwerze

Niestandardowe pola klienta dla tureckiego numeru identyfikacyjnego, numeru podatkowego i urzędu skarbowego — obowiązkowe przy rejestracji domen .tr

💡 Zawsze używaj najnowszej stabilnej wersji WHMCS; poprawki bezpieczeństwa są publikowane regularnie. Jeśli obsługujesz rynek turecki, pola tureckiego numeru identyfikacyjnego i numeru podatkowego są wymogiem prawnym przy rejestracji .tr. Zdefiniuj te pola już na etapie konfiguracji, zanim pojawią się aktywni klienci.

WHMCS to najczęściej używana na świecie platforma automatyzacji hostingu dzięki przystępnemu modelowi licencjonowania, rozbudowanemu ekosystemowi integracji i dojrzałej infrastrukturze automatyzacji. Jedna instalacja WHMCS zarządza rekordami klientów, fakturowaniem, automatyczną aktywacją usług, śledzeniem płatności oraz procesami zawieszania i zakończenia usług. System powiadomień e-mail i SMS informuje klientów na każdym etapie bez potrzeby ręcznej interwencji.

💡 Dożywotnia licencja oferowana do 2017 roku sprawiła, że baza użytkowników WHMCS była bardzo stabilna. Nowe firmy oceniające platformę w latach 2025–2026 powinny porównać miesięczny koszt WHMCS z WiseCP (konkurencyjny na rynkach Turcji i MENA) oraz Blesta (jednorazowa płatność, silna kontrola nad danymi). Domain Name API obsługuje wszystkie trzy platformy poprzez dedykowane moduły.

Alternatywy dla WHMCS, które są w pełni zgodne z Domain Name API i aktywnie rozwijane:

Blesta — przyjazny dla programistów, licencja jednorazowa, wysoka przenośność danych

HostBill — poziom korporacyjny, ponad 150 integracji, idealny dla resellerów o dużym wolumenie

WiseCP — nowoczesny interfejs, szybko rośnie w Turcji i regionie MENA

ClientExec — prostszy zestaw funkcji, budżetowa opcja na start

HostFact — powszechny w Holandii i Europie Zachodniej

Starsze platformy, takie jak AWBS, WHMAutoPilot, Lpanel, Modernbill i PerlBill, nie są już aktywnie rozwijane i nie są zalecane do nowych instalacji.

💡 Wybór platformy powinien zależeć od rynku docelowego. WHMCS to najbezpieczniejszy wybór dla operacji globalnych. WiseCP to szybko rosnąca alternatywa wśród resellerów na rynku tureckim i jest w pełni wspierana przez dedykowany moduł WiseCP od Domain Name API. HostBill jest polecany resellerom korporacyjnym potrzebującym ponad 150 integracji, natomiast Blesta najlepiej odpowiada operatorom, którym zależy na pełnej kontroli nad danymi i jednorazowym koszcie.

WHMCS to płatne oprogramowanie licencyjne z czterema planami uzależnionymi od liczby aktywnych klientów: Starter, Plus, Business i Direct. Rozliczenie odbywa się miesięcznie. Dostępny jest bezpłatny okres próbny, aby ocenić platformę przed podjęciem zobowiązania.

Domain Name API oferuje pakiety instalacyjne WHMCS Starter i Mega, dostarczane z już ukończoną instalacją motywu i konfiguracją modułu. Pakiety te znacząco skracają czas i obniżają koszt uruchomienia nowego biznesu resellerskiego w zakresie domen.

💡 Jeśli dopiero zaczynasz, plan WHMCS Starter wystarczy dla 250 aktywnych klientów. Gotowe pakiety Domain Name API eliminują 2–3 dni pracy, które zwykle trzeba poświęcić na instalację motywu i podłączenie modułu; możesz uruchomić markową witrynę sprzedażową w zaledwie kilka godzin.

Tak. Możesz w dowolnym momencie przełączać się między poziomami licencji WHMCS i pakietami instalacyjnymi WHMCS od Domain Name API. Zmiana wchodzi w życie w następnym okresie rozliczeniowym. Moduł WHMCS Domain Name API jest zgodny ze wszystkimi poziomami licencji WHMCS, w tym Starter, Plus, Business i Direct.

💡 Zacznij od WHMCS Starter. Gdy baza klientów przekroczy 250, przejdź na Plus lub Business, aby uzyskać nielimitowaną rejestrację klientów i usług. Pakiety Starter i Mega od Domain Name API oferują gotowe środowisko sprzedażowe dla tych, którzy nie chcą konfigurować wszystkiego od zera.

Moduł WHMCS Domain Name API obsługuje ponad 800 rozszerzeń domen, w tym wszystkie główne gTLD, takie jak .com, .net, .org, .info, .biz, a także .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in, .ge i wiele innych ccTLD. Obsługiwana jest również rejestracja domen premium dla rejestrów oferujących ceny premium.

💡 Resellerzy kierujący ofertę na określone rynki geograficzne powinni organizować swoje tabele cen TLD tak, aby priorytetowo traktować lokalne rozszerzenia. Resellerzy w Turcji powinni wyróżniać .tr i .com.tr — te rozszerzenia budują silne sygnały zaufania wśród lokalnych klientów i zwiększają współczynnik konwersji. Lokalizowane pozycjonowanie TLD to jedna z taktyk o najwyższym ROI w kampaniach SEO ukierunkowanych geograficznie.

Domyślnie WHMCS sprawdza daty wygaśnięcia domen za pomocą automatycznego cron joba, który uruchamia się co pięć minut. Gdy zbliża się data wygaśnięcia domeny, WHMCS automatycznie tworzy fakturę za odnowienie dla klienta, wysyła powiadomienia o wygaśnięciu w konfigurowalnych odstępach (zwykle 60, 30, 14 i 7 dni wcześniej) i automatycznie wykonuje odnowienie, jeśli na koncie klienta znajdują się wystarczające środki lub ważna metoda płatności.

Aby proces działał poprawnie, opcja Domain Sync musi być aktywna w sekcji Ustawienia systemowe > Ustawienia ogólne > Domains, tak aby WHMCS zawsze otrzymywał od Domain Name API aktualne daty wygaśnięcia.

💡 Sekwencja 4 wiadomości e-mail wysyłanych na 60/30/14/7 dni przed terminem zmniejsza utratę domen nawet o 60% w porównaniu z pojedynczym przypomnieniem. Aktywuj również opcję Sync Next Due Date w Ustawieniach automatyzacji — rozbieżności dat między WHMCS a rejestratorem należą do najczęstszych przyczyn nieoczekiwanej utraty domen.

Ceny domen można wprowadzać ręcznie dla każdego TLD lub importować automatycznie za pomocą narzędzia Registrar TLD Sync. Aby wykonać automatyczną synchronizację: przejdź do Utilities > Registrar TLD Sync, wybierz DomainNameApi i poczekaj na zakończenie porównania. Ekran wyników pokazuje marże zysku/straty dla każdego rozszerzenia i umożliwia hurtowy import cen.

Możesz również ustawić Domain Name API jako Lookup Provider (Ustawienia systemowe > Ceny domen > Lookup Provider > Zmień > DomainNameApi). Dzięki temu sprawdzanie dostępności w czasie rzeczywistym będzie wykonywane przez infrastrukturę Domain Name API zamiast przez ogólne serwery WHOIS.

💡 Automatyczna synchronizacja cen to jedna z najmniej wykorzystywanych funkcji WHMCS. Comiesięczne uruchamianie TLD Sync gwarantuje, że Twoje ceny detaliczne pozostaną powyżej kosztu nawet po zmianach cen dostawcy. Zasada stałej marży (np. koszt + 25%) chroni rentowność dla ponad 800 rozszerzeń bez konieczności ręcznego przeglądu.

WHMCS oferuje wbudowany system logów modułów do diagnozowania problemów integracyjnych. Przejdź do Utilities > Logs > Module Log. Jeśli widoczny jest przycisk Enable Debug Logging, kliknij go, aby włączyć logowanie. Po aktywacji wszystkie żądania i odpowiedzi między WHMCS a Domain Name API są zapisywane. Możesz kliknąć datę dowolnego wpisu logu, aby przejrzeć pełne szczegóły żądania, odpowiedzi i przefiltrowanej odpowiedzi.

Często spotykane problemy:

Pliki modułu przesłano do niewłaściwego katalogu — WHMCS nie wykrywa modułu i nie pokazuje wyraźnego błędu

Nieprawidłowe dane API — saldo nie jest wyświetlane po zapisaniu

Domain Sync jest wyłączony — daty wygaśnięcia stają się nieaktualne, a odnowienia po cichu kończą się błędem

💡 Zanim skontaktujesz się ze wsparciem, pobierz wpis Module Log dotyczący nieudanej operacji. Sekcja przefiltrowanej odpowiedzi pokazuje dokładny błąd zwrócony przez Domain Name API; w większości przypadków problem staje się od razu oczywisty. Posiadanie tego logu znacznie skraca czas rozwiązania problemu. W środowisku produkcyjnym trzymaj debug logging wyłączony, aby uniknąć wpływu na wydajność.

Transfery domen są automatycznie przetwarzane przez moduł rejestratora. Gdy klient inicjuje transfer przychodzący, WHMCS przekazuje żądanie transferu do Domain Name API, używając kodu autoryzacyjnego EPP dostarczonego przez klienta. Status transferu oraz rzeczywiste daty rozpoczęcia i zakończenia można śledzić w czasie rzeczywistym w panelu administracyjnym. Administratorzy mogą również bezpośrednio utworzyć żądanie anulowania transferu z panelu zarządzania domeną.

💡 Błędy transferu najczęściej wynikają z wygasłych kodów EPP, blokad transferu u obecnego rejestratora lub 60-dniowego okresu ICANN lock po niedawnej rejestracji. Szczególną uwagę zwracaj na transfery domen .tr: turecki numer identyfikacyjny i numer podatkowy na koncie odbiorcy muszą zgadzać się z danymi u rejestratora; rozbieżności mogą powodować ciche odrzucenie transferu, które trudno zdiagnozować bez analizy logów.