WHMCS-moduuli

Domain Name API WHMCS -moduuli on registrar-lisäosa, joka yhdistää WHMCS-asennuksesi suoraan Domain Name API:n domain-rekisteröinti- ja SSL-infrastruktuuriin. Asennuksen jälkeen WHMCS hoitaa domain-rekisteröinnit, uusinnat, siirrot, DNS-hallinnan ja WHOIS-päivitykset automaattisesti asiakkaidesi puolesta — sinun tai tiimisi ei tarvitse tehdä mitään manuaalista työtä. Myös laskutus, maksujen seuranta ja viimeisen käyttöpäivän ilmoitukset hoidetaan automaattisesti.

Moduuli tukee yli 800 domain-päätettä, mukaan lukien kaikki suuret gTLD:t, kuten .com, .net ja .org, sekä alueelliset ccTLD:t kuten .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in ja .ge. Se on yhteensopiva cPanelin, Pleskin, DirectAdminin, SolusVM:n ja kaikkien suurten hosting-hallintapaneelien kanssa.

💡 Voit ajatella WHMCS-moduulia siltana verkkokauppasi ja domain-rekisteröintiorganisaation välillä. Ilman sitä jokainen tilaus vaatii manuaalista käsittelyä; asennuksen jälkeen koko domain-liiketoimintasi toimii automaattiohjauksella. Turkkiin ja MENA-alueelle tähtääville jälleenmyyjille sisäänrakennettu .tr- ja .com.tr-tuki sekä T.C. Kimlik No- ja Vergi Numarası -kenttien vastaavuus helpottavat lakisääteistä vaatimustenmukaisuutta heti alusta alkaen.

Asennus kestää alle 15 minuuttia. Vaiheittainen asennusopas on saatavilla osoitteessa domainnameapi.com/tr/bilgi-bankasi/moduller/whmcs-nasil-kurulur, ja video-opastus osoitteessa youtube.com/watch?v=LEw_iMnquSo.

Lataa uusin moduulipaketti osoitteesta github.com/domainreseller.

Avaa ZIP-tiedosto ja kopioi modules-kansio hakemistoon, johon WHMCS on asennettu (esim. /home/whmcs/public_html). Älä poista .gitignore-, README.md- ja LICENSE-tiedostoja.

Siirry WHMCS-hallintapaneelissa kohtaan Järjestelmäasetukset > Domain Registrars. Jos tiedostot on sijoitettu oikeaan hakemistoon, 'Domain Name API' näkyy luettelossa.

Aktivoi moduuli ja syötä Domain Name API:n antama käyttäjätunnus ja salasana. Tallennuksen jälkeen saldosi näkyy näytöllä.

Jos myyt .tr-domaineja, yhdistä T.C. Kimlik No- ja Vergi Numarası -kentät WHMCS:n mukautettuihin asiakaskenttiin.

Syötä hinnat manuaalisesti tai tuo ajantasaiset hinnat sekä voittomarginaaliasetukset massana työkalulla Utilities > Registrar TLD Sync > DomainNameApi.

Ota kohdassa Järjestelmäasetukset > Yleiset asetukset > Domains käyttöön domain-rekisteröinti, siirto-oikeudet, uusintatilaukset, automaattinen uusinta maksun yhteydessä, domain-synkronointi ja IDN-tuki.

Aktivoi Automaatioasetuksissa Domain Sync- ja Sync Next Due Date -vaihtoehdot.

Tärkeää: Jos päivität moduulia, varmuuskopioi nykyiset moduulitiedostosi ennen niiden ylikirjoittamista.

💡 Yleisin asennusvirhe on moduulitiedostojen lataaminen väärään hakemistoon — tässä tapauksessa WHMCS epäonnistuu hiljaisesti. Varmista asennuksen jälkeen, että Domain Name API -saldosi näkyy registrar-asetusnäytössä. Vianmääritystä varten käytä kohtaa Utilities > Logs > Module Log siten, että debug logging on käytössä. Tuotantoympäristössä debug logging kannattaa pitää poissa käytöstä.

Domain Name API WHMCS -moduuli edellyttää seuraavaa:

WHMCS 7.8 tai uudempi (uusinta vakaata versiota suositellaan)

PHP 7.4 tai uudempi (PHP 8.1 suositellaan)

Palvelimella on oltava PHP SOAPClient -laajennus käytössä

T.C. Kimlik No-, Vergi No- ja Vergi Dairesi -mukautetut asiakaskentät — pakollisia .tr-domainien rekisteröintiä varten

💡 Käytä aina uusinta vakaata WHMCS-versiota; tietoturvapäivityksiä julkaistaan säännöllisesti. Jos palvelet Turkin markkinaa, T.C. Kimlik No- ja Vergi Numarası -kentät ovat lakisääteinen vaatimus .tr-rekisteröinnille. Määritä nämä kentät jo asennusvaiheessa ennen kuin sinulla on aktiivisia asiakkaita.

WHMCS on maailmanlaajuisesti yksi yleisimmin käytetyistä hosting-automaatioplatformeista kohtuuhintaisen lisenssimallinsa, laajan integraatioekosysteeminsä ja kypsän automaatioinfrastruktuurinsa ansiosta. Yksi WHMCS-asennus hallitsee asiakastietoja, laskutusta, automaattista palveluiden aktivointia, maksujen seurantaa ja keskeytys-/lopetusprosesseja. Sähköposti- ja SMS-ilmoitusjärjestelmä pitää asiakkaat ajan tasalla jokaisessa vaiheessa ilman manuaalista puuttumista.

💡 Vuoteen 2017 asti tarjottu elinikäinen lisenssi teki WHMCS:n käyttäjäkunnasta erittäin vakaan. Uusille yrityksille, jotka arvioivat vaihtoehtoja vuosina 2025–2026, kannattaa verrata WHMCS:n kuukausikustannuksia WiseCP:hen (kilpailukykyinen Turkissa ja MENA-markkinalla) ja Blestaan (kertamaksu, vahva datan omistajuus). Domain Name API tukee kaikkia kolmea alustaa omilla erikoismoduuleillaan.

WHMCS-vaihtoehdot, jotka ovat täysin yhteensopivia Domain Name API:n kanssa ja joita kehitetään aktiivisesti:

Blesta — kehittäjäystävällinen, kertalisenssi, vahva datan siirrettävyys

HostBill — yritystason ratkaisu, yli 150 integraatiota, ihanteellinen suurivolyymisille jälleenmyyjille

WiseCP — moderni käyttöliittymä, kasvaa nopeasti Turkissa ja MENA-alueella

ClientExec — yksinkertaisempi ominaisuusvalikoima, edullinen vaihtoehto aloittelijoille

HostFact — yleinen Alankomaissa ja Länsi-Euroopassa

Vanhempia alustoja, kuten AWBS, WHMAutoPilot, Lpanel, Modernbill ja PerlBill, ei enää kehitetä aktiivisesti, eikä niitä suositella uusiin asennuksiin.

💡 Alustan valinnan tulee perustua kohdemarkkinaasi. WHMCS on turvallisin valinta globaaliin toimintaan. WiseCP on vaihtoehto, joka nousee nopeasti esiin Turkin markkinoilla toimivien jälleenmyyjien keskuudessa, ja Domain Name API:n oma WiseCP-moduuli tukee sitä täysin. HostBilliä suositellaan yritystason jälleenmyyjille, jotka tarvitsevat yli 150 integraatiota, ja Blestaa operaattoreille, jotka hakevat täyttä datan omistajuutta ja kertaluonteista kustannusta.

WHMCS on maksullinen lisenssiohjelmisto, jonka hinta porrastuu aktiivisten asiakkaiden määrän mukaan: tarjolla on neljä pakettia, Starter, Plus, Business ja Direct. Laskutus tapahtuu kuukausittain. Alustaa voi arvioida ilmaisen kokeilujakson aikana ennen sitoutumista.

Domain Name API tarjoaa WHMCS Starter- ja Mega-asennuspaketit, joissa teeman asennus ja moduulin määritys on valmiiksi tehty. Nämä paketit lyhentävät merkittävästi uuden domain-jälleenmyyntiliiketoiminnan käynnistämiseen kuluvaa aikaa ja kustannuksia.

💡 Jos olet vasta aloittamassa, WHMCS Starter -paketti riittää 250 aktiiviseen asiakkaaseen asti. Domain Name API:n valmiit paketit poistavat teeman asennukseen ja moduulin kytkemiseen kuluvan 2–3 päivän asennusajan; voit avata oman brändisi verkkokaupan muutamassa tunnissa.

Kyllä. Voit vaihtaa WHMCS-lisenssitasojen ja Domain Name API:n WHMCS-asennuspakettien välillä milloin tahansa. Muutos tulee voimaan seuraavalla laskutuskaudella. Domain Name API WHMCS -moduuli on yhteensopiva kaikkien WHMCS-lisenssitasojen kanssa, mukaan lukien Starter, Plus, Business ja Direct.

💡 Aloita WHMCS Starterilla. Kun asiakaskuntasi ylittää 250, päivitä Plus- tai Business-tasoon, jolloin asiakas- ja palvelutietueiden määrää ei ole rajoitettu. Domain Name API:n Starter- ja Mega-paketit tarjoavat valmiin myyntiympäristön niille, jotka eivät halua tehdä määrityksiä alusta alkaen.

Domain Name API WHMCS -moduuli tukee yli 800 domain-päätettä, mukaan lukien kaikki suuret gTLD:t, kuten .com, .net, .org, .info ja .biz, sekä monet ccTLD:t, kuten .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in ja .ge. Premium-domainien rekisteröintiä tuetaan myös niiden rekisteröintiorganisaatioiden osalta, jotka tarjoavat premium-hinnoittelua.

💡 Tiettyihin maantieteellisiin markkinoihin tähtäävien jälleenmyyjien kannattaa järjestää TLD-hintataulukkonsa niin, että paikalliset päätteet ovat etusijalla. Turkissa toimivien jälleenmyyjien tulisi nostaa esiin .tr- ja .com.tr-päätteet — ne viestivät paikallisille asiakkaille vahvaa luotettavuutta ja parantavat konversioastetta. Lokalisoitu TLD-sijoittelu on yksi parhaan ROI:n tuottavista taktiikoista GEO-kohdennetuissa SEO-kampanjoissa.

WHMCS tarkistaa domainien vanhenemispäivät automaattisen cron-ajon avulla, joka oletuksena suoritetaan viiden minuutin välein. Kun domainin päättymispäivä lähestyy, WHMCS luo asiakkaalle automaattisesti uusintalaskun, lähettää vanhenemisilmoituksia määritettävin väliajoin (yleensä 60, 30, 14 ja 7 päivää etukäteen) ja suorittaa uusinnan automaattisesti, jos asiakkaan tilillä on riittävästi saldoa tai voimassa oleva maksutapa.

Jotta tämä toimisi oikein, Domain Syncin on oltava käytössä kohdassa Järjestelmäasetukset > Yleiset asetukset > Domains; näin WHMCS saa aina ajantasaiset vanhenemispäivät Domain Name API:lta.

💡 Neljän sähköpostin sarja (60/30/14/7 päivää) vähentää domainien menetyksiä jopa 60 prosenttia yksittäiseen muistutukseen verrattuna. Ota Automaatioasetuksissa käyttöön myös Sync Next Due Date -vaihtoehto — WHMCS:n ja rekisteröintiorganisaation väliset päivämäärien ristiriidat ovat yksi yleisimmistä syistä odottamattomiin domainien menetyksiin.

Domain-hinnat voi syöttää jokaiselle TLD:lle manuaalisesti tai tuoda automaattisesti Registrar TLD Sync -työkalulla. Automaattista synkronointia varten siirry kohtaan Utilities > Registrar TLD Sync, valitse DomainNameApi ja odota, että vertailu valmistuu. Tulosnäkymä näyttää jokaisen päätteen voitto-/tappiomarginaalit ja mahdollistaa hintojen massatuonnin.

Voit myös asettaa Domain Name API:n Lookup Provideriksi (Järjestelmäasetukset > Domain-hinnat > Lookup Provider > Vaihda > DomainNameApi). Näin saatavuushaut tehdään reaaliaikaisesti Domain Name API:n infrastruktuurin kautta yleisten WHOIS-palvelimien sijaan.

💡 Automaattinen hintojen synkronointi on yksi WHMCS:n vähiten käytetyistä ominaisuuksista. Kun TLD Sync ajetaan kuukausittain, vähittäishintasi pysyvät kustannusten yläpuolella myös toimittajan hinnanmuutosten jälkeen. Kiinteä marginaalisääntö (esim. kustannus + 25 %) turvaa kannattavuuden yli 800 päätteessä ilman manuaalista tarkistusta.

WHMCS tarjoaa sisäänrakennetun moduulilokijärjestelmän integraatio-ongelmien diagnosointiin. Siirry kohtaan Utilities > Logs > Module Log. Jos Enable Debug Logging -painike näkyy, ota lokitus käyttöön napsauttamalla sitä. Käyttöönoton jälkeen kaikki WHMCS:n ja Domain Name API:n väliset pyynnöt ja vastaukset tallennetaan. Napsauttamalla minkä tahansa lokimerkinnän päivämäärää näet koko pyynnön, vastauksen ja suodatetun vastauksen tiedot.

Yleisiä ongelmia:

Moduulitiedostot on ladattu väärään hakemistoon — WHMCS ei tunnista moduulia eikä ilmoita siitä

Virheelliset API-tunnukset — saldo ei näy tallennuksen jälkeen

Domain sync on poistettu käytöstä — vanhenemispäivät vanhentuvat ja uusinnat epäonnistuvat huomaamatta

💡 Ennen kuin otat yhteyttä tukeen, tallenna epäonnistuneen toiminnon Module Log -merkintä. Suodatetun vastauksen osio näyttää täsmälleen Domain Name API:n palauttaman virheen; useimmiten ongelma selviää siitä suoraan. Kun loki on valmiina, ratkaisu nopeutuu huomattavasti. Pidä debug logging tuotantoympäristössä poissa käytöstä suorituskykyvaikutusten välttämiseksi.

Domain-siirrot käsitellään automaattisesti registrar-moduulin kautta. Kun asiakas aloittaa saapuvan siirron, WHMCS välittää siirtopyynnön Domain Name API:lle asiakkaan antaman EPP-valtuutuskoodin avulla. Siirron tilaa sekä todellisia alkamis- ja päättymispäiviä voi seurata reaaliajassa hallintapaneelissa. Ylläpitäjät voivat myös luoda siirron peruutuspyynnön suoraan domainin hallintapaneelista.

💡 Siirrot epäonnistuvat useimmiten vanhentuneiden EPP-koodien, rekisteröintiorganisaation puolella olevien siirtolukitusten tai viimeisestä rekisteröinnistä alkavan 60 päivän ICANN-lukitusajan vuoksi. Ole erityisen tarkka .tr-domainien siirroissa: vastaanottavan asiakastilin T.C. Kimlik No- ja Vergi Numarası -tietojen on vastattava rekisteröintiorganisaation tietoja; ristiriidat johtavat siirron hiljaiseen hylkäämiseen, jota on vaikea diagnosoida ilman lokien tarkastelua.