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.
Módulo de pagamento para WHMCS · AbacatePay · Pix Automático
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
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.
A AbacatePay debita cada renovação sozinha, sem cartão, sem boleto e sem o cliente lembrar.
Cada débito chega por webhook assinado e é relido na AbacatePay antes de baixar a fatura certa, uma vez só.
Fatura com outro valor cancela a autorização antiga e pede uma nova. Nunca há débito diferente da fatura.
Serviço cancelado ou encerrado: o cron cancela a autorização na AbacatePay.
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
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
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.
Peça o Pix Automático em ajuda@abacatepay.com e crie uma chave de API no painel da AbacatePay.
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.
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
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.
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 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.
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.
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.
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.
A fatura passa a mostrar um botão de Pix comum da AbacatePay, e as próximas seguem no automático.
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.
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 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.
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 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.