Module registrar de domaines pour WHMCS

Le module WHMCS de Domain Name API est une extension de registrar qui relie directement votre installation WHMCS à l’infrastructure d’enregistrement de domaines et de SSL de Domain Name API. Une fois installé, WHMCS exécute automatiquement, pour le compte de vos clients, l’enregistrement de domaines, le renouvellement, le transfert, la gestion DNS et les mises à jour WHOIS — sans qu’aucune intervention manuelle de votre part ou de votre équipe ne soit nécessaire. La facturation, le suivi des paiements et les notifications de date d’expiration sont également gérés automatiquement.

Le module prend en charge plus de 800 extensions de domaine, y compris tous les principaux gTLD tels que .com, .net et .org, ainsi que des ccTLD régionaux comme .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in et .ge. Il est compatible avec cPanel, Plesk, DirectAdmin, SolusVM et tous les principaux panneaux de contrôle d’hébergement.

💡 Vous pouvez considérer le module WHMCS comme le pont entre votre vitrine et le bureau d’enregistrement de domaines. Sans lui, chaque commande nécessite une intervention manuelle ; une fois installé, toute votre activité de vente de domaines fonctionne en pilote automatique. Pour les revendeurs ciblant la Turquie et la région MENA, la prise en charge intégrée de .tr et .com.tr ainsi que le mappage des champs pour le numéro d’identité turc et le numéro fiscal facilitent la conformité légale dès le départ.

L’installation du module WHMCS de Domain Name API prend généralement une dizaine de minutes. Un guide pas à pas avec captures d’écran est disponible dans notre base de connaissances, et la vidéo de cette page reprend les mêmes étapes.

1. Téléchargez la dernière version depuis GitHub Releases. N’utilisez pas le bouton vert « Code → Download ZIP » : il télécharge la branche de développement.

2. Décompressez l’archive et copiez le dossier modules à la racine de votre installation WHMCS (par ex. /home/whmcs/public_html). Inutile de téléverser les fichiers .gitignore, README.md et LICENSE.

3. Dans l’administration WHMCS, ouvrez System Settings → Domain Registrars. DomainNameAPI apparaît dès que les fichiers sont en place.

4. Activez le module et saisissez votre Reseller ID et votre API Key. Vous les trouverez tous deux dans votre panneau Domain Name API (dm.apiname.com), sous API Settings ; vos informations de connexion au panneau ne fonctionnent pas ici. Votre solde s’affiche après l’enregistrement.

5. Si vous vendez des domaines .tr, associez les champs numéro d’identité turc et numéro fiscal aux champs client personnalisés correspondants.

6. Importez les prix via Utilities → Registrar TLD Sync → DomainNameApi, ou saisissez-les manuellement.

7. Dans System Settings → General Settings → Domains, activez l’enregistrement, les transferts, les commandes de renouvellement, le renouvellement automatique au paiement, la synchronisation des domaines et la prise en charge des IDN. Dans Automation Settings, activez Domain Sync et Sync Next Due Date.

⚠ Important : si vous mettez à jour une version précédente, sauvegardez vos fichiers de module existants avant de les écraser.

💡 L’erreur d’installation la plus fréquente consiste à placer les fichiers dans le mauvais répertoire : WHMCS ne détecte alors pas le module, sans afficher la moindre erreur. Pour le dépannage, utilisez Utilities → Logs → Module Log avec la journalisation de débogage activée, puis désactivez-la à nouveau en production.

Le module WHMCS de Domain Name API nécessite :

WHMCS 7.8 ou supérieur (la dernière version stable est recommandée)

PHP 7.4 ou supérieur (PHP 8.1 recommandé)

Les extensions PHP cURL et JSON (activées par défaut sur la plupart des serveurs d’hébergement)

Des champs client personnalisés pour le numéro d’identité, le numéro fiscal et le bureau des impôts — nécessaires uniquement pour l’enregistrement de domaines .tr

💡 Utilisez toujours la dernière version stable de WHMCS : des correctifs de sécurité sont publiés régulièrement et les versions obsolètes sont un vecteur d’attaque fréquent. Si vous visez le marché turc, configurez les champs numéro d’identité turc et numéro fiscal dès la configuration initiale : le registre du .tr les exige.

WHMCS est la plateforme d’automatisation d’hébergement la plus utilisée au monde grâce à son modèle de licence abordable, à son vaste écosystème d’intégrations et à son infrastructure d’automatisation mature. Une seule installation WHMCS gère les fiches clients, la facturation, l’activation automatique des services, le suivi des paiements ainsi que les flux de suspension/résiliation. Le système de notifications par e-mail et SMS informe les clients à chaque étape sans nécessiter d’intervention manuelle.

💡 Si vous choisissez une plateforme aujourd’hui, comparez le coût de WHMCS avec celui de WiseCP (particulièrement compétitif sur les marchés turc et MENA) et de Blesta (achat unique, forte maîtrise des données) avant de vous engager. Domain Name API prend en charge les trois plateformes avec des modules dédiés.

Alternatives à WHMCS activement développées et entièrement compatibles avec Domain Name API :

Blesta — convivial pour les développeurs, licence à paiement unique, forte portabilité des données

HostBill — niveau entreprise, plus de 150 intégrations, idéal pour les revendeurs à fort volume

WiseCP — interface moderne, croissance rapide en Turquie et dans la région MENA

ClientExec — ensemble de fonctionnalités plus simple, option de démarrage économique

HostFact — répandu aux Pays-Bas et en Europe occidentale

Les anciennes plateformes comme AWBS, WHMAutoPilot, Lpanel, Modernbill et PerlBill ne sont plus activement développées et ne sont pas recommandées pour de nouvelles installations.

💡 Le choix de la plateforme doit dépendre de votre marché cible. WHMCS est le choix le plus sûr pour les opérations mondiales. WiseCP est une alternative qui se démarque rapidement parmi les revendeurs du marché turc et bénéficie d’une prise en charge complète via le module WiseCP dédié de Domain Name API. HostBill est recommandé aux revendeurs d’entreprise ayant besoin de plus de 150 intégrations, tandis que Blesta convient aux opérateurs recherchant une maîtrise totale des données et un coût unique.

WHMCS est un logiciel commercial distribué sous licence par WHMCS Ltd. ; ses formules sont tarifées selon le nombre de clients actifs et facturées mensuellement. Vérifiez les formules actuelles et les options d’essai sur whmcs.com avant d’acheter.

Le module WHMCS de Domain Name API est quant à lui gratuit et fonctionne avec tous les niveaux de licence WHMCS. Vous ne payez que les domaines que vous enregistrez, à vos prix revendeur.

Oui. WHMCS Ltd. permet de passer d’un niveau de licence à un autre ; vérifiez les conditions de mise à niveau en vigueur sur whmcs.com. Le module Domain Name API fonctionne avec tous les niveaux de licence WHMCS : changer de formule n’a donc aucun effet sur vos réglages registrar.

💡 Commencez avec le niveau correspondant à votre nombre actuel de clients actifs et passez au niveau supérieur à mesure que vous grandissez — la configuration du module reste inchangée.

Le module WHMCS de Domain Name API prend en charge plus de 800 extensions de domaine, y compris tous les grands gTLD tels que .com, .net, .org, .info et .biz, ainsi que .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in, .ge et bien d’autres ccTLD. L’enregistrement de domaines premium est également pris en charge pour les registres proposant une tarification premium.

💡 Les revendeurs qui ciblent des marchés géographiques spécifiques devraient organiser leurs tableaux de prix TLD en donnant la priorité aux extensions locales. Les revendeurs en Turquie devraient mettre en avant les extensions .tr et .com.tr — ces extensions inspirent fortement confiance aux clients locaux et augmentent les taux de conversion. Le positionnement localisé des TLD est l’une des tactiques au ROI le plus élevé dans les campagnes SEO géociblées.

Par défaut, WHMCS vérifie les dates d’expiration des domaines via une tâche cron automatique exécutée toutes les cinq minutes. Lorsqu’une date d’expiration approche, WHMCS crée automatiquement une facture de renouvellement pour le client, envoie des notifications d’expiration à intervalles configurables (généralement 60, 30, 14 et 7 jours avant) et effectue automatiquement le renouvellement si le compte client dispose d’un solde suffisant ou d’un moyen de paiement valide.

Pour que ce processus fonctionne correctement, l’option Domain Sync doit être activée sous Paramètres système > Paramètres généraux > Domaines, afin que WHMCS reçoive toujours les dates d’expiration à jour depuis Domain Name API.

💡 Plusieurs rappels répartis sur les semaines qui précèdent l’expiration passent beaucoup moins inaperçus qu’un e-mail unique. Vérifiez aussi que Sync Next Due Date est activé dans Automation Settings : les écarts entre les dates d’expiration de WHMCS et celles du registre sont l’une des principales causes de pertes de domaines inattendues chez les revendeurs.

La tarification des domaines peut être saisie manuellement pour chaque TLD ou importée automatiquement via l’outil Registrar TLD Sync. Pour la synchronisation automatique : allez dans Utilities > Registrar TLD Sync, sélectionnez DomainNameApi et attendez la fin de la comparaison. L’écran de résultats affiche les marges de profit/perte pour chaque extension et vous permet d’importer les prix en masse.

Vous pouvez également définir Domain Name API comme Lookup Provider (Paramètres système > Tarifs des domaines > Lookup Provider > Modifier > DomainNameApi). Cela permet d’effectuer une vérification de disponibilité en temps réel via l’infrastructure de Domain Name API au lieu des serveurs WHOIS génériques.

💡 La synchronisation automatique des prix est l’une des fonctionnalités les moins utilisées de WHMCS. Exécuter TLD Sync chaque mois garantit que vos prix de vente restent supérieurs à vos coûts, même après des changements tarifaires du fournisseur. Une règle de marge fixe (par ex. coût + 25 %) protège la rentabilité sur plus de 800 extensions sans nécessiter de révision manuelle.

WHMCS propose un système intégré de journalisation des modules pour diagnostiquer les problèmes d’intégration. Allez dans Utilities > Logs > Module Log. Si le bouton Enable Debug Logging apparaît, cliquez dessus pour l’activer. Une fois activé, toutes les requêtes et réponses entre WHMCS et Domain Name API sont enregistrées. Vous pouvez cliquer sur la date de n’importe quelle entrée du journal pour examiner les détails complets de la requête, de la réponse et de la réponse filtrée.

Problèmes fréquemment rencontrés :

Les fichiers du module sont téléversés dans le mauvais répertoire — WHMCS ne détecte pas le module et n’affiche aucune erreur explicite

Identifiants API incorrects — aucun solde n’apparaît après l’enregistrement

Domain Sync est désactivé — les dates d’expiration deviennent obsolètes et les renouvellements échouent silencieusement

💡 Avant de contacter le support, récupérez l’entrée Module Log correspondant à l’opération échouée. La section de réponse filtrée affiche exactement l’erreur renvoyée par Domain Name API ; dans la plupart des cas, le problème devient alors immédiatement compréhensible. Avoir ce journal prêt réduit considérablement le temps de résolution. Gardez la journalisation de débogage désactivée en production afin d’éviter tout impact sur les performances.

Les transferts de domaine sont traités automatiquement via le module de registrar. Lorsqu’un client initie un transfert entrant, WHMCS transmet la demande de transfert à Domain Name API en utilisant le code d’autorisation EPP fourni par le client. Le statut du transfert ainsi que les dates réelles de début et de fin peuvent être affichés en temps réel dans le panneau d’administration. Les administrateurs peuvent également créer directement une demande d’annulation de transfert depuis le panneau de gestion du domaine.

💡 Les échecs de transfert sont le plus souvent dus à des codes EPP expirés, à des verrous de transfert imposés par le registrar actuel ou à la période de verrouillage ICANN de 60 jours suivant un enregistrement récent. Faites particulièrement attention aux transferts de domaines .tr : le numéro d’identité turc et le numéro fiscal du compte client destinataire doivent correspondre aux enregistrements du registrar ; en cas d’incohérence, le transfert peut être rejeté silencieusement, ce qui est difficile à diagnostiquer sans examiner les journaux.