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.
Módulo de pagamento para WHMCS · iugu · Pix Automático
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
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 faturas seguintes são debitadas no vencimento, sem cartão, sem boleto e sem o cliente lembrar.
Cada débito sai com o total da fatura: o mês em que o domínio renova é debitado com o valor certo.
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ó.
Débito recusado ou vencimento perto demais: a fatura mostra um Pix comum da iugu na hora.
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
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
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.
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.
Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Pix Automático (iugu) e cole o API token.
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
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.
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.
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.
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.
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.
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.
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.
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 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.
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.
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
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.