Autoriza uma vez
A primeira fatura traz um QR do Sicredi que paga a fatura e, no mesmo Pix, autoriza o débito mensal no banco do cliente.
Módulo de pagamento para WHMCS · Sicredi · Pix Automático
Se o seu WHMCS já recebe pelo Sicredi, a primeira fatura de cada cliente ganha um QR que paga e autoriza o débito mensal. Depois disso, cada fatura sai da conta dele no vencimento, com o valor daquele mês.
BR.S2 — O que o plugin faz
A primeira fatura traz um QR do Sicredi que paga a fatura e, no mesmo Pix, autoriza o débito mensal no banco do cliente.
As faturas seguintes são debitadas no vencimento, sem cartão, sem boleto e sem o cliente lembrar.
O mês em que o domínio renova é debitado com o total da fatura. O piso é o valor da primeira.
A fatura só vira paga depois de o módulo reler o Pix no Sicredi, concluído e com o valor inteiro, uma vez só.
Débito recusado ou vencimento perto demais: a fatura mostra um Pix comum do Sicredi na hora.
Nada a configurar para o Sicredi avisar: o cron do WHMCS confere as cobranças em aberto a cada execução.
Testado num WHMCS de teste com o Sicredi simulado pela documentação oficial, da autorização ao débito do mês e da recusa ao cancelamento no banco. Ainda não rodou contra o Sicredi de verdade, porque a homologação só abre pela cooperativa: antes de divulgar, pague uma fatura pequena.
R$ 297 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 Automático é a da sua conta Sicredi, combinada com a sua cooperativa.
BR.S3 — Como fica na loja
O bloco do pagamento é o HTML que o módulo gera, com um código de exemplo, numa fatura montada para a foto. No seu WHMCS vem o código do Sicredi, dentro do tema da sua área do cliente.
BR.S4 — Como instalar
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.
Peça à sua cooperativa a API Pix com o Pix Automático, gere o certificado e as credenciais no Portal do Desenvolvedor do Sicredi e guarde o certificado e a chave fora da pasta pública.
Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Pix Automático (Sicredi) e preencha Client ID, Client Secret, os caminhos do certificado e da chave, a chave Pix, a agência, a conta, a razão social e o CNPJ.
Pague uma fatura pequena pelo QR, com o app do seu banco, para ver a autorização e a baixa antes de ligar para todos os clientes.
BR.S5 — Perguntas frequentes
Os módulos Sicredi para WHMCS que encontrei fazem boleto ou Pix comum: o cliente paga cada fatura na mão. Este faz o Pix Automático do Banco Central na sua conta Sicredi: o cliente autoriza uma vez e as próximas faturas saem da conta dele no vencimento, sem cartão, boleto ou lembrete.
Funciona. A autorização é mensal e de valor variável: o cliente não fixa um valor no banco, então o mês da renovação do domínio, ou de um serviço novo, é debitado com o total da fatura. O piso é o valor da primeira fatura.
Uma conta Sicredi PJ com a API Pix e o Pix Automático liberados pela sua cooperativa, o certificado e as credenciais (Client ID e Client Secret) gerados no Portal do Desenvolvedor do Sicredi com os escopos de Pix Automático (rec, cobr e cob, leitura e escrita), uma chave Pix e o número da agência e da conta. O dinheiro cai direto na sua conta Sicredi. Nada passa por servidor nosso.
Sem webhook. O Sicredi manda o aviso com certificado dos dois lados, o que hospedagem compartilhada raramente aceita. Por isso, a cada execução do cron do WHMCS e sempre que o cliente abre a fatura, o módulo relê no Sicredi as cobranças em aberto. A fatura só vira paga com um Pix concluído do valor inteiro, uma vez só, pelo identificador do Pix. Pix menor que a fatura não dá baixa.
A recorrência é criada com retentativa permitida, até 3 vezes em 7 dias quando o banco do cliente fizer. O Sicredi tenta de novo entre 18h e 21h do mesmo dia se faltar saldo de manhã. Se o débito for recusado, a fatura passa a mostrar um Pix comum do Sicredi, e as próximas seguem no automático.
O Banco Central exige que o débito seja agendado de 2 a 10 dias antes do vencimento. O cron diário agenda 3 dias úteis antes. Se a fatura já está mais perto do que isso, ou o cliente não tem autorização ativa, ela mostra um Pix comum do Sicredi na hora. Uma segunda fatura no mesmo mês da mesma autorização também vai por Pix comum.
Pode, quando quiser, pelo app do banco dele. O cron diário relê cada autorização ativa e para de agendar débitos para quem cancelou.
Não. O QR fica guardado com a fatura por 23 horas e a página mostra o mesmo. Cada cobrança sai com um identificador nosso, lido no Sicredi antes de criar, então uma resposta perdida no caminho nunca vira segunda cobrança. Se o valor da fatura mudar antes do pagamento, sai um QR novo com o valor novo.
Não. O Sicredi pode bloquear por um tempo quem pede acesso em excesso, então o módulo guarda o acesso no banco do WHMCS, cifrado, e usa o mesmo em todas as faturas e execuções do cron enquanto ele vale.
O módulo rodou num WHMCS de teste com o Sicredi simulado a partir da documentação oficial da API Pix do Sicredi: autorização pela Jornada 3, a mesma recorrência ao reabrir a fatura, baixa só depois da releitura, débito do mês com a agência da cooperativa, recusa com volta para o Pix comum, cancelamento no banco, Pix menor que a fatura e duas conferências ao mesmo tempo, com uma baixa só. A mesma lógica já rodou no Sandbox real do Inter, que segue o mesmo padrão do Banco Central. Ainda não rodou contra o Sicredi de verdade: a homologação do Sicredi só abre pela cooperativa. Antes de divulgar, pague uma fatura pequena com o app do seu banco; se algo não fechar, chame no WhatsApp.
WHMCS 8.8 ou mais novo, com PHP 8.1 ou mais novo e a extensão curl, e o cron do WHMCS ativo, de preferência a cada 5 minutos. 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 ou CNPJ no nome; sem ele, a fatura pede para o cliente preencher.
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.
BR.S6 — Suporte
Cartão, boleto e devolução 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.