Autoriza uma vez
A primeira fatura traz um QR da Efí que paga a fatura e, no mesmo Pix, autoriza o débito mensal no banco do cliente.
Módulo de pagamento para WHMCS · Efí · Pix Automático
Se o seu WHMCS já recebe pela Efí, 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 Efí 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.
O mês em que o domínio renova é debitado com o total da fatura. O piso é o valor da primeira.
A fatura só vira paga depois de o módulo reler o Pix na Efí, concluído e com o valor inteiro, uma vez só.
Débito recusado ou vencimento perto demais: a fatura mostra um Pix comum da Efí na hora.
Nada a configurar para a Efí avisar: o cron do WHMCS confere as cobranças em aberto a cada execução.
Testado num WHMCS de teste com uma Efí simulada, do QR ao débito, da recusa ao cancelamento no banco. Ainda não rodou contra a Efí de verdade: antes de divulgar, use a homologação da Efí e 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 Efí.
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 Efí, 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.
Converta o .p12 da aplicação Efí para .pem com a chave e guarde fora da pasta pública. O LEIA-ME traz o comando.
Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Pix Automático (Efí) e preencha Client ID, Client Secret, o caminho do .pem, a chave Pix, agência e conta.
Use a homologação da Efí e depois pague uma fatura pequena pelo QR, com o app do seu banco, para ver a autorização e a baixa.
BR.S5 — Perguntas frequentes
Os módulos Efí para WHMCS que encontrei, inclusive os grátis, fazem Pix comum: o cliente paga cada fatura na mão. Este faz o Pix Automático do Banco Central na sua conta Efí: o cliente autoriza uma vez e as próximas faturas saem da conta dele no vencimento, sem cartão, boleto ou lembrete.
Funciona. A autorização é mensal e de valor variável: o cliente não fixa um valor no banco, então o mês da renovação do domínio, ou de um serviço novo, é debitado com o total da fatura. O piso é o valor da primeira fatura.
Uma conta Efí Empresas com Pix Automático liberado, uma aplicação com os escopos de Pix Automático (rec, cobr, cob e locrec), o certificado dela convertido para .pem e uma chave Pix. O dinheiro cai direto na sua conta Efí. Nada passa por servidor nosso.
Sem webhook. A Efí manda o aviso com certificado dos dois lados, o que hospedagem compartilhada raramente aceita. Por isso, a cada execução do cron do WHMCS e sempre que o cliente abre a fatura, o módulo relê na Efí as cobranças em aberto. A fatura só vira paga com um Pix concluído do valor inteiro, uma vez só, pelo identificador do Pix. Pix menor que a fatura não dá baixa.
A recorrência é criada com retentativa permitida, até 3 vezes em 7 dias quando o banco do cliente fizer. Se o débito for recusado, a fatura passa a mostrar um Pix comum da Efí, e as próximas seguem no automático.
O Banco Central exige que o débito seja agendado de 2 a 10 dias úteis 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 Efí na hora.
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 identificador nosso, lido na Efí 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 uma Efí simulada que guarda estado: primeira fatura, autorização, 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ó. Ele ainda não rodou contra a Efí de verdade, porque isso pede uma conta Efí Empresas. Antes de divulgar, use o ambiente de homologação da Efí 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 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.