Boleto com Pix
Cada fatura ganha um boleto híbrido na sua conta de cobrança do Sicredi: QR Code Pix e linha digitável na mesma cobrança.
Módulo de pagamento para WHMCS · Sicredi · GPL
Boleto com Pix pela sua conta Sicredi. Fatura do WHMCS baixada sozinha, depois de conferida no Sicredi.
Se a sua empresa cobra pelo Sicredi, cada fatura do WHMCS ganha um boleto 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 Sicredi e baixa.
Baixa conferida
A fatura só vira paga depois de o WHMCS reler o boleto no Sicredi, liquidado e com o valor cheio.
O mesmo boleto
Abrir a fatura de novo, mesmo depois do vencimento, mostra o mesmo boleto. Valor mudou: o antigo recebe baixa antes de sair o novo.
Cancela junto
Fatura cancelada no WHMCS pede a baixa do boleto aberto no Sicredi, para ninguém pagar uma fatura morta.
Multa, juros e prazo
Vencimento, multa, juros ao mês e quantos dias o Pix vale depois do vencimento, nas configurações do gateway.
Credenciais só suas
A chave x-api-key e o código de acesso ficam cifrados no seu WHMCS. Nenhum dado passa por servidor nosso.
Testado no Sandbox de verdade do Sicredi e num WHMCS de teste com o fluxo inteiro, com o pacote carregado num WHMCS 9 de verdade. A produção do Sicredi 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 contrato com a sua cooperativa Sicredi.
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 Sicredi, dentro do tema da sua área do cliente.
BR.S4 — Como instalar
Três passos, e o WHMCS já recebe pelo Sicredi.
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 Sicredi no ambiente Teste com a x-api-key de Sandbox e os dados de teste do Sicredi, 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 a x-api-key de produção, o código do beneficiário, a cooperativa, o posto e o código de acesso, 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 Sicredi que já existe?
Os módulos Sicredi para WHMCS que encontrei à venda fazem só o Pix ou só o boleto. O Brasa Sicredi emite o boleto híbrido do Sicredi, o boleto e o Pix na mesma cobrança, por R$ 99,90 por ano, e roda no WHMCS 8.8 em diante, inclusive no 9.
O que preciso no Sicredi?
Conta PJ com cobrança no Sicredi e o boleto híbrido (com Pix) habilitado pela sua cooperativa. No Portal do Desenvolvedor do Sicredi (developer.sicredi.com.br), uma aplicação com a API de Cobrança, que dá a chave x-api-key. No Internet Banking, o código de acesso da cobrança. Com o código do beneficiário, a cooperativa e o posto, é o que o módulo pede. A chave e o código 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?
O Sicredi avisa o seu WHMCS, e o WHMCS relê o boleto no próprio Sicredi 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. O aviso é cadastrado sozinho no Sicredi, num endereço com um segredo da sua instalação, e se ele 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 mostra o mesmo, também depois do vencimento: o Pix continua valendo pelos dias que você escolher, até 60, com a multa e os juros. Se o valor da fatura mudou, o boleto antigo recebe baixa no Sicredi antes de sair o novo. Boleto rejeitado ou baixado pelo banco gera outro na próxima abertura.
E se a fatura for cancelada?
Cancelar a fatura no WHMCS pede a baixa do boleto no Sicredi, 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 passou pelo Sandbox de verdade do Sicredi: login, emissão do boleto híbrido com Pix, consulta, PDF da segunda via e baixa. Também passou por um WHMCS de teste com o fluxo inteiro (mostrar o mesmo boleto, trocar o valor, vencido, rejeitado, pago a menor, aviso repetido, cancelar), e o pacote que você baixa foi carregado dentro de um WHMCS 9 de verdade. A produção do Sicredi não foi provada, porque pede uma conta de cobrança. 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 Sicredi) nas configurações do gateway, com a x-api-key de Sandbox do portal e os dados de teste que o próprio Sicredi publica: a fatura mostra um boleto com Pix de teste e ninguém é cobrado. Depois troque para Produção com a x-api-key de produção e os dados da sua conta.
E o estorno?
A versão 0.1 não faz reembolso pelo WHMCS: devolva pelo app do Sicredi 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 com CEP vai junto quando está completo, porque algumas cooperativas exigem.
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 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.