Registrazione di un dominio

La registrazione di un nuovo nome di dominio viene attivata automaticamente da WHMCS non appena il pagamento di un ordine è confermato (o immediatamente se l'ordine viene validato manualmente). Ecco il dettaglio del processo.

Flusso di registrazione lato cliente

1. Il cliente effettua una ricerca di disponibilità dal tuo carrello WHMCS
2. Seleziona il dominio desiderato e sceglie la durata (1 anno, 2 anni, ecc.)
3. Compila le informazioni di contatto (titolare, amministrativo, tecnico, fatturazione)
4. Se il TLD richiede campi aggiuntivi (es. .fr → codice AFNIC), questi campi vengono visualizzati automaticamente
5. Valida e paga l'ordine
6. WHMCS attiva automaticamente la chiamata API verso HostMyServers per registrare il dominio

Flusso tecnico (modulo → API)

Quando WHMCS chiama la funzione RegisterDomain del modulo:

1. Il modulo costruisce la richiesta API con:
   • Il nome di dominio completo (es. miodominio.fr)
   • La durata in anni
   • I nameserver (quelli del cliente o i nameserver predefiniti configurati)
   • I contatti WHOIS (titolare)
   • I campi aggiuntivi specifici per il TLD (se applicabile)
2. La richiesta viene inviata all'API HostMyServers tramite cURL (HTTPS)
3. L'API restituisce uno stato di successo o un messaggio di errore
4. In caso di successo, WHMCS aggiorna lo stato del dominio su Attivo e registra la data di scadenza

Gestione delle registrazioni asincrone

Alcuni TLD (in particolare le nuove estensioni e certi ccTLD) non registrano il dominio immediatamente. La registrazione può richiedere da pochi minuti a diverse ore. In questo caso:

• WHMCS contrassegna il dominio come In attesa (Pending)
• Il task cron di sincronizzazione verifica regolarmente lo stato presso HostMyServers
• Non appena la registrazione è confermata, lo stato passa automaticamente ad Attivo

Il cliente riceve un'email di conferma solo quando il dominio passa allo stato Attivo.

Registrazione manuale dal back-office

Un amministratore può registrare un dominio manualmente (senza passare dal carrello cliente):

1. Clienti → seleziona il cliente
2. Aggiungi nuovo prodotto/servizio → Dominio
3. Compila il dominio, la durata, il registrar (HostMyServers)
4. Seleziona Esegui il comando del modulo ora per attivare la registrazione immediatamente
5. Fai clic su Aggiungi

Contatti WHOIS

Le informazioni WHOIS vengono compilate al momento dell'ordine e trasmesse a HostMyServers al momento della registrazione. Se il cliente non compila le sue informazioni di contatto in WHMCS, il modulo utilizza i dati del suo account (nome, cognome, indirizzo, email, telefono).

Accuratezza dei dati WHOIS

I registri impongono che i dati WHOIS siano accurati e aggiornati. Dati errati possono comportare la sospensione o la cancellazione del dominio da parte del registro. Informa i tuoi clienti di questo obbligo.

Errori comuni alla registrazione

Messaggio di errore	Causa probabile	Soluzione
Domain not available	Il dominio è stato registrato tra la ricerca e l'ordine	Chiedere al cliente di cercare un altro nome
Invalid contact data	Un campo obbligatorio del contatto è mancante o non valido	Verificare e correggere i dati cliente in WHMCS
Insufficient funds	Saldo HostMyServers insufficiente	Ricaricare il conto dall'area clienti HostMyServers
Invalid TLD	L'estensione non è supportata da HostMyServers	Verificare il catalogo TLD disponibile nell'area clienti
Additional field required	Campo aggiuntivo obbligatorio mancante per questo TLD	Verificare che i campi aggiuntivi siano correttamente compilati nell'ordine