Módulo de pagamento para WHMCS · Sicredi · Pix Automático

Pix Automático pela sua conta Sicredi. O cliente autoriza uma vez e as faturas do WHMCS se pagam sozinhas.

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

Da primeira fatura ao débito de todo mês.

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.

As próximas se pagam

As faturas seguintes são debitadas no vencimento, sem cartão, sem boleto e sem o cliente lembrar.

Valor variável

O mês em que o domínio renova é debitado com o total da fatura. O piso é o valor da primeira.

Baixa conferida

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ó.

Recusou, vira Pix comum

Débito recusado ou vencimento perto demais: a fatura mostra um Pix comum do Sicredi na hora.

Sem webhook

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

A primeira fatura, com o QR que autoriza.

Fatura do WHMCS com o Brasa Pix Automático Sicredi: QR Code, código copia e cola e o aviso de que as próximas faturas são debitadas sozinhas
O que o cliente vê na primeira fatura. Um Pix só paga esta fatura e autoriza o débito mensal no app do banco.

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

Quatro passos, e o WHMCS passa a debitar pelo Pix Automático.

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. Libere a API Pix

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.

3. Ative o gateway

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.

4. Teste com valor baixo

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

O que perguntam antes de comprar.

Já recebo pelo Sicredi no WHMCS com outro módulo. Por que este?

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.

O valor da fatura muda no mês em que o domínio renova. Funciona?

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.

O que preciso no Sicredi?

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.

Como a fatura é baixada?

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.

E se o banco recusar o débito?

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.

E se o vencimento estiver perto demais?

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.

O cliente pode cancelar?

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.

Abrir a fatura de novo gera outra autorização?

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.

O módulo pede acesso ao Sicredi a cada fatura?

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 que já foi testado, e o que não foi?

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.

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, 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.

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.

BR.S6 — Suporte

Sua loja tem algo diferente?

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.