Modulo registrar di domini per 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 700 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 del modulo WHMCS di Domain Name API richiede di solito una decina di minuti. Una guida passo passo con screenshot è disponibile nella nostra base di conoscenza, e il video in questa pagina mostra gli stessi passaggi.

1. Scarica l'ultima versione da GitHub Releases. Non usare il pulsante verde “Code → Download ZIP”: scarica il ramo di sviluppo.

2. Estrai l'archivio e copia la cartella modules nella directory principale di WHMCS (ad es. /home/whmcs/public_html). Non serve caricare i file .gitignore, README.md e LICENSE.

3. Nell'area di amministrazione di WHMCS, vai su System Settings → Domain Registrars. DomainNameAPI compare non appena i file sono al loro posto.

4. Attiva il modulo e inserisci il tuo Reseller ID e la tua API Key. Li trovi entrambi nel tuo pannello Domain Name API (dm.apiname.com), in API Settings; i dati di accesso al pannello qui non funzionano. Dopo il salvataggio viene mostrato il tuo saldo.

5. Se vendi domini .tr, associa i campi numero di identità turco e numero fiscale ai rispettivi campi cliente personalizzati.

6. Importa i prezzi con Utilities → Registrar TLD Sync → DomainNameApi oppure impostali manualmente.

7. In System Settings → General Settings → Domains, abilita registrazione, trasferimenti, ordini di rinnovo, rinnovo automatico al pagamento, sincronizzazione dei domini e supporto IDN. In Automation Settings, abilita Domain Sync e Sync Next Due Date.

⚠ Importante: se stai aggiornando da una versione precedente, esegui un backup dei file del modulo esistenti prima di sovrascriverli.

💡 L'errore di installazione più comune è mettere i file nella directory sbagliata: in quel caso WHMCS non rileva il modulo, senza segnalare alcun errore. Per il debug, usa Utilities → Logs → Module Log con il log di debug attivo, e disattivalo di nuovo in produzione.

Il modulo WHMCS di Domain Name API richiede:

WHMCS 7.8 o superiore (consigliata l'ultima versione stabile)

PHP 7.4 o superiore (consigliato PHP 8.1)

Le estensioni PHP cURL e JSON (attive di default sulla maggior parte dei server di hosting)

Campi cliente personalizzati per numero di identità, numero fiscale e ufficio delle imposte — necessari solo per la registrazione di domini .tr

💡 Usa sempre l'ultima versione stabile di WHMCS: le patch di sicurezza vengono rilasciate regolarmente e le versioni obsolete sono un vettore di attacco frequente. Se servi il mercato turco, configura i campi numero di identità turco e numero fiscale già nella configurazione iniziale: il registro del .tr li richiede.

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.

💡 Se stai scegliendo una piattaforma oggi, prima di decidere confronta il costo di WHMCS con WiseCP (particolarmente competitivo nei mercati turco e MENA) e Blesta (acquisto una tantum, forte controllo dei 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 prodotto commerciale concesso in licenza da WHMCS Ltd.; i suoi piani hanno un prezzo in base al numero di clienti attivi e vengono fatturati mensilmente. Prima di acquistare, verifica i piani attuali e le opzioni di prova su whmcs.com.

Il modulo WHMCS di Domain Name API, invece, è gratuito e funziona con tutti i livelli di licenza WHMCS. Paghi solo i domini che registri, ai tuoi prezzi da rivenditore.

Sì. WHMCS Ltd. consente di passare da un livello di licenza all'altro; verifica le condizioni di upgrade attuali su whmcs.com. Il modulo di Domain Name API funziona con tutti i livelli di licenza WHMCS, quindi cambiare piano non influisce sulle impostazioni del tuo registrar.

💡 Inizia con il livello adatto al numero attuale di clienti attivi ed effettua l'upgrade man mano che cresci: la configurazione del modulo resta invariata.

Il modulo WHMCS di Domain Name API supporta oltre 700 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.

💡 Più promemoria distribuiti nelle settimane prima della scadenza sono più difficili da ignorare di una singola e-mail. Assicurati anche che Sync Next Due Date sia attivo in Automation Settings: le differenze tra le date di scadenza di WHMCS e quelle effettive del registro sono tra le cause principali di perdite impreviste di domini per i rivenditori.

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 700 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.