Boleto com Pix
Cada fatura ganha um boleto registrado no seu convênio do Banco do Brasil, com QR Code Pix e linha digitável na mesma cobrança.
Módulo de pagamento para WHMCS · Banco do Brasil · GPL
Boleto com Pix pelo seu convênio do Banco do Brasil. Fatura do WHMCS baixada sozinha, depois de conferida no BB.
Se a sua empresa cobra pelo Banco do Brasil, cada fatura do WHMCS ganha um boleto com QR Code Pix no seu próprio convênio de cobrança, e o WHMCS baixa a fatura sozinho quando o cliente paga. Sem certificado, sem intermediário e sem taxa por fatura da nossa parte.
BR.S2 — O que o plugin faz
O cliente paga o Pix ou o boleto. O WHMCS confere no BB e baixa.
Baixa conferida
A cada 10 minutos o WHMCS relê os boletos no BB e só baixa a fatura com o boleto liquidado e o valor cheio.
O mesmo boleto
Abrir a fatura de novo mostra o mesmo boleto. Resposta perdida é achada no BB, nunca vira um segundo boleto.
Cancela junto
Fatura cancelada no WHMCS pede a baixa do boleto aberto no BB, e a conferência repete até o BB aceitar.
Sem certificado
Só o Client ID, o Client Secret e a chave da sua aplicação no Portal Developers BB. Nada de arquivo A1.
Convênio compartilhado
Boleto de outro sistema no mesmo convênio nunca é adotado nem baixado pelo módulo.
Testado na homologação de verdade do Banco do Brasil e num WHMCS de teste com o fluxo inteiro, com o pacote carregado num WHMCS 9 de verdade. A produção do BB 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. As tarifas de boleto e Pix são as do seu convênio de cobrança com o Banco do Brasil.
BR.S3 — Como fica na loja
A fatura, com o Pix e o boleto.
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 e a linha digitável são de exemplo; no seu WHMCS vêm os do Banco do Brasil, dentro do tema da sua área do cliente.
BR.S4 — Como instalar
Três passos, e o WHMCS já recebe pelo Banco do Brasil.
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 na homologação
Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Banco do Brasil no ambiente Teste com as credenciais de teste da sua aplicação e o convênio 3128557, e abra uma fatura: o boleto com Pix de teste aparece sem cobrar ninguém.
3. Ligue a produção
Troque para Produção, cole as credenciais de produção, o seu convênio, a carteira e a variação, e pague uma fatura pequena para conferir a baixa.
BR.S5 — Perguntas frequentes
O que perguntam antes de comprar.
Por que não usar um módulo do BB que já existe?
Os módulos do Banco do Brasil para WHMCS que encontrei à venda fazem só o Pix, alguns pedindo certificado A1, ou fazem o boleto mas pararam no WHMCS 8.8, em 2023. O Brasa BB emite o boleto com QR Code Pix na mesma cobrança, roda no WHMCS 8.8 em diante, inclusive no 9, não pede certificado e custa R$ 99,90 por ano.
O que preciso no Banco do Brasil?
Conta PJ com convênio de cobrança (a carteira 17 é a mais comum) e o Pix habilitado no convênio. No Portal Developers BB (developers.bb.com.br), uma aplicação com a API Cobranças: ela dá o Client ID, o Client Secret e a Developer Application Key. Para produção, o BB libera a aplicação para o seu CNPJ. O Client Secret e a chave ficam nos campos de senha do WHMCS, que os guarda cifrados, e nada passa por servidor nosso.
Boleto ou Pix?
Os dois na mesma cobrança: cada fatura mostra o QR Code Pix, o copia e cola e a linha digitável do boleto. Pagou por um, o outro deixa de valer, então ninguém paga duas vezes.
Como a fatura é baixada?
A cada 10 minutos, pelo cron do WHMCS, o módulo relê no BB os boletos em aberto, e abrir a fatura também confere na hora. A fatura só vira paga quando o boleto é o desta fatura, está liquidado e com o valor cheio. Pago a menor não baixa sozinho. O aviso por webhook do BB exige certificado do lado do seu servidor, por isso a versão 0.1 confere pela API.
Abrir a fatura de novo gera outro boleto?
Não. O boleto fica guardado com a fatura e a página mostra o mesmo. Se a resposta do BB se perder no meio do caminho, a próxima abertura acha o boleto já registrado pelo número dele, em vez de emitir outro. Se o valor da fatura mudou, o boleto antigo recebe baixa no BB antes de sair o novo.
Outro sistema usa o mesmo convênio. Dá conflito?
Não. Cada boleto leva um número que só a sua instalação do WHMCS reconhece. Se o número que o módulo ia usar já foi tomado por outro sistema no convênio, ele não adota nem dá baixa nesse boleto: passa para o número seguinte.
E se a fatura for cancelada?
Cancelar a fatura no WHMCS pede a baixa do boleto no BB, se ele ainda está aberto. O BB só aceita a baixa 30 minutos depois do registro: até lá, a conferência de 10 em 10 minutos tenta de novo sozinha. Boleto já pago fica como está e o log de atividades avisa.
O que já foi testado, e o que não foi?
O módulo passou pela homologação de verdade do Banco do Brasil: emissão do boleto com Pix, a mesma fatura aberta de novo, a resposta perdida achada no BB, a consulta, o Pix e a recusa da baixa nos primeiros 30 minutos. Também passou por um WHMCS de teste com o fluxo inteiro, e o pacote que você baixa foi carregado dentro de um WHMCS 9 de verdade. A produção do BB não foi provada, porque pede um convênio de cobrança, e a baixa aceita não deu para ver na homologação, que deixa o boleto em processamento. 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. Escolha o ambiente Teste (homologação do BB) com as credenciais de teste da sua aplicação e o convênio de teste que o BB publica (3128557, carteira 17, variação 35): a fatura mostra um boleto com Pix de teste e ninguém é cobrado. Depois troque para Produção com as credenciais de produção e o seu convênio.
E o estorno?
A versão 0.1 não faz reembolso pelo WHMCS: devolva pelo Banco do Brasil e registre o reembolso na fatura do WHMCS.
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$ 2,50. O CPF ou CNPJ vem do campo de imposto do cliente ou de um campo personalizado com CPF, CNPJ ou documento no nome. O endereço vai junto quando existe; o BB não exige.
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?
Aviso por webhook, cartão, protesto e reembolso pelo WHMCS 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.