Pix na fatura
Cada fatura ganha um Pix na sua conta Pagar.me: QR Code e copia e cola, com o dinheiro direto na sua conta.
Módulo de pagamento para WHMCS · Pagar.me · GPL
Pix pela sua conta Pagar.me. Fatura do WHMCS baixada sozinha, depois de conferida no Pagar.me.
Se a sua empresa recebe pelo Pagar.me, 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 Pagar.me e baixa.
Baixa conferida
A fatura só vira paga depois de o WHMCS reler o pedido no Pagar.me, pago e com o valor cheio.
Sem Pix em dobro
Abrir a fatura de novo mostra o mesmo Pix. Valor mudou ou venceu: o antigo é cancelado antes do novo.
Reembolso pelo WHMCS
O botão de reembolso do WHMCS devolve o Pix no Pagar.me, pelo valor inteiro.
Cancela junto
Fatura cancelada no WHMCS cancela o Pix aberto no Pagar.me, para ninguém pagar uma fatura morta.
Chave só sua
A chave secreta fica cifrada no seu WHMCS. Nenhum dado passa por servidor nosso.
Testado contra uma conta de teste de verdade do Pagar.me, com o pacote carregado num WHMCS 9 de verdade. 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 Pagar.me.
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 Pagar.me, dentro do tema da sua área do cliente.
BR.S4 — Como instalar
Três passos, e o WHMCS já recebe Pix pelo Pagar.me.
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 com a chave de teste
Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Pix Pagar.me com a chave sk_test_ e abra uma fatura: o simulador paga o Pix e a fatura é baixada, sem dinheiro.
3. Ligue a produção
Troque pela chave sk_, crie no Pagar.me o webhook com o endereço que a tela do gateway mostra 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 Pagar.me que já existe?
O único módulo Pagar.me para WHMCS à venda que encontrei custa R$ 450 por ano mais R$ 100 de instalação e faz só cartão de crédito, sem Pix. O Pagar.me não tem módulo oficial para WHMCS. O Brasa Pix Pagar.me cobra o Pix na sua conta, pela API Core v5, e roda no WHMCS 8.8 em diante, inclusive no 9.
O que preciso no Pagar.me?
Uma conta Pagar.me com Pix habilitado e a chave secreta, em Desenvolvimento, Chaves. A chave fica cifrada 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?
O Pagar.me avisa o seu WHMCS pelo webhook, e o WHMCS relê o pedido no próprio Pagar.me antes de marcar a fatura como paga: tem de ser o Pix desta fatura, pago, com o valor cheio. Pago a menor não baixa sozinho. Se o aviso não chegar, a página da fatura e uma conferência de hora em hora 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. Se o valor mudou ou o prazo do Pix venceu, o antigo é cancelado no Pagar.me antes de sair o novo; se o antigo não cancelar, nenhum Pix novo sai. Cada Pix leva um código desta fatura e a chave de idempotência do Pagar.me, então uma resposta perdida no caminho nunca vira duas cobranças.
Quanto tempo o Pix vale?
24 horas, e você muda nas configurações do gateway, de 5 minutos a 30 dias. 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 Pagar.me, só pelo valor inteiro: o Pagar.me transforma a devolução parcial de um Pix em devolução total, então a parcial é recusada antes de chegar a ele.
E se a fatura for cancelada?
Cancelar a fatura no WHMCS cancela o Pix aberto no Pagar.me, para ninguém pagar uma fatura morta. O caminho inverso fica de fora de propósito: 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 uma conta de teste de verdade do Pagar.me: emitiu o Pix, o mesmo envio devolveu o mesmo pedido, o simulador pagou, o aviso baixou a fatura uma vez só, o reembolso parcial foi recusado e o inteiro aceito. O pacote que você baixa foi carregado dentro de um WHMCS 9 de verdade. A produção não foi provada, porque pede uma conta Pagar.me com chave de produção. 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. Cole a chave de teste (sk_test_) e abra uma fatura: o simulador do Pagar.me paga o Pix em segundos, sem dinheiro, e a fatura é baixada. Depois troque pela chave de produção.
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. 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.