Modulo WHMCS

Il modulo WHMCS di Domain Name API è un plugin registrar che collega direttamente la tua installazione WHMCS all'infrastruttura di registrazione domini e SSL di Domain Name API. Una volta installato, WHMCS esegue automaticamente, per conto dei tuoi clienti, la registrazione dei domini, i rinnovi, i trasferimenti, la gestione DNS e gli aggiornamenti WHOIS, senza che tu o il tuo team dobbiate effettuare alcuna operazione manuale. Anche la fatturazione, il monitoraggio dei pagamenti e le notifiche di scadenza vengono gestiti automaticamente.

Il modulo supporta oltre 800 estensioni di dominio, inclusi tutti i principali gTLD come .com, .net e .org, oltre a ccTLD regionali come .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in e .ge. È compatibile con cPanel, Plesk, DirectAdmin, SolusVM e tutti i principali pannelli di controllo per hosting.

💡 Puoi considerare il modulo WHMCS come il ponte tra la tua vetrina e il registrar di domini. Senza di esso, ogni ordine richiede un'elaborazione manuale; una volta installato, tutta la tua attività di vendita di domini funziona con il pilota automatico. Per i rivenditori che puntano alla Turchia e alla regione MENA, il supporto integrato per .tr e .com.tr, insieme alla mappatura dei campi per il numero di identità turco e il numero fiscale, facilita la conformità legale fin dall'inizio.

L'installazione richiede meno di 15 minuti. La guida all'installazione passo dopo passo è disponibile all'indirizzo domainnameapi.com/tr/bilgi-bankasi/moduller/whmcs-nasil-kurulur, mentre il video tutorial è disponibile su youtube.com/watch?v=LEw_iMnquSo.

Scarica il pacchetto del modulo più aggiornato da github.com/domainreseller.

Estrai il file ZIP e copia la cartella modules nella directory in cui è installato WHMCS (ad es. /home/whmcs/public_html). Non eliminare i file .gitignore, README.md e LICENSE.

Nel pannello di amministrazione di WHMCS vai su Impostazioni di sistema > Registrar di domini. Se i file sono stati posizionati nella directory corretta, "Domain Name API" apparirà nell'elenco.

Attiva il modulo e inserisci il nome utente e la password forniti da Domain Name API. Dopo aver salvato, il tuo saldo apparirà sullo schermo.

Se vendi domini .tr, associa i campi Numero di identità turco e Numero fiscale ai campi cliente personalizzati in WHMCS.

Inserisci i prezzi manualmente oppure importa in blocco i prezzi in tempo reale con le impostazioni del margine di profitto tramite Utilities > Registrar TLD Sync > DomainNameApi.

Da Impostazioni di sistema > Impostazioni generali > Domini, abilita la registrazione dei domini, le autorizzazioni di trasferimento, gli ordini di rinnovo, il rinnovo automatico al pagamento, la sincronizzazione dei domini e il supporto IDN.

Nelle Impostazioni di automazione attiva le opzioni Domain Sync e Sync Next Due Date.

Importante: se stai effettuando un aggiornamento, esegui un backup dei file del modulo esistenti prima di sovrascriverli.

💡 L'errore di installazione più comune è il caricamento dei file del modulo nella directory sbagliata: in questo caso WHMCS fallisce in silenzio. Dopo l'installazione, verifica che il saldo di Domain Name API sia visibile nella schermata di configurazione del registrar. Per la risoluzione dei problemi, utilizza la sezione Utilities > Logs > Module Log con il debug logging attivato. Mantieni il debug logging disattivato nell'ambiente di produzione.

Requisiti per il modulo WHMCS di Domain Name API:

WHMCS 7.8 o superiore (si consiglia l'ultima versione stabile)

PHP 7.4 o superiore (si consiglia PHP 8.1)

L'estensione PHP SOAPClient deve essere attiva sul server

Campi cliente personalizzati per Numero di identità turco, Numero fiscale e Ufficio imposte — obbligatori per la registrazione di domini .tr

💡 Utilizza sempre l'ultima versione stabile di WHMCS; le patch di sicurezza vengono pubblicate regolarmente. Se operi sul mercato turco, i campi per il numero di identità turco e il numero fiscale sono un obbligo legale per la registrazione di .tr. Definisci questi campi già in fase di configurazione, prima di avere clienti attivi.

WHMCS è la piattaforma di automazione per hosting più utilizzata al mondo grazie al suo modello di licenza conveniente, al suo ampio ecosistema di integrazioni e alla sua matura infrastruttura di automazione. Una singola installazione WHMCS gestisce i registri clienti, la fatturazione, l'attivazione automatica dei servizi, il monitoraggio dei pagamenti e i flussi di sospensione/terminazione. Il sistema di notifiche via e-mail e SMS informa i clienti in ogni fase senza richiedere interventi manuali.

💡 La licenza a vita offerta fino al 2017 ha reso la base utenti di WHMCS molto stabile. Per le nuove aziende che valutano la piattaforma nel 2025–2026, conviene confrontare il costo mensile di WHMCS con WiseCP (competitivo nei mercati turco e MENA) e Blesta (pagamento una tantum, forte controllo sui dati). Domain Name API supporta tutte e tre le piattaforme con moduli dedicati.

Alternative a WHMCS pienamente compatibili con Domain Name API e sviluppate attivamente:

Blesta — orientato agli sviluppatori, licenza una tantum, forte portabilità dei dati

HostBill — livello enterprise, oltre 150 integrazioni, ideale per rivenditori ad alto volume

WiseCP — interfaccia moderna, in rapida crescita in Turchia e nella regione MENA

ClientExec — set di funzionalità più semplice, opzione iniziale economica

HostFact — diffuso nei Paesi Bassi e nell'Europa occidentale

Le vecchie piattaforme come AWBS, WHMAutoPilot, Lpanel, Modernbill e PerlBill non sono più sviluppate attivamente e non sono consigliate per nuove installazioni.

💡 La scelta della piattaforma dovrebbe dipendere dal mercato di riferimento. WHMCS è la scelta più sicura per operazioni globali. WiseCP è un'alternativa in rapida ascesa tra i rivenditori del mercato turco ed è pienamente supportata tramite il modulo WiseCP dedicato di Domain Name API. HostBill è consigliato ai rivenditori enterprise che necessitano di oltre 150 integrazioni, mentre Blesta è ideale per gli operatori che desiderano il pieno controllo dei dati e un costo una tantum.

WHMCS è un software con licenza a pagamento, suddiviso in quattro piani in base al numero di clienti attivi: Starter, Plus, Business e Direct. La fatturazione è mensile. È disponibile un periodo di prova gratuito per valutare la piattaforma prima di impegnarsi.

Domain Name API offre pacchetti di installazione WHMCS Starter e Mega già forniti con il tema installato e la configurazione del modulo completata. Questi pacchetti riducono in modo significativo tempi e costi necessari per avviare una nuova attività di rivendita domini.

💡 Se stai iniziando, il piano WHMCS Starter è sufficiente fino a 250 clienti attivi. I pacchetti pronti di Domain Name API eliminano i 2-3 giorni normalmente necessari per installare il tema e collegare il modulo; puoi lanciare una vetrina brandizzata in poche ore.

Sì. Puoi passare in qualsiasi momento tra i livelli di licenza WHMCS e i pacchetti di installazione WHMCS di Domain Name API. La modifica entrerà in vigore nel periodo di fatturazione successivo. Il modulo WHMCS di Domain Name API è compatibile con tutti i livelli di licenza WHMCS, inclusi Starter, Plus, Business e Direct.

💡 Inizia con WHMCS Starter. Quando la tua base clienti supera i 250 utenti, passa a Plus o Business per registrazioni illimitate di clienti e servizi. I pacchetti Starter e Mega di Domain Name API offrono un ambiente di vendita pronto all'uso per chi non vuole configurare tutto da zero.

Il modulo WHMCS di Domain Name API supporta oltre 800 estensioni di dominio, inclusi tutti i principali gTLD come .com, .net, .org, .info e .biz, oltre a .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in, .ge e molti altri ccTLD. È supportata anche la registrazione di domini premium per i registry che offrono prezzi premium.

💡 I rivenditori che puntano a mercati geografici specifici dovrebbero organizzare le tabelle prezzi TLD dando priorità alle estensioni locali. I rivenditori in Turchia dovrebbero mettere in evidenza .tr e .com.tr — queste estensioni generano forti segnali di fiducia nei clienti locali e aumentano i tassi di conversione. Il posizionamento localizzato delle TLD è una delle tattiche con il ROI più alto nelle campagne SEO geolocalizzate.

Per impostazione predefinita, WHMCS controlla le date di scadenza dei domini tramite un cron job automatico che viene eseguito ogni cinque minuti. Quando la data di scadenza di un dominio si avvicina, WHMCS crea automaticamente una fattura di rinnovo per il cliente, invia notifiche di scadenza a intervalli configurabili (in genere 60, 30, 14 e 7 giorni prima) ed esegue automaticamente il rinnovo se nel conto cliente è presente saldo sufficiente o un metodo di pagamento valido.

Affinché questo processo funzioni correttamente, è necessario che Domain Sync sia attivo in Impostazioni di sistema > Impostazioni generali > Domini, così WHMCS riceverà sempre da Domain Name API le date di scadenza aggiornate.

💡 Una sequenza di 4 e-mail a 60/30/14/7 giorni riduce la perdita di domini fino al 60% rispetto a un singolo promemoria. Attiva anche l'opzione Sync Next Due Date nelle Impostazioni di automazione: le discrepanze di data tra WHMCS e registrar sono tra le cause più comuni di perdite inattese di domini.

La tariffazione dei domini può essere inserita manualmente per ogni TLD oppure importata automaticamente tramite lo strumento Registrar TLD Sync. Per la sincronizzazione automatica: vai su Utilities > Registrar TLD Sync, seleziona DomainNameApi e attendi il completamento del confronto. La schermata dei risultati mostra i margini di profitto/perdita per ogni estensione e ti consente di importare i prezzi in blocco.

Puoi anche impostare Domain Name API come Lookup Provider (Impostazioni di sistema > Prezzi dei domini > Lookup Provider > Cambia > DomainNameApi). In questo modo, invece di utilizzare server WHOIS generici, la verifica di disponibilità in tempo reale viene eseguita tramite l'infrastruttura di Domain Name API.

💡 La sincronizzazione automatica dei prezzi è una delle funzioni meno utilizzate di WHMCS. Eseguire TLD Sync ogni mese garantisce che i tuoi prezzi al dettaglio restino superiori ai costi anche dopo le variazioni di prezzo del fornitore. Una regola di margine fisso (ad es. costo + 25%) protegge la redditività su oltre 800 estensioni senza richiedere revisioni manuali.

WHMCS offre un sistema di log del modulo integrato per diagnosticare i problemi di integrazione. Vai su Utilities > Logs > Module Log. Se appare il pulsante Enable Debug Logging, cliccalo per attivarlo. Una volta attivato, tutte le richieste e risposte tra WHMCS e Domain Name API vengono registrate. Puoi cliccare sulla data di qualsiasi voce di log per esaminare i dettagli completi di richiesta, risposta e risposta filtrata.

Problemi comuni:

File del modulo caricati nella directory sbagliata — WHMCS non rileva il modulo e non mostra errori espliciti

Credenziali API errate — dopo il salvataggio il saldo non viene visualizzato

Domain Sync disattivato — le date di scadenza diventano obsolete e i rinnovi falliscono silenziosamente

💡 Prima di contattare il supporto, recupera la voce Module Log relativa all'operazione fallita. La sezione di risposta filtrata mostra esattamente l'errore restituito da Domain Name API; nella maggior parte dei casi, il problema diventa subito chiaro. Avere questo log pronto riduce notevolmente i tempi di risoluzione. Mantieni il debug logging disattivato in produzione per evitare impatti sulle prestazioni.

I trasferimenti di dominio vengono elaborati automaticamente tramite il modulo registrar. Quando un cliente avvia un trasferimento in entrata, WHMCS inoltra la richiesta di trasferimento a Domain Name API utilizzando il codice di autorizzazione EPP fornito dal cliente. Lo stato del trasferimento e le date effettive di inizio/fine possono essere visualizzati in tempo reale nel pannello di amministrazione. Gli amministratori possono anche creare direttamente una richiesta di annullamento del trasferimento dal pannello di gestione del dominio.

💡 I trasferimenti falliscono più spesso a causa di codici EPP scaduti, blocchi di trasferimento presso il registrar attuale o del blocco ICANN di 60 giorni successivo a una registrazione recente. Presta particolare attenzione ai trasferimenti di domini .tr: il numero di identità turco e il numero fiscale nel conto cliente destinatario devono corrispondere ai dati presenti presso il registrar; eventuali discrepanze possono causare rifiuti silenziosi del trasferimento, difficili da diagnosticare senza esaminare i log.