Boleto com Pix
Cada fatura ganha um boleto híbrido na sua conta de cobrança do Sicoob: QR Code Pix e linha digitável juntos.
Módulo de pagamento para WHMCS · Sicoob · GPL
Boleto com Pix pela sua conta Sicoob. Fatura do WHMCS baixada sozinha, depois de conferida no Sicoob.
Se a sua empresa cobra pelo Sicoob, cada fatura do WHMCS ganha um boleto híbrido com QR Code Pix na sua própria conta de cobrança, 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 ou o boleto. O WHMCS confere no Sicoob e baixa.
Baixa conferida
A fatura só vira paga depois de o WHMCS reler o boleto no Sicoob, liquidado e com o valor cheio.
Sem boleto em dobro
Abrir a fatura de novo mostra o mesmo boleto. Valor mudou: o antigo recebe baixa antes do novo.
Cancela junto
Fatura cancelada no WHMCS pede a baixa do boleto no Sicoob, para ninguém pagar uma fatura morta.
Sandbox para ver antes
O modo Teste usa o Sandbox público do Sicoob: você vê a fatura com boleto e Pix sem cobrar ninguém.
Certificado só seu
O certificado e a chave da empresa ficam cifrados no seu WHMCS. Nenhum dado passa por servidor nosso.
Testado no Sandbox público do Sicoob e num WHMCS de teste com o fluxo inteiro, com o pacote carregado num WHMCS 9 de verdade. A produção do Sicoob 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 a cooperativa.
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 Sicoob, dentro do tema da sua área do cliente.
BR.S4 — Como instalar
Três passos, e o WHMCS já recebe pelo Sicoob.
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 Sicoob no ambiente Teste 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 o Client ID, o número do cliente, a conta, o certificado e a chave, 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 Sicoob que já existe?
O único módulo Sicoob pago para WHMCS que encontrei vende o boleto e o Pix separados, por US$ 149,90 e US$ 69,90, teve a última atualização em abril de 2023 e se declara compatível com o WHMCS 8.8. O WHMCS já está na versão 9. O Brasa Sicoob emite o boleto e o Pix na mesma cobrança, pela API Cobrança Bancária v3, e roda no WHMCS 8.8 em diante, inclusive no 9.
O que preciso no Sicoob?
Conta PJ com cobrança e boleto híbrido habilitados pela sua cooperativa, uma chave Pix aleatória e um aplicativo em developers.sicoob.com.br com a API Cobrança Bancária v3 e o certificado A1 da empresa. O certificado e a chave ficam cifrados no banco do seu WHMCS, com o segredo da sua instalação, 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 híbrido. Pagou por um, o outro deixa de valer, então ninguém paga duas vezes.
Como a fatura é baixada?
O Sicoob avisa o seu WHMCS, e o WHMCS relê o boleto no próprio Sicoob antes de marcar a fatura como paga: tem de ser o boleto desta fatura, liquidado, 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 boleto?
Não. O boleto fica guardado com a fatura e a página só mostra o mesmo. Se o valor da fatura mudou, o boleto antigo recebe baixa no Sicoob antes de sair o novo, para o cliente não pagar o valor velho.
E se a fatura for cancelada?
Cancelar a fatura no WHMCS pede a baixa do boleto no Sicoob, se ele ainda está aberto. Boleto já pago fica como está e o log de atividades avisa. 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 emitiu e releu boletos no Sandbox público do Sicoob, passou por um WHMCS de teste com o fluxo inteiro (emitir, mostrar o mesmo, trocar o valor, baixar, cancelar) e o pacote que você baixa foi carregado dentro de um WHMCS 9 de verdade. A produção do Sicoob não foi provada, porque pede o certificado de um cooperado. 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 (Sandbox do Sicoob) nas configurações do gateway: a fatura mostra um boleto com Pix de teste, sem Client ID nem certificado, e ninguém é cobrado. Depois troque para Produção e preencha os seus dados.
E o estorno?
A versão 0.1 não faz reembolso pelo WHMCS: devolva pelo app do Sicoob 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. O CPF ou CNPJ vem do campo de imposto do cliente ou de um campo personalizado com CPF, CNPJ ou documento no nome, e o boleto pede o endereço completo (rua, cidade, estado e CEP).
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?
Cartão, protesto e reembolso pelo Sicoob 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.