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

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

Se o seu WHMCS já recebe pela Woovi, a primeira fatura de cada cliente ganha um QR que paga e autoriza os próximos débitos. Depois disso, cada renovação sai da conta dele no vencimento, com o valor daquela fatura.

BR.S2 — O que o plugin faz

Da primeira fatura ao débito de cada renovação.

Autoriza uma vez

A primeira fatura traz um QR da Woovi que paga a fatura e, no mesmo Pix, autoriza os próximos débitos no banco do cliente.

As próximas se pagam

Cada renovação é debitada no vencimento, sem cartão, sem boleto e sem o cliente lembrar.

Valor da fatura

O mês em que o domínio renova é debitado com o total da fatura, até o teto que você define.

Baixa conferida

A fatura só vira paga depois de o módulo reler o Pix na Woovi, concluído e com o valor inteiro, uma vez só.

Sem fatura, sem débito

Serviço cancelado: o módulo cancela a autorização antes da data, e ninguém é debitado sem fatura.

Recusou, vira Pix comum

Débito recusado ou plano bienal: a fatura mostra um Pix comum da Woovi na hora.

Testado num WHMCS de teste com a Woovi simulada pela documentação oficial, da autorização ao débito da renovação e da recusa ao cancelamento. Ainda não rodou contra a Woovi de verdade: teste no Sandbox da Woovi e pague uma fatura pequena antes de divulgar.

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 Woovi.

BR.S3 — Como fica na loja

A primeira fatura, com o QR que autoriza.

Fatura do WHMCS com o Brasa Pix Automático Woovi: 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 os próximos débitos 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 Woovi, 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 Woovi

Peça ao suporte da Woovi o Pix Automático na sua conta e crie um AppID em API/Plugins. No WHMCS, confira que as faturas saem pelo menos 11 dias antes do vencimento.

3. Ative o gateway

Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Pix Automático (Woovi), cole o AppID e, se quiser, defina o teto do débito.

4. Teste com valor baixo

Teste com a opção Sandbox e depois 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 Woovi no WHMCS com outro módulo. Por que este?

Os módulos Woovi para WHMCS que encontrei fazem Pix comum: o cliente paga cada fatura na mão. Este faz o Pix Automático do Banco Central pela sua conta Woovi: 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 sai com o total da fatura daquele vencimento. O cliente pode pôr um limite no app do banco, mas não abaixo do teto que você configura no módulo; deixado em branco, o teto é o dobro da primeira fatura.

Funciona com plano trimestral ou anual?

Funciona com mensal, trimestral, semestral e anual, os ciclos que a Woovi aceita no Pix Automático. Serviço bienal, trienal ou pagamento único recebe um Pix comum da Woovi na fatura.

O que preciso na Woovi?

Uma conta Woovi com o Pix Automático liberado (peça ao suporte da Woovi) e um AppID criado em API/Plugins no painel. O dinheiro cai na sua conta Woovi. Nada passa por servidor nosso.

Como a fatura é baixada?

Sem webhook. A cada execução do cron do WHMCS e sempre que o cliente abre a fatura, o módulo relê na Woovi as cobranças em aberto. A fatura só vira paga com o Pix concluído e com o valor inteiro, uma vez só, pelo identificador do Pix. Pix de valor diferente não dá baixa.

E se o banco recusar o débito?

A autorização é criada com retentativa, até 3 vezes em 7 dias. Se o débito for recusado de vez, a fatura passa a mostrar um Pix comum da Woovi, válido por um dia, e as próximas seguem no automático.

Quando o débito é criado?

O cron diário do WHMCS cria o débito de 5 a 10 dias antes do vencimento, com o valor da fatura, como a Woovi exige. Por isso o WHMCS tem de gerar as faturas pelo menos 11 dias antes do vencimento (o padrão dele é 14).

E se o cliente cancelar o serviço?

Nunca há débito sem fatura. Se chega a data de um débito e o cliente não tem fatura em aberto com aquele vencimento, o módulo cancela a autorização na Woovi antes que ela debite sozinha, e a próxima fatura pede uma autorização nova.

O cliente pode cancelar a autorização?

Pode, quando quiser, pelo app do banco dele. O cron relê cada autorização e para de criar débitos para quem cancelou; a fatura seguinte mostra o QR de novo.

Abrir a fatura de novo gera outra autorização?

Não. Cada autorização e cada cobrança saem com um identificador nosso, procurado na Woovi antes de criar, então reabrir a fatura ou uma resposta perdida no caminho nunca viram uma segunda cobrança.

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

O módulo rodou num WHMCS de teste com a Woovi simulada a partir da documentação oficial do Pix Automático da Woovi: autorização com a primeira fatura paga, a mesma autorização ao reabrir, baixa só depois da releitura, débito da renovação no prazo certo e com o valor da fatura, cancelamento quando não há fatura, recusa com volta para o Pix comum, cliente sem CPF e plano bienal. Ainda não rodou contra a Woovi de verdade. O módulo tem a opção Sandbox: teste nela e depois 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, e o endereço com CEP, que a Woovi exige; sem CPF ou CNPJ, 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.