Módulo de pagamento para WHMCS · iugu · Pix Automático

Pix Automático pela sua conta iugu. O cliente autoriza uma vez e as faturas do WHMCS se pagam sozinhas.

Se o seu WHMCS já recebe pela iugu, a primeira fatura de cada cliente ganha um QR que paga e autoriza o débito mensal. Depois disso, cada fatura sai da conta dele no vencimento, com o valor daquele mês.

BR.S2 — O que o plugin faz

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

Autoriza uma vez

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

As próximas se pagam

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

Valor de cada mês

Cada débito sai com o total da fatura: o mês em que o domínio renova é debitado com o valor certo.

Baixa conferida

A fatura só vira paga depois de o módulo reler a cobrança na iugu, paga e com o valor inteiro, uma vez só.

Recusou, vira Pix comum

Débito recusado ou vencimento perto demais: a fatura mostra um Pix comum da iugu na hora.

Só o token

Nada de certificado nem gatilho: cole o API token e o cron do WHMCS confere as cobranças em aberto.

Testado num WHMCS de teste com a iugu simulada pela documentação oficial da API, da autorização ao débito do mês e da recusa ao cancelamento no banco. Ainda não rodou contra a iugu de verdade, porque a iugu não tem ambiente de teste para o Pix Automático: antes de divulgar, pague uma fatura pequena.

R$ 297 por ano por instalação do WHMCS, no Pix, boleto ou cartão, com as atualizações e o suporte do ano, sem taxa por fatura. O arquivo é liberado na área do cliente assim que o pagamento é confirmado. A tarifa do Pix Automático é a da sua conta iugu, combinada com a iugu.

BR.S3 — Como fica na loja

A primeira fatura, com o QR que autoriza.

Fatura do WHMCS com o Brasa Pix Automático iugu: QR Code, código copia e cola e o aviso de que as próximas faturas são debitadas sozinhas
O que o cliente vê na primeira fatura. Um Pix só paga esta fatura e autoriza o débito mensal no app do banco.

O bloco do pagamento é o HTML que o módulo gera, com um código de exemplo, numa fatura montada para a foto. No seu WHMCS vem o código da iugu, dentro do tema da sua área do cliente.

BR.S4 — Como instalar

Quatro passos, e o WHMCS passa a debitar pelo Pix Automático.

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.

2. Prepare a iugu

No painel da iugu, ative o Pix na conta, confirme com a iugu que o Pix Automático está liberado e copie o API token de produção.

3. Ative o gateway

Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Pix Automático (iugu) e cole o API token.

4. Teste com valor baixo

Pague uma fatura pequena pelo QR, com o app do seu banco, para ver a autorização e a baixa antes de ligar para todos os clientes.

BR.S5 — Perguntas frequentes

O que perguntam antes de comprar.

Já recebo pela iugu no WHMCS com outro módulo. Por que este?

Os módulos iugu para WHMCS que existem fazem boleto, cartão ou Pix comum: o cliente paga cada fatura na mão. Este faz o Pix Automático do Banco Central pela sua conta iugu: o cliente autoriza uma vez e as próximas faturas saem da conta dele no vencimento, sem cartão, boleto ou lembrete.

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

Funciona. Cada débito é criado na iugu com o total da fatura daquele mês, então o mês da renovação do domínio, ou de um serviço novo, é debitado com o valor certo.

O que preciso na iugu?

Uma conta iugu verificada, com o Pix ativo e o Pix Automático liberado, e o API token de produção. O dinheiro cai direto na sua conta iugu. Nada passa por servidor nosso.

Como a fatura é baixada?

Sem gatilho (webhook) para configurar. A cada execução do cron do WHMCS e sempre que o cliente abre a fatura, o módulo relê na iugu as cobranças em aberto. A fatura só vira paga com a cobrança paga no valor inteiro, uma vez só, pelo identificador do Pix. Pix menor que a fatura ou cobrança estornada não dão baixa.

E se o banco recusar o débito?

Se o débito não passar, a fatura passa a mostrar um Pix comum da iugu na hora, e as próximas seguem no automático.

E se o vencimento estiver perto demais?

O Banco Central exige que o débito seja agendado de 2 a 10 dias antes do vencimento. O cron diário agenda 3 dias úteis antes. Se a fatura já está mais perto do que isso, ou o cliente não tem autorização ativa, ela mostra um Pix comum da iugu na hora. Uma segunda fatura no mesmo mês também vai por Pix comum.

O cliente pode cancelar?

Pode, quando quiser, pelo app do banco dele. O cron diário relê cada autorização ativa e para de agendar débitos para quem cancelou.

Abrir a fatura de novo gera outra cobrança?

Não. O QR fica guardado com a fatura por 23 horas e a página mostra o mesmo. Cada cobrança sai com um número de pedido nosso, procurado na iugu antes de criar, então uma resposta perdida no caminho nunca vira segunda cobrança. Se o valor da fatura mudar antes do pagamento, sai um QR novo com o valor novo.

O que já foi testado, e o que não foi?

O módulo rodou num WHMCS de teste com a iugu simulada a partir da documentação oficial da API (dev.iugu.com): autorização pela Jornada 3, o mesmo QR ao reabrir a fatura, resposta perdida achada pelo número do pedido, baixa só depois da releitura, débito do mês, recusa com volta para o Pix comum, cancelamento no banco, Pix menor que a fatura e duas conferências ao mesmo tempo, com uma baixa só. Ainda não rodou contra a iugu de verdade: a iugu não tem ambiente de teste para o Pix Automático, só a produção. Antes de divulgar, pague uma fatura pequena com o app do seu banco; se algo não fechar, chame no WhatsApp.

O que preciso para instalar?

WHMCS 8.8 ou mais novo, com PHP 8.1 ou mais novo e a extensão curl, e o cron do WHMCS ativo, de preferência a cada 5 minutos. As faturas têm de estar em Real. O CPF ou CNPJ vem do campo de imposto do cliente ou de um campo personalizado com CPF ou CNPJ no nome; sem ele, a fatura pede para o cliente preencher.

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.

BR.S6 — Suporte

Sua loja tem algo diferente?

Cartão, boleto e devolução ficam de fora da versão 0.1. Se o seu WHMCS precisa de outra coisa, ou se a primeira fatura não fechar, chame no WhatsApp. Você fala com quem escreveu o módulo.