Módulo WHMCS

O módulo WHMCS da Domain Name API é um plugin de registrador que conecta diretamente a sua instalação WHMCS à infraestrutura de registro de domínios e SSL da Domain Name API. Após a instalação, o WHMCS executa automaticamente, em nome dos seus clientes, o registro de domínios, renovação, transferência, gestão de DNS e atualizações de WHOIS — sem que você ou sua equipe precisem realizar qualquer operação manual. O faturamento, o acompanhamento de pagamentos e as notificações de data de expiração também são gerenciados automaticamente.

O módulo oferece suporte a mais de 800 extensões de domínio, incluindo todos os principais gTLDs, como .com, .net e .org, além de ccTLDs regionais como .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in e .ge. É compatível com cPanel, Plesk, DirectAdmin, SolusVM e todos os principais painéis de controle de hospedagem.

💡 Você pode pensar no módulo WHMCS como a ponte entre a sua vitrine e o registrador de domínios. Sem ele, cada pedido exige processamento manual; depois de instalado, toda a sua operação de domínios funciona no piloto automático. Para revendedores que visam a Turquia e a região MENA, o suporte integrado para .tr e .com.tr, juntamente com o mapeamento dos campos de número de identidade turco e número fiscal, facilita a conformidade legal desde o início.

A instalação leva menos de 15 minutos. O guia de instalação passo a passo está disponível em domainnameapi.com/tr/bilgi-bankasi/moduller/whmcs-nasil-kurulur, e o vídeo explicativo está disponível em youtube.com/watch?v=LEw_iMnquSo.

Baixe o pacote de módulo mais recente em github.com/domainreseller.

Extraia o arquivo ZIP e copie a pasta modules para o diretório onde o WHMCS está instalado (por exemplo, /home/whmcs/public_html). Não exclua os arquivos .gitignore, README.md e LICENSE.

No painel administrativo do WHMCS, vá para Configurações do Sistema > Registradores de Domínio. Se os arquivos tiverem sido colocados no diretório correto, “Domain Name API” aparecerá na lista.

Ative o módulo e insira o nome de usuário e a senha fornecidos pela Domain Name API. Após salvar, o seu saldo será exibido na tela.

Se você vende domínios .tr, associe os campos de número de identidade turco e número fiscal aos campos personalizados de cliente no WHMCS.

Insira os preços manualmente ou importe em massa os preços em tempo real com configurações de margem de lucro por meio de Utilities > Registrar TLD Sync > DomainNameApi.

Em Configurações do Sistema > Configurações Gerais > Domains, ative o registro de domínios, permissões de transferência, pedidos de renovação, renovação automática no pagamento, sincronização de domínios e suporte a IDN.

Nas Configurações de Automação, ative as opções Domain Sync e Sync Next Due Date.

Importante: se você estiver fazendo uma atualização, faça backup dos seus arquivos de módulo existentes antes de sobrescrevê-los.

💡 O erro de instalação mais comum é enviar os arquivos do módulo para o diretório errado — nesse caso, o WHMCS falha silenciosamente. Após a instalação, confirme se o saldo da sua Domain Name API aparece na tela de configuração do registrador. Para solução de problemas, use a seção Utilities > Logs > Module Log com o debug logging ativado. Mantenha o debug logging desativado em ambiente de produção.

Requisitos para o módulo WHMCS da Domain Name API:

WHMCS 7.8 ou superior (recomenda-se a versão estável mais recente)

PHP 7.4 ou superior (recomenda-se PHP 8.1)

A extensão PHP SOAPClient deve estar ativada no servidor

Campos personalizados de cliente para número de identidade turco, número fiscal e repartição fiscal — obrigatórios para o registro de domínios .tr

💡 Use sempre a versão estável mais recente do WHMCS; correções de segurança são publicadas regularmente. Se você atende o mercado turco, os campos de número de identidade turco e número fiscal são uma exigência legal para registros .tr. Defina esses campos na fase de configuração, antes de ter clientes ativos.

O WHMCS é a plataforma de automação de hospedagem mais utilizada no mundo graças ao seu modelo de licenciamento acessível, ao seu amplo ecossistema de integrações e à sua infraestrutura de automação madura. Uma única instalação do WHMCS gerencia registros de clientes, faturamento, ativação automática de serviços, acompanhamento de pagamentos e fluxos de suspensão/cancelamento. O sistema de notificações por e-mail e SMS mantém os clientes informados em cada etapa, sem exigir intervenção manual.

💡 A licença vitalícia oferecida até 2017 tornou a base de usuários do WHMCS muito estável. Para novas empresas avaliando a plataforma em 2025–2026, vale a pena comparar o custo mensal do WHMCS com o WiseCP (competitivo nos mercados turco e MENA) e o Blesta (pagamento único, forte propriedade dos dados). A Domain Name API oferece suporte às três plataformas com módulos dedicados.

Alternativas ao WHMCS totalmente compatíveis com a Domain Name API e ativamente desenvolvidas:

Blesta — amigável para desenvolvedores, licença de pagamento único, forte portabilidade de dados

HostBill — nível corporativo, mais de 150 integrações, ideal para revendedores de alto volume

WiseCP — interface moderna, crescendo rapidamente na Turquia e na região MENA

ClientExec — conjunto de recursos mais simples, opção inicial econômica

HostFact — comum nos Países Baixos e na Europa Ocidental

Plataformas antigas como AWBS, WHMAutoPilot, Lpanel, Modernbill e PerlBill não são mais desenvolvidas ativamente e não são recomendadas para novas instalações.

💡 A escolha da plataforma deve depender do seu mercado-alvo. O WHMCS é a escolha mais segura para operações globais. O WiseCP é uma alternativa em rápida ascensão entre os revendedores do mercado turco e é totalmente suportado pelo módulo dedicado WiseCP da Domain Name API. O HostBill é recomendado para revendedores corporativos que precisam de mais de 150 integrações, enquanto o Blesta é ideal para operadores que desejam total propriedade dos dados e custo único.

O WHMCS é um software licenciado pago com quatro planos escalonados de acordo com o número de clientes ativos: Starter, Plus, Business e Direct. A cobrança é mensal. Um período de teste gratuito é oferecido para avaliar a plataforma antes de assumir um compromisso.

A Domain Name API oferece pacotes de instalação WHMCS Starter e Mega, entregues com a instalação do tema e a configuração do módulo já concluídas. Esses pacotes reduzem significativamente o tempo e o custo necessários para lançar um novo negócio de revenda de domínios.

💡 Se você está começando, o plano WHMCS Starter é suficiente para até 250 clientes ativos. Os pacotes prontos da Domain Name API eliminam os 2 a 3 dias normalmente gastos com instalação de tema e conexão do módulo; você pode lançar uma vitrine com a sua marca em poucas horas.

Sim. Você pode alternar entre os níveis de licença do WHMCS e os pacotes de instalação WHMCS da Domain Name API a qualquer momento. A alteração entra em vigor no próximo período de faturamento. O módulo WHMCS da Domain Name API é compatível com todos os níveis de licença do WHMCS, incluindo Starter, Plus, Business e Direct.

💡 Comece com o WHMCS Starter. Quando sua base de clientes ultrapassar 250, faça upgrade para Plus ou Business para ter registros ilimitados de clientes e serviços. Os pacotes Starter e Mega da Domain Name API oferecem um ambiente de vendas pronto para quem não deseja configurar tudo do zero.

O módulo WHMCS da Domain Name API suporta mais de 800 extensões de domínio, incluindo todos os principais gTLDs como .com, .net, .org, .info e .biz, além de .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in, .ge e muitos outros ccTLDs. O registro de domínios premium também é suportado para registros que oferecem preços premium.

💡 Revendedores que visam mercados geográficos específicos devem organizar suas tabelas de preços TLD priorizando extensões locais. Revendedores na Turquia devem destacar .tr e .com.tr — essas extensões geram fortes sinais de confiança em clientes locais e aumentam as taxas de conversão. O posicionamento localizado de TLDs é uma das táticas com maior ROI em campanhas de SEO geolocalizadas.

Por padrão, o WHMCS verifica as datas de expiração dos domínios por meio de um cron job automático que é executado a cada cinco minutos. Quando a data de expiração de um domínio se aproxima, o WHMCS cria automaticamente uma fatura de renovação para o cliente, envia notificações de expiração em intervalos configuráveis (geralmente 60, 30, 14 e 7 dias antes) e executa automaticamente a renovação se houver saldo suficiente ou um método de pagamento válido na conta do cliente.

Para que esse processo funcione corretamente, o Domain Sync deve estar ativado em Configurações do Sistema > Configurações Gerais > Domains, para que o WHMCS receba sempre as datas de expiração atualizadas da Domain Name API.

💡 Uma sequência de 4 e-mails em 60/30/14/7 dias reduz a perda de domínios em até 60% em comparação com um único lembrete. Ative também a opção Sync Next Due Date nas Configurações de Automação — divergências de datas entre o WHMCS e o registrador estão entre as causas mais comuns de perda inesperada de domínios.

A precificação de domínios pode ser inserida manualmente para cada TLD ou importada automaticamente por meio da ferramenta Registrar TLD Sync. Para sincronização automática: vá para Utilities > Registrar TLD Sync, selecione DomainNameApi e aguarde a conclusão da comparação. A tela de resultados mostra as margens de lucro/prejuízo de cada extensão e permite importar preços em massa.

Você também pode definir a Domain Name API como Lookup Provider (Configurações do Sistema > Preços de Domínio > Lookup Provider > Alterar > DomainNameApi). Assim, a consulta de disponibilidade em tempo real é feita pela infraestrutura da Domain Name API em vez de servidores WHOIS genéricos.

💡 A sincronização automática de preços é um dos recursos menos utilizados do WHMCS. Executar o TLD Sync mensalmente garante que seus preços de varejo permaneçam acima do custo, mesmo após alterações de preço do fornecedor. Uma regra de margem fixa (por exemplo, custo + 25%) protege a rentabilidade em mais de 800 extensões sem exigir revisão manual.

O WHMCS oferece um sistema de logs de módulo integrado para diagnosticar problemas de integração. Vá para Utilities > Logs > Module Log. Se o botão Enable Debug Logging aparecer, clique nele para ativar. Depois de ativado, todas as solicitações e respostas entre o WHMCS e a Domain Name API são registradas. Você pode clicar na data de qualquer entrada de log para examinar os detalhes completos da solicitação, da resposta e da resposta filtrada.

Problemas comuns:

Arquivos do módulo enviados para o diretório errado — o WHMCS não detecta o módulo e não mostra erro explícito

Credenciais de API incorretas — o saldo não aparece após salvar

Domain Sync desativado — as datas de expiração ficam desatualizadas e as renovações falham silenciosamente

💡 Antes de entrar em contato com o suporte, obtenha a entrada do Module Log referente à operação com falha. A seção de resposta filtrada mostra exatamente o erro retornado pela Domain Name API; na maioria dos casos, o problema se torna imediatamente claro. Ter esse log em mãos reduz significativamente o tempo de resolução. Mantenha o debug logging desativado em produção para evitar impacto no desempenho.

As transferências de domínio são processadas automaticamente por meio do módulo de registrador. Quando um cliente inicia uma transferência de entrada, o WHMCS encaminha a solicitação de transferência para a Domain Name API usando o código de autorização EPP fornecido pelo cliente. O status da transferência e as datas reais de início/fim podem ser visualizados em tempo real no painel administrativo. Os administradores também podem criar diretamente uma solicitação de cancelamento de transferência no painel de gerenciamento do domínio.

💡 As falhas de transferência ocorrem com mais frequência devido a códigos EPP expirados, bloqueios de transferência no registrador atual ou ao período de bloqueio de 60 dias da ICANN após um registro recente. Preste atenção especial às transferências de domínios .tr: o número de identidade turco e o número fiscal na conta do cliente destinatário devem corresponder aos registros do registrador; discrepâncias podem causar recusas silenciosas de transferência, difíceis de diagnosticar sem examinar os logs.