Módulo de pagamento para WHMCS · Pix Automático do Asaas · Valor variável

Pix Automático no WHMCS. O cliente autoriza uma vez.

Na primeira fatura, um Pix do Asaas paga a fatura e autoriza o débito mensal no banco do cliente. Depois, cada fatura é debitada sozinha no vencimento, com o valor que ela tiver naquele mês, inclusive o da renovação do domínio.

BR.S2 — O que o módulo faz

Da primeira fatura ao débito de todo mês.

Autoriza uma vez

A primeira fatura traz um QR Code do Asaas que paga a fatura e, no mesmo Pix, autoriza o débito mensal no banco do cliente.

As próximas se pagam sozinhas

As faturas seguintes são debitadas no vencimento, sem cartão, sem boleto e sem o cliente lembrar.

Valor variável

O mês em que o domínio renova é debitado com o total da fatura. O piso é o valor da primeira.

Sem saldo, nova tentativa

O Asaas tenta de novo 2 dias depois, até 3 vezes em 7 dias, e a fatura avisa o cliente da nova data.

Baixa uma vez só

O webhook do Asaas dá baixa na fatura uma vez só, com a taxa do Asaas lançada. Pix de outro sistema na mesma conta é ignorado.

Pix comum quando precisa

Vencimento perto demais ou cliente sem autorização: a fatura mostra um Pix comum do Asaas na hora.

Feito para quem cobra hospedagem e mensalidade pelo WHMCS. Outros painéis de cobrança para hospedagem já anunciam Pix Automático, como o Isistem e o MVO Panel; entre os módulos de WHMCS que conferimos, nenhum fazia isso pelo Asaas.

R$ 297 por ano por instalação do WHMCS, no Pix, boleto ou cartão, com as atualizações e o suporte do ano. A tarifa do Pix Automático é a da sua conta do Asaas. O arquivo é liberado na área do cliente assim que o pagamento é confirmado. Tem loja em WooCommerce? O Brasa Pix Automático para WooCommerce faz o mesmo nas assinaturas.

BR.S3 — Como fica na fatura

O cliente autoriza, a fatura avisa o resto.

Bloco do módulo na fatura do WHMCS: fatura em aberto de R$ 5,00 por Pix Automático, com o QR Code, o Pix copia e cola e o aviso de que as próximas faturas são debitadas sozinhas
1. Primeira fatura. Um Pix só paga a fatura e autoriza o débito mensal no app do banco do cliente.
Dois avisos do módulo na fatura: débito automático agendado de R$ 50,00 para 13/11/2026 e, sem saldo, nova tentativa em 15/11/2026
2. Próximas faturas. O cliente vê a data do débito e, se faltar saldo, a data da nova tentativa.

O primeiro bloco é o que o módulo devolveu no WHMCS 9 da própria DesignMaster em 05/11/2026 para uma fatura de teste de R$ 5,00, com o QR gerado no sandbox do Asaas. O segundo traz os avisos que o módulo mostrou no nosso teste de ponta a ponta contra o sandbox do Asaas, para uma fatura de R$ 50,00. Os dois aparecem aqui fora do tema; no seu WHMCS eles entram na fatura com o estilo do seu tema. O sandbox não simula o banco do cliente aprovando a autorização, então faça a sua primeira cobrança com uma fatura de valor baixo.

BR.S4 — Como instalar

Três passos e uma chave de API.

1. Envie os arquivos

Na área do cliente, baixe o .zip e descompacte na pasta raiz do WHMCS, a que tem o init.php. Ele só cria arquivos novos em modules/gateways e includes/hooks.

2. Cole a chave do Asaas

Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Pix Automático (Asaas) e cole a chave de API do Asaas. A configuração mostra o nome da conta e cria sozinha o webhook que dá baixa nas faturas.

3. Teste com valor baixo

Pague uma fatura de teste de valor baixo pelo QR, com o app do seu banco, para ver a autorização e a baixa. Chave de sandbox usa o sandbox do Asaas.

BR.S5 — Perguntas frequentes

O que perguntam antes de comprar.

O valor da fatura muda no mês em que o domínio renova. Funciona?

Funciona. A autorização é mensal e de valor variável: o cliente não fixa um valor no banco, então o mês em que o domínio renova ou ele contrata outro serviço é debitado com o total da fatura. O piso é o valor da primeira fatura, e é assim que o Asaas guarda a autorização (mensal, sem valor fixo, com esse piso), como conferimos no sandbox.

E se o cliente estiver sem saldo no dia do débito?

O banco recusa e o módulo pede ao Asaas uma nova tentativa 2 dias depois, até 3 dentro de 7 dias. A fatura avisa o cliente da nova data e não oferece outro Pix enquanto isso. Esgotadas as tentativas, ou se a recusa for por outro motivo, a fatura passa a mostrar um Pix comum.

E se o vencimento da fatura estiver perto demais?

O débito é agendado pelo cron diário do WHMCS 3 dias úteis antes do vencimento, porque o Asaas exige de 2 a 10 dias. Fatura com vencimento perto demais, ou de cliente que ainda não autorizou, mostra na hora um Pix comum do Asaas, baixado pelo mesmo webhook. As próximas seguem no automático.

O cliente não tem CPF ou CNPJ no cadastro. E agora?

O módulo lê o campo Tax ID do WHMCS ou um campo personalizado de cliente com CPF ou CNPJ no nome. Sem documento, a fatura pede para o cliente preencher em Meus dados, e nada vai ao Asaas até lá.

Que conta do Asaas eu preciso?

Conta Pessoa Jurídica aprovada, com CNPJ ativo há pelo menos 6 meses e sem restrição de Pix, que é a regra do Asaas para liberar o Pix Automático. A configuração do gateway avisa se a conta não atende. A tarifa do Pix Automático é a da sua conta do Asaas; o módulo não cobra nada por fatura.

Como o cliente cancela?

Pelo app do próprio banco, quando quiser, como em todo Pix Automático; a fatura já diz isso na hora de autorizar. O Asaas avisa o módulo do cancelamento, e a próxima fatura desse cliente volta a mostrar o QR Code para pagar e autorizar de novo.

O que preciso para instalar?

WHMCS 8.8 ou mais novo, com PHP 8.1 ou mais novo, a extensão curl e o cron do WHMCS ativo, e faturas em Real (BRL). O módulo só cria arquivos novos em modules/gateways e includes/hooks e tabelas próprias; não mexe em tema nem em outro gateway.

E se eu não renovar a licença?

O módulo continua funcionando no seu WHMCS como está, porque ele não consulta licença nem desliga recurso. A fatura da renovação sai 20 dias antes do vencimento; sem pagamento, a licença fica suspensa 30 dias depois e a área do cliente deixa de liberar as versões novas e o suporte. Pagou depois, ela volta a ficar ativa sozinha.

BR.S6 — Suporte

Sua conta do Asaas atende?

Chame no WhatsApp com a sua dúvida sobre o Asaas ou o WHMCS. Você fala com quem escreveu o módulo.