Pix na fatura
Cada fatura ganha um Pix na sua conta PagBank: QR Code e copia e cola, com o dinheiro direto na sua conta.
Módulo de pagamento para WHMCS · PagBank · GPL
Pix pela sua conta PagBank. Fatura do WHMCS baixada sozinha, depois de conferida no PagBank.
Se a sua empresa recebe pelo PagBank, cada fatura do WHMCS ganha um Pix com QR Code na sua própria conta, e o WHMCS baixa a fatura sozinho quando o cliente paga. Sem intermediário e sem taxa por fatura da nossa parte.
BR.S2 — O que o plugin faz
O cliente paga o Pix. O WHMCS confere no PagBank e baixa.
Baixa conferida
A fatura só vira paga depois de o WHMCS reler o pedido no PagBank, pago, com o valor cheio e sem devolução.
Sem Pix em dobro
Abrir a fatura de novo mostra o mesmo Pix. Resposta perdida é repetida igual e devolve o mesmo pedido.
Nada no painel
Cada Pix já leva o endereço de aviso da sua instalação. E a cada 10 minutos o cron confere o que ficou em aberto.
Reembolso pelo WHMCS
O botão de reembolso do WHMCS devolve o Pix no PagBank, pelo valor inteiro.
Token só seu
O token do PagBank fica cifrado no seu WHMCS. Nenhum dado passa por servidor nosso.
Testado contra o Sandbox de verdade do PagBank e num WHMCS de teste com o fluxo inteiro. A produção ainda não foi provada: antes de divulgar, gere uma fatura pequena e pague.
R$ 99,90 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 é a do seu contrato com o PagBank.
BR.S3 — Como fica na loja
A fatura, com o Pix.
O bloco do pagamento é o HTML que o módulo gera, com dados de exemplo, numa fatura montada para a foto. O código Pix é de exemplo; no seu WHMCS vem o do PagBank, dentro do tema da sua área do cliente.
BR.S4 — Como instalar
Três passos, e o WHMCS já recebe Pix pelo PagBank.
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. Veja no Sandbox
Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Pix PagBank com o token do Sandbox e a opção Sandbox marcada, e abra uma fatura: o Pix de teste aparece sem dinheiro de verdade.
3. Ligue a produção
Cole o token de produção, desmarque Sandbox e pague uma fatura pequena para conferir a baixa.
BR.S5 — Perguntas frequentes
O que perguntam antes de comprar.
Por que não usar o módulo do PagSeguro que já existe?
O módulo grátis do PagSeguro para WHMCS usa a API antiga, sem Pix, e parou de ser mantido. O único módulo de Pix PagBank para WHMCS à venda que encontrei é cobrado por licença de outro desenvolvedor. O Brasa Pix PagBank cobra o Pix na sua conta pela API de Pedidos do PagBank e roda no WHMCS 8.8 em diante, inclusive no 9.
O que preciso no PagBank?
Uma conta PagBank com Pix e o token, em minhaconta.pagbank.com.br, Venda online, Integrações, Gerar token. O token fica cifrado no banco do seu WHMCS, com o segredo da sua instalação, e o dinheiro cai direto na sua conta. Nada passa por servidor nosso.
Como a fatura é baixada?
Cada Pix já leva o endereço de aviso da sua instalação, com um segredo, então não há nada a configurar no painel do PagBank. Quando o aviso chega, o WHMCS relê o pedido no próprio PagBank antes de marcar a fatura como paga: tem de ser o Pix desta fatura, pago, com o valor cheio e sem devolução. Pago a menor não baixa sozinho. Se o aviso não chegar, a página da fatura e uma conferência a cada 10 minutos pelo cron do WHMCS pegam o pagamento.
Abrir a fatura de novo gera outro Pix?
Não. O Pix fica guardado com a fatura e a página mostra o mesmo. Venceu o prazo, sai outro. Cada Pix sai com uma referência desta fatura e a chave de idempotência do PagBank, e o pedido fica gravado antes de sair: uma resposta perdida no caminho é repetida igual e devolve o mesmo Pix, nunca uma segunda cobrança.
E se o valor da fatura mudar?
O PagBank não cancela um Pix antes de ele vencer. Por isso, se o valor da fatura mudar com um Pix ainda válido, a fatura avisa até quando o Pix anterior vale e só gera o do valor novo depois que ele vencer, para o cliente nunca pagar duas vezes.
Quanto tempo o Pix vale?
60 minutos, e você muda nas configurações do gateway, de 5 minutos a 30 dias. Prazo curto deixa curta a espera quando o valor da fatura muda. Venceu, o cliente recarrega a fatura e recebe um Pix novo.
E o reembolso?
O botão de reembolso do WHMCS devolve o Pix no PagBank, só pelo valor inteiro pago.
E se a fatura for cancelada?
O PagBank não cancela Pix, então cancelar a fatura no WHMCS registra no log de atividades se o Pix já foi pago ou até quando ainda pode ser pago. A conferência nunca cancela fatura no WHMCS, porque isso cancelaria o serviço do seu cliente.
O que já foi testado, e o que não foi?
O módulo rodou contra o Sandbox de verdade do PagBank: emitiu o Pix, o mesmo envio devolveu o mesmo pedido, um envio diferente com a mesma chave foi recusado, o simulador pagou e o aviso baixou a fatura uma vez só. Também passou por um WHMCS de teste com o fluxo inteiro. A produção não foi provada, porque pede uma conta PagBank com token de produção, e a devolução o Sandbox não aceita para Pix simulado. Antes de divulgar, gere uma fatura pequena para você mesmo, pague o Pix e confira se ela foi baixada; se algo não fechar, chame no WhatsApp.
Posso testar sem cobrar ninguém?
Pode. Crie a conta no Sandbox do PagBank (portaldev.pagbank.com.br), cole o token do Sandbox, marque Sandbox e abra uma fatura: o Pix de teste aparece sem dinheiro de verdade. Depois cole o token de produção e desmarque.
O que preciso para instalar?
WHMCS 8.8 ou mais novo, com PHP 8.1 ou mais novo e a extensão curl, o cron do WHMCS ativo e a URL do sistema em https, que é para onde o PagBank manda o aviso. As faturas têm de estar em Real, a partir de R$ 1,00. O CPF ou CNPJ vem do campo de imposto do cliente ou de um campo personalizado com CPF, CNPJ ou documento no nome.
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. Pagou depois, ela volta a ficar ativa sozinha.
BR.S6 — Suporte
Sua loja tem algo diferente?
Boleto, cartão e devolução parcial 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.