Como configurar módulos WHMCS para servidor cloud e automação de pagamentos (guia)

Os módulos do WHMCS concentram, num único painel, fluxos de trabalho específicos como receber pagamentos, atualizar preços de renovação, gerir operações do cliente e controlar os recursos de servidor cloud diretamente através do WHMCS. No catálogo da Hostragons, há cinco integrações independentes para as infraestruturas OVHcloud, AWS Lightsail, Contabo, Microsoft Azure e Google Cloud, com módulos orientados a pagamentos e operações. Este guia compara o que cada um dos 10 módulos faz, quais são os limites de escopo e para quais cenários de uso ele é mais adequado.

Ao escolher um módulo, não basta olhar apenas a lista de funcionalidades. Também é preciso considerar a versão do WHMCS em uso, a conta do fornecedor, as permissões da API, o sistema operacional, o modelo de faturamento e o plano de testes antes de entrar em produção. As integrações aqui descritas não substituem, por exemplo, a licença do WHMCS, a conta do provedor cloud ou a conta do processador de pagamentos relevante. Além disso, taxas de uso, rede, licenças e impostos dos fornecedores podem ser aplicadas separadamente.

Para que servem os módulos do WHMCS e que tarefas eles facilitam?

O núcleo do WHMCS gerencia o ciclo de vida do cliente, pedido, fatura e serviço. Já os módulos “ligam” esse núcleo a fluxos de trabalho específicos. Um módulo de pagamento pode mover a fatura para uma página externa de pagamento e enviar o resultado validado de volta ao WHMCS. Um módulo de operação pode executar atualizações em lote de saldo ou de preços. E um módulo de servidor, por sua vez, pode criar uma máquina virtual vinculada ao pedido e oferecer, na área do cliente, apenas as funções de gestão permitidas.

Essa distinção é importante: nem todo módulo faz tudo. Por exemplo, os módulos de Paddle e Mollie focam o fluxo de pagamentos; o módulo “Customer Credit Manager” atende operações administrativas de crédito; e as integrações cloud focam apenas os recursos daquele provedor específico. Separar sua necessidade primeiro em “pagamentos”, “operação do cliente” e “automação de servidor” ajuda bastante a escolher o produto certo.

Comparação rápida dos 10 módulos do WHMCS

Os preços na tabela são os valores em lista visíveis na data em que este artigo foi publicado; não são um compromisso de preço permanente. Antes de comprar, devem ser considerados os detalhes atuais de escopo, licença e preços apresentados na página do produto.

Módulos de operação: pagamentos e automação administrativa

Atualização automática de preços

Quando os preços recorrentes mudam ao longo do tempo, serviços que já estavam ativos (ou suspensos) podem ficar com o valor antigo de renovação. O módulo Automatic Fee Update é usado para recalcular os valores de renovação de serviço, addon e domínio com base na precificação atual dentro do WHMCS. A execução pode ser feita manualmente uma única vez ou conectada a um fluxo cron agendado.

Este módulo é especialmente útil para empresas que não querem ajustar manualmente muitos registros um por um depois de alterações como mudanças de taxa de câmbio ou de tarifas. Você pode ver exemplos de uso no guia Módulo de atualização automática de preços para WHMCS. Ainda assim, antes de aplicar alterações em lote, é necessário fazer backup do banco de dados, testar em um grupo pequeno e com escopo limitado de clientes e revisar todas as faturas que serão geradas.

Gateway de pagamento Paddle

A integração Paddle Billing V3 inicia pagamentos únicos e por assinatura para faturas do WHMCS via Paddle Checkout. O módulo valida notificações de webhook assinadas com HMAC-SHA256 e ajuda a associar o evento de pagamento recorrente à fatura correta usando o identificador da assinatura. Assim, em vez de confiar apenas no resultado do redirecionamento no navegador, o WHMCS processa as notificações assinadas recebidas do servidor.

O módulo não fornece validação de conta Paddle nem aprovação de elegibilidade comercial. A conta Paddle, as definições de produto, a moeda e a configuração dos webhooks precisam ser completadas pela própria empresa. Para detalhes de instalação, consulte Pagamento Paddle para WHMCS; antes de ir para o Checkout, vale testar separadamente no ambiente de teste os cenários de pagamento bem-sucedido, falhado, cancelado e recorrente.

Gateway de pagamento Mollie

O módulo Mollie liga, às faturas do WHMCS, métodos de pagamento que estejam habilitados na conta Mollie, como iDEAL, cartão, PayPal, Apple Pay, Bancontact, SOFORT e transferência bancária. As chamadas de webhook repassam ao WHMCS o status do pagamento; e o fluxo oferece funções específicas de cada método, como seleção de banco no iDEAL e gestão de vencimento na transferência bancária.

A disponibilidade de um método de pagamento depende do país, moeda, da conta da Mollie e dos métodos ativados nessa conta. Por isso, a expressão “15 métodos” não significa que todas as contas terão todos os métodos ativos. Use o guia Módulo Mollie para WHMCS e, junto com ele, verifique as permissões no painel Mollie e confirme o endpoint webhook antes de publicar em produção.

Transferência de domínio entre clientes

Este módulo cria um processo controlado para que um cliente do WHMCS transfira o seu domínio para outro cliente do WHMCS. A solicitação é iniciada na área do cliente de origem e aprovada por um link de uso único enviado ao endereço de e-mail do cliente destinatário. A validação do token, o registro de IP, a validade ajustável e o acompanhamento de status proporcionam um fluxo mais rastreável do que transferências manuais.

O procedimento aqui é diferente da transferência clássica entre registradores: ele altera a titularidade do cliente dentro do mesmo setup WHMCS. Regras do registrador ainda precisam ser aplicadas, por exemplo relacionadas a lock de transferência, código EPP ou processo de migração de contas externas.

Gestor de saldo do cliente

O Customer Credit Manager é voltado para o que faz mais sentido no dia a dia: filtrar créditos dos clientes na área administrativa do WHMCS e executar operações em lote. Os clientes podem ser encontrados por nome, empresa, e-mail, moeda e status de saldo. A partir da seleção, é possível adicionar crédito em lote às contas escolhidas ou zerar o saldo. As operações são auditadas com nota administrativa e registro de atividade.

Como saldo de crédito afeta registros financeiros diretamente, as permissões de perfis administrativos devem ser limitadas. Antes de executar, a lista de clientes selecionada precisa ser verificada, e alterações volumosas devem ser aplicadas apenas após backups.

Módulos de automação de servidor cloud

Os módulos cloud criam uma ponte entre os registros de pedidos e serviços do WHMCS e as APIs do provedor. Você pode ver como o ciclo de vida do serviço essencial funciona no guia Criação automática de contas de hospedagem com WHMCS. O escopo de operação entregue ao cliente muda conforme o comportamento da API do provedor, as configurações do produto e as autorizações concedidas pela empresa. Esses módulos são integrações independentes: não são produtos desenvolvidos pelos próprios provedores cloud e não trazem declaração de parceria.

OVHcloud VPS & Dedicated

A integração da OVHcloud conecta os serviços VPS e Dedicated ao WHMCS. No lado VPS, operações de ciclo de vida e reinstalação podem ser geridas com verificações de self-service permitidas na área do cliente. No escopo Dedicated, o foco é atribuir o servidor existente a um cliente e direcionar operações controladas; não se deve presumir que ele automatize a compra de novos servidores físicos. Qualquer ação que possa resultar em suspensão, encerramento e perda de dados requer controle do operador.

AWS Lightsail

O módulo AWS Lightsail relaciona ao serviço do WHMCS o provisionamento de servidores, operações de energia, IPv4 estático, fluxos de snapshot e configurações de firewall. As informações de acesso para recursos Linux e Windows são tratadas conforme as regras do próprio ecossistema. Este módulo não é um catálogo genérico de serviços da AWS; é uma integração focada em recursos do Lightsail.

Informações como identidade do provedor, região, nome da instância e IP estático associado devem ser mantidas específicas do serviço. As chaves de API não ficam dentro do ZIP de distribuição; durante a instalação, o cliente configura o módulo com as permissões necessárias a partir da própria conta AWS.

Contabo Cloud

O módulo Contabo Cloud fornece conexões para provisionamento, operações de energia, reinstalação, reset de senha e gestão de snapshots nos recursos VPS e VDS da Contabo. A correspondência correta entre o ID do recurso e o serviço no WHMCS é crítica para consolidar pedidos repetidos no mesmo recurso e para ações como verificações de propriedade e exclusão.

Além disso, é necessário acesso à API e considerar as taxas de uso do provedor na conta Contabo. Não assuma que upgrade de pacote, reverse DNS, VNC no navegador ou qualquer recurso específico de cada fornecedor estejam automaticamente incluídos no escopo do módulo; como referência, sempre use a lista de funcionalidades atual na página do produto.

Microsoft Azure VM

O módulo Microsoft Azure VM conecta ao WHMCS o provisionamento de máquinas virtuais, operações de energia, deallocate, alteração de tamanho, gestão de disco, snapshot e firewall. O grupo de recursos e as tags da máquina virtual são usados para confirmar a titularidade do serviço. A exclusão não deve ser considerada concluída até que o resultado assíncrono da operação no Azure seja confirmado e, sobretudo, até validar que o recurso foi realmente removido.

Para recursos adicionais pagos como discos e snapshots do Azure, o setup de catálogo e precificação fica a cargo da empresa. As opções apresentadas ao cliente devem ficar restritas apenas ao escopo configurado e testado.

Google Cloud Compute Engine

O módulo do Google Cloud conecta o provisionamento, operações de energia, troca do tipo de máquina e a gestão de regras de rede com escopo do serviço em instâncias do Compute Engine baseadas em Linux. Nome do recurso, região e tags do serviço são guardados como identidade persistente; as ações do ciclo de vida são executadas somente depois de verificar essa informação de titularidade.

O escopo do deployment 2.0.0 atual é voltado a workloads Linux. Não planeje suporte para Windows ou RDP como se estivesse incluído. O projeto do Google Cloud, a conta de serviço, configuração de cota, rede e definições de faturamento são fornecidos pela empresa.

Qual módulo do WHMCS você deve escolher?

• Se você quer mover preços antigos de renovação para o catálogo atual, avalie o módulo Automatic Fee Update.
• Se pretende receber pagamentos via Paddle Checkout ou Mollie, escolha o módulo de gateway de pagamento correspondente.
• Se for preciso transferir domínios entre clientes dentro do mesmo setup WHMCS, use o módulo Inter-Client Domain Transfer.
• Se você executa operações de crédito em muitas contas de clientes, o Customer Credit Manager é a opção mais adequada.
• Se você quer conectar serviço de VPS, VDS ou VM a uma API do provedor, escolha apenas o módulo cloud do seu provedor.

Se você oferece VPS ou VDS na sua própria infraestrutura, planeje a automação do WHMCS junto com a estrutura do produto servidor virtual. Já em empresas que usam múltiplos provedores, ative cada integração separadamente com uma conta de API própria, um produto de teste próprio e, se possível, credenciais com permissões baixas e separadas para reduzir a área onde erros podem ocorrer.

Fluxo de compra, download e instalação

1. Verifique o módulo compatível com suas necessidades e o escopo atual exibido na página do produto.
2. No painel do cliente do WHMCS, finalize o pedido e pague a fatura.
3. Depois que o pagamento for aprovado pelo WHMCS, o fluxo oficial Auto Release colocará o serviço em estado Active.
4. Na conta que tem um serviço Active, o download visível será apenas do produto comprado e vinculado ao serviço.
5. Valide o arquivo ZIP, leia a documentação de instalação e carregue os arquivos no ambiente de teste do WHMCS.
6. Após instalar, insira as informações de API do provedor ou do processador de pagamentos nos campos de configuração correspondentes.
7. Somente depois de testar cenários de sucesso e falha, webhooks, timeouts, tentativas de reenvio e encerramento, faça a ativação em produção.

Os arquivos para download não são disponibilizados via diretório web público. A relação produto-serviço e o status Active do serviço determinam a permissão de download na área do cliente. As condições de licença mais recentes e a documentação de instalação na tela de pedido sempre prevalecem sobre este resumo.

Licenças, custos de provedor e limites de segurança

Os arquivos dos módulos são fornecidos com código-fonte não criptografado; isso não significa “open source” nem permissão livre de redistribuição. Os direitos de uso, modificação e redistribuição estão sujeitos ao contrato de licença adquirido e devem ser acompanhados por produto e instalação seguindo a abordagem Gerenciamento de licenças do WHMCS. As chaves de API do provedor, dados reais de clientes, IDs de recursos em produção ou dados operacionais da Hostragons não são incluídos nos pacotes de distribuição.

Na instalação, deve-se aplicar o princípio do menor privilégio. Se possível, forneça ao módulo credenciais separadas apenas com as permissões necessárias para as operações de API; altere rotineiramente os segredos dos webhooks, limite as funções administrativas do WHMCS e mascare dados sensíveis nos logs. Use uma conta de teste dedicada ou um recurso de teste com baixo custo antes de ir para produção. Nos testes de cancelamento e encerramento, valide não apenas a resposta da API do provedor, mas também que o recurso realmente foi removido e que não ficou nenhum recurso adicional pago.

Ao vender o serviço servidor em nuvem, inclua no cálculo de custos não apenas a máquina virtual; considere também disco, snapshot, IP, tráfego, diferenças regionais de preço e licenças. A automação do módulo pode reduzir o tempo operacional, mas não elimina responsabilidades de quota do provedor, aprovação de conta ou faturamento.

Checklist rápido antes da instalação

• Leia a documentação do produto atual para a versão do WHMCS e do PHP em uso.
• Faça backup do banco de dados e dos arquivos.
• Conceda à conta externa de API apenas as permissões necessárias.
• Crie um produto de teste, um cliente de teste e um recurso de provedor de baixo risco.
• Em chamadas repetidas de CreateAccount, confirme que não surgirá um segundo recurso.
• Valide os resultados de suspensão, reativação, encerramento e reinstalação no painel do provedor.
• Nos módulos de pagamento, teste webhook assinado, valores incorretos, reenvio de notificações e cenários de reembolso.
• Após migrar para produção, monitore de perto os primeiros pedidos e os logs de erro.

Perguntas frequentes

O que é um módulo do WHMCS?

Um módulo do WHMCS adiciona ao WHMCS um fluxo de trabalho específico, como pagamentos, operações do cliente ou gestão de servidor. Ele não substitui a licença do WHMCS nem a conta externa do provedor.

Quais provedores cloud são suportados?

Há módulos separados para OVHcloud VPS e Dedicated, AWS Lightsail, Contabo VPS/VDS, Microsoft Azure VM e Google Cloud Compute Engine com base em Linux.

As contas de provedor cloud e as taxas de uso estão incluídas no preço?

Não. A conta do provedor, assinaturas, uso de recursos, rede, licenças e taxas de imposto são cobradas separadamente pelo próprio provedor.

As credenciais de API vêm no pacote do módulo?

Não. Os arquivos ZIP do módulo não incluem credenciais de provedor nem dados de clientes em produção. As informações necessárias são inseridas, após a instalação, nos campos adequados de configuração no WHMCS.

Como baixar o módulo comprado?

Depois que o pagamento for aprovado pelo WHMCS e o serviço correspondente ficar em Active, o cliente verá na área do cliente apenas o acesso de download ao produto comprado, vinculado ao serviço ativo.

Os códigos-fonte do módulo são criptografados?

Os arquivos do módulo são fornecidos com código-fonte não criptografado. Os direitos de uso, personalização e redistribuição seguem as condições da licença adquirida.

Escolha o módulo que encaixa no seu fluxo de trabalho no WHMCS

Compare o escopo, o preço atual e as condições de licença do módulo que atende às suas necessidades: pagamentos, operação do cliente ou automação de servidor cloud. Consulte Confira os módulos do WHMCS e prepare seu plano de testes antes de produção junto com a documentação de instalação.