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

Pix Automático pela sua conta AbacatePay. O cliente autoriza uma vez e as renovações do WHMCS se pagam sozinhas.

A primeira fatura de cada serviço ganha o botão Pagar com Pix Automático: o cliente paga na AbacatePay e, no mesmo Pix, autoriza os próximos débitos. Depois disso, cada renovação sai da conta dele sozinha e a fatura recebe a baixa conferida.

BR.S2 — O que o plugin faz

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

Autoriza uma vez

A primeira fatura leva à página segura da AbacatePay: um Pix paga a fatura e autoriza os próximos débitos no banco do cliente.

As próximas se pagam

A AbacatePay debita cada renovação sozinha, sem cartão, sem boleto e sem o cliente lembrar.

Baixa conferida

Cada débito chega por webhook assinado e é relido na AbacatePay antes de baixar a fatura certa, uma vez só.

Valor mudou, autoriza de novo

Fatura com outro valor cancela a autorização antiga e pede uma nova. Nunca há débito diferente da fatura.

Sem serviço, sem débito

Serviço cancelado ou encerrado: o cron cancela a autorização na AbacatePay.

Recusou, vira Pix comum

Débito recusado, plano bienal ou fatura avulsa: a fatura mostra um Pix comum da AbacatePay.

Testado num WHMCS de teste com a AbacatePay 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 AbacatePay de verdade: teste no Modo Teste dela 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 AbacatePay.

BR.S3 — Como fica na loja

A primeira fatura, com o botão que autoriza.

Fatura do WHMCS com o Brasa Pix Automático AbacatePay: botão Pagar com Pix Automático e o aviso de que as próximas faturas são debitadas sozinhas
O que o cliente vê na primeira fatura. Um Pix na página da AbacatePay paga esta fatura e autoriza os próximos débitos.

O bloco do pagamento é o HTML que o módulo gera, numa fatura montada para a foto. No seu WHMCS ele vem dentro do tema da sua área do cliente, e o botão leva à página de pagamento da AbacatePay.

BR.S4 — Como instalar

Quatro passos, e o WHMCS passa a receber 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 AbacatePay

Peça o Pix Automático em ajuda@abacatepay.com e crie uma chave de API no painel da AbacatePay.

3. Ative o gateway

Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Pix Automático (AbacatePay), cole a chave e crie na AbacatePay o webhook com a URL e o segredo que a tela mostra.

4. Teste com valor baixo

Teste com a chave do Modo Teste e depois pague uma fatura pequena pelo botão, 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.

Por que a AbacatePay?

Entre os meios de Pix Automático que os hosts compararam no Portal do Host, a AbacatePay é o de menor tarifa por cobrança, e não havia módulo para WHMCS que usasse o Pix Automático dela. Este usa a sua conta: o dinheiro cai direto na AbacatePay e nada passa por servidor nosso.

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

A AbacatePay debita sempre o mesmo valor, o da primeira fatura. Quando uma fatura do serviço vem com outro valor, o módulo cancela a autorização antiga e essa fatura mostra o botão para o cliente pagar e autorizar de novo, com o valor novo. Ninguém é debitado com valor diferente da fatura.

Funciona com plano trimestral ou anual?

Funciona com mensal, trimestral, semestral e anual, os ciclos que a AbacatePay aceita no Pix Automático. Serviço bienal ou trienal, fatura avulsa e fatura com mais de um item recebem um Pix comum da AbacatePay.

O que preciso na AbacatePay?

Uma conta AbacatePay com o Pix Automático liberado (peça em ajuda@abacatepay.com), uma chave de API e um webhook criado no painel dela com a URL e o segredo que a tela do gateway mostra no WHMCS.

Como a fatura é baixada?

Cada débito chega pelo webhook, assinado com o segredo da sua instalação, e o módulo confere a cobrança de novo na AbacatePay antes de dar baixa. A baixa vai na fatura em aberto daquele serviço com o mesmo valor, uma vez só. O cliente que volta do pagamento vê a fatura já paga, porque a página também relê a cobrança.

E se o débito chegar antes da fatura?

O débito fica guardado e é aplicado quando o WHMCS gerar a fatura daquele serviço com o mesmo valor. Se em 40 dias nenhuma fatura casar, ele fica registrado no log de atividades para você conferir.

E se o banco recusar o débito?

A fatura passa a mostrar um botão de Pix comum da AbacatePay, e as próximas seguem no automático.

E se o cliente cancelar o serviço?

O cron diário do WHMCS cancela na AbacatePay a autorização de serviço cancelado ou encerrado. Se o cliente cancelar pelo app do banco, o módulo desliga a autorização e a próxima fatura pede outra.

Abrir a fatura de novo gera outra cobrança?

Não. Cada pagamento sai com um identificador nosso, e a fatura reaproveita o pagamento em aberto do mesmo valor. Reabrir a fatura não cria outro.

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

O módulo rodou num WHMCS de teste com a AbacatePay simulada a partir da documentação oficial: primeira fatura paga com a autorização, baixa só depois da releitura, renovação pelo webhook casada com a fatura certa, webhook com assinatura errada recusado, valor que muda, recusa do banco com Pix comum e serviço cancelado. Ainda não rodou contra a AbacatePay de verdade. Teste no Modo Teste dela (chave abc_dev_) e depois pague uma fatura pequena; 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.

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.