Aller au contenu principal

Dépannage

Cette section recense les problèmes les plus fréquemment rencontrés avec le module registrar HostMyServers pour WHMCS, ainsi que les procédures pour les diagnostiquer et les résoudre.

Activer le mode débogage​

Avant de chercher l'origine d'un problème, activez les logs de débogage dans WHMCS :

Configuration → Système → Modules de registrar → HostMyServers → Configurer → Mode débogage : Activé

Une fois activé, chaque appel API du module est consigné dans les logs WHMCS. Accédez aux logs depuis :

Utilitaires → Activité → Registrar Log

Les entrées affichent la requête envoyée et la réponse reçue de l'API HostMyServers, ce qui permet d'identifier précisément l'origine d'une erreur.

Désactiver après diagnostic

Le mode débogage génère des volumes importants de logs et peut légèrement ralentir votre WHMCS. Désactivez-le dès que le problème est résolu.

Problèmes de connexion​

Le module n'apparaît pas dans la liste des registrars​

Symptôme : après installation, HostMyServers n'est pas visible dans Configuration → Modules de registrar.

Causes et solutions :

  • Le dossier du module n'est pas nommé exactement hostmyservers (tout en minuscules, sans tirets ni espaces) → renommer
  • Le fichier hostmyservers.php est absent ou mal placé → vérifier la structure du dossier
  • Problème de permissions → exécuter chmod 644 sur les fichiers et chmod 755 sur les dossiers
  • Cache WHMCS → Utilitaires → Vider le cache des templates

Erreur « Connexion refusée » ou timeout​

Symptôme : le test de connexion échoue avec une erreur de connexion ou timeout.

Causes et solutions :

  • Le serveur ne peut pas joindre l'endpoint API HostMyServers → vérifier le pare-feu sortant du serveur. L'API utilise le port 443 (HTTPS)
  • cURL non installé ou désactivé → vérifier avec php -m | grep curl

Erreur d'authentification (401 / Invalid credentials)​

Symptôme : le test de connexion retourne « Identifiants invalides » ou une erreur 401.

Causes et solutions :

  • Mauvais identifiant API ou clé API → vérifier sur hostmyservers.fr/user/api
  • Mode Sandbox activé avec des credentials de production (ou inversement) → s'assurer de la cohérence mode / credentials
  • La clé API a été supprimée/recréée sur hostmyservers.fr/user/api sans mise à jour dans WHMCS → mettre à jour la clé dans la configuration du module

Problèmes d'enregistrement / opérations​

Le domaine reste en statut « Pending » indéfiniment​

Symptôme : après une commande, le domaine ne passe jamais en statut Actif.

Causes et solutions :

  • Enregistrement asynchrone normal (certains TLD prennent plusieurs heures) → attendre et forcer une synchronisation
  • Erreur silencieuse lors de l'enregistrement → activer le mode débogage et consulter les logs
  • Solde insuffisant au moment de la commande → vérifier le solde dans l'espace client HostMyServers et compléter si nécessaire, puis relancer l'enregistrement manuellement

Erreur lors du renouvellement automatique​

Symptôme : le cron déclenche un renouvellement qui échoue silencieusement.

Causes et solutions :

  • Solde insuffisant → recharger le compte et relancer le renouvellement manuellement
  • Date d'expiration incorrecte dans WHMCS → lancer une synchronisation pour corriger, puis renouveler
  • Domaine expiré depuis plus de 30 jours (hors période de grâce) → contacter le support HostMyServers pour une restauration

Les nameservers ne sont pas mis à jour​

Symptôme : la modification des nameservers dans WHMCS n'est pas prise en compte chez HostMyServers.

Causes et solutions :

  • Format de nameserver invalide (ex : présence d'un / final ou d'un espace) → vérifier les valeurs saisies
  • TLD ne supportant pas la modification de nameservers via API → consulter la documentation HostMyServers pour ce TLD
  • Erreur API → activer le débogage et consulter les logs

Problèmes de synchronisation​

Les dates d'expiration sont incorrectes dans WHMCS​

Symptôme : la date d'expiration affichée dans WHMCS ne correspond pas à la réalité chez HostMyServers.

Solution :

  1. Allez dans Utilitaires → Synchronisation des domaines
  2. Lancez une synchronisation complète
  3. WHMCS compare et corrige les dates automatiquement

Si le problème persiste sur un domaine spécifique, consultez les logs de synchronisation pour identifier l'erreur retournée par l'API.

La synchronisation ne s'exécute pas​

Symptôme : les statuts et dates ne sont jamais mis à jour automatiquement.

Cause : la tâche cron WHMCS n'est pas configurée ou ne s'exécute pas.

Solution : vérifier la configuration du cron (voir Automatisation).

Problèmes de compte​

Solde insuffisant​

Si votre solde HostMyServers est insuffisant, toutes les opérations payantes (enregistrement, renouvellement, transfert) échoueront avec une erreur Insufficient funds.

Solution : rechargez votre compte depuis l'espace client HostMyServers. Activez les alertes de solde bas pour éviter ce type d'incident.

Commande en attente de validation manuelle​

Certaines commandes peuvent être placées en attente de validation manuelle par HostMyServers (notamment pour des TLD spécifiques ou des volumes inhabituels). Dans ce cas, contactez le support HostMyServers directement.

Contacter le support HostMyServers​

Si vous ne parvenez pas à résoudre votre problème après avoir consulté cette documentation :

  1. Notez le message d'erreur exact et les logs de débogage correspondants
  2. Notez la version du module (visible dans hostmyservers.php en haut du fichier)
  3. Notez votre version WHMCS et PHP
  4. Contactez le support HostMyServers en incluant ces informations

Le support HostMyServers est disponible depuis votre espace client → Support → Ouvrir un ticket.