Enregistrement d'un domaine

L'enregistrement d'un nouveau nom de domaine est déclenché automatiquement par WHMCS dès que le paiement d'une commande est confirmé (ou immédiatement si la commande est validée manuellement). Voici le détail du processus.

Flux d'enregistrement côté client

1. Le client effectue une recherche de disponibilité depuis votre panier WHMCS
2. Il sélectionne le domaine souhaité et choisit la durée (1 an, 2 ans, etc.)
3. Il renseigne les informations de contact (titulaire, administratif, technique, facturation)
4. Si le TLD requiert des champs supplémentaires (ex : .fr → code AFNIC), ces champs s'affichent automatiquement
5. Il valide et paye la commande
6. WHMCS déclenche automatiquement l'appel API vers HostMyServers pour enregistrer le domaine

Flux technique (module → API)

Lorsque WHMCS appelle la fonction RegisterDomain du module :

1. Le module construit la requête API avec :
   • Le nom de domaine complet (ex : mondomaine.fr)
   • La durée en années
   • Les nameservers (ceux du client ou les nameservers par défaut configurés)
   • Les contacts WHOIS (titulaire)
   • Les champs additionnels spécifiques au TLD (si applicable)
2. La requête est envoyée à l'API HostMyServers via cURL (HTTPS)
3. L'API retourne un statut de succès ou un message d'erreur
4. En cas de succès, WHMCS met à jour le statut du domaine sur Actif et enregistre la date d'expiration

Gestion des enregistrements asynchrones

Certains TLD (notamment les nouvelles extensions et certains ccTLD) n'enregistrent pas le domaine immédiatement. L'enregistrement peut prendre de quelques minutes à quelques heures. Dans ce cas :

• WHMCS marque le domaine en statut En attente (Pending)
• La tâche cron de synchronisation vérifie régulièrement le statut auprès de HostMyServers
• Dès que l'enregistrement est confirmé, le statut passe automatiquement à Actif

Le client reçoit un email de confirmation uniquement quand le domaine passe en statut Actif.

Enregistrement manuel depuis le back-office

Un administrateur peut enregistrer un domaine manuellement (sans passer par le panier client) :

1. Clients → sélectionnez le client
2. Ajouter un nouveau produit/service → Domaine
3. Renseignez le domaine, la durée, le registrar (HostMyServers)
4. Cochez Exécuter le module maintenant pour déclencher l'enregistrement immédiatement
5. Cliquez sur Ajouter

Contacter les contacts WHOIS

Les informations WHOIS sont renseignées lors de la commande et transmises à HostMyServers au moment de l'enregistrement. Si le client ne remplit pas ses informations de contact dans WHMCS, le module utilise les données de son compte (prénom, nom, adresse, email, téléphone).

Exactitude des données WHOIS

Les registres imposent que les données WHOIS soient exactes et à jour. Des données incorrectes peuvent entraîner la suspension ou la suppression du domaine par le registre. Informez vos clients de cette obligation.

Erreurs courantes à l'enregistrement

Message d'erreur	Cause probable	Solution
Domain not available	Le domaine vient d'être pris entre la recherche et la commande	Demander au client de rechercher un autre nom
Invalid contact data	Un champ obligatoire du contact est manquant ou invalide	Vérifier et corriger les données client dans WHMCS
Insufficient funds	Solde HostMyServers insuffisant	Recharger le compte depuis l'espace client HostMyServers
Invalid TLD	L'extension n'est pas supportée par HostMyServers	Vérifier le catalogue TLD disponible dans l'espace client
Additional field required	Champ supplémentaire obligatoire manquant pour ce TLD	Vérifier que les champs additionnels sont bien remplis dans la commande