Configuration du module registrar

Une fois le module installé, vous devez l'activer dans WHMCS et renseigner vos identifiants API HostMyServers.

Activer le module

1. Connectez-vous à l'administration WHMCS
2. Naviguez vers Configuration → Système → Modules de registrar
3. Repérez HostMyServers dans la liste
4. Cliquez sur Activer

Le module est maintenant actif. Un formulaire de configuration apparaît.

Paramètres de connexion

Après activation, renseignez les champs suivants :

Clé API (API Key)

Une clé API générée depuis hostmyservers.fr/user/api. Depuis cette page, vous pouvez créer une clé, lui donner un nom (ex : WHMCS Production) et la supprimer à tout moment. Traitez cette clé comme un mot de passe : ne la partagez jamais et ne la versionnez pas dans un dépôt Git.

Sécurité de la clé API

Si vous pensez que votre clé API a été compromise, supprimez-la immédiatement depuis hostmyservers.fr/user/api et créez-en une nouvelle. Mettez ensuite à jour la clé dans la configuration du module WHMCS.

Pour obtenir des credentials sandbox, contactez le support HostMyServers.

Contact Owner par défaut (Owner Contact)

Ce champ définit le contact titulaire utilisé par défaut lors de l'enregistrement de chaque domaine. Deux options sont disponibles :

Option 1 — Utiliser le profil du compte HostMyServers

Cochez Utiliser le titulaire du compte (use_account_owner: true). Les informations du profil associé à la clé API (nom, adresse, email, téléphone) sont automatiquement utilisées comme contact Owner.

Option 2 — Utiliser un contact existant

Renseignez un identifiant de contact (contact_id) issu de votre carnet de contacts HostMyServers. Pour récupérer la liste de vos contacts disponibles, interrogez l'endpoint :

GET /domains/contacts

La réponse liste l'ensemble de vos contacts avec leur id, que vous pouvez copier dans ce champ.

Quand utiliser un contact_id ?

Utilisez un contact_id si vous enregistrez des domaines pour le compte d'une entité différente de votre profil principal (ex : une société distincte, une filiale). Cela permet d'avoir un Owner cohérent sans modifier vos informations de compte.

Tester la connexion

Après avoir saisi vos identifiants, cliquez sur Enregistrer puis sur le bouton Tester la connexion. WHMCS va effectuer un appel test vers l'API HostMyServers et afficher le résultat :

• Succès : « Connexion réussie. Solde du compte : XX.XX € » — votre configuration est opérationnelle
• Erreur d'authentification : vérifiez votre identifiant API et votre clé
• Erreur de connexion : vérifiez que votre serveur peut joindre l'API HostMyServers (pare-feu, cURL activé)

Paramètres avancés

Synchronisation automatique des domaines

Ce paramètre active la synchronisation périodique des statuts et dates d'expiration de vos domaines. Il est fortement recommandé de le laisser activé pour maintenir la cohérence entre WHMCS et HostMyServers.

Valeur recommandée : Activé

Délai de propagation DNS (en heures)

Durée affichée au client après une modification de nameservers, indiquant le délai de propagation estimé. Cela n'a aucun impact technique.

Valeur par défaut : 24

Afficher le solde dans le dashboard

Si activé, un widget affiche votre solde HostMyServers dans le tableau de bord d'administration WHMCS.

Valeur recommandée : Activé (utile pour anticiper les rechargements de compte)

Récapitulatif

Une fois la configuration terminée et le test de connexion validé, votre module registrar HostMyServers est prêt. Passez à l'étape suivante : la gestion des extensions.