Módulo de pagamento para WHMCS · C6 Bank · GPL

Boleto com Pix pela sua conta C6 Bank. Fatura do WHMCS baixada sozinha, depois de conferida no C6.

Se a sua empresa cobra pelo C6 Bank, cada fatura do WHMCS ganha um boleto com QR Code Pix na sua própria conta PJ, 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 C6 e baixa.

Boleto com Pix

Cada fatura ganha um Bolepix na sua conta PJ do C6: QR Code Pix e linha digitável na mesma cobrança.

Baixa conferida

A fatura só vira paga depois de o WHMCS reler o boleto no C6, pago e com o valor cheio.

Sem boleto em dobro

Abrir a fatura de novo mostra o mesmo boleto. Resposta perdida no caminho: o WHMCS acha o boleto que já existe.

Cancela junto

Fatura cancelada no WHMCS cancela o boleto aberto no C6, para ninguém pagar uma fatura morta.

Multa, juros e prazo

Vencimento, multa, juros ao mês e quantos dias o boleto vale depois do vencimento, nas configurações do gateway.

Certificado só seu

O certificado e a chave da empresa ficam cifrados no seu WHMCS. Nenhum dado passa por servidor nosso.

Testado num WHMCS de teste com o fluxo inteiro contra o C6 simulado pela especificação oficial da API, com o pacote carregado num WHMCS 9 de verdade. O Sandbox e a produção do C6 ainda não foram provados: 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 o C6 Bank.

BR.S3 — Como fica na loja

A fatura, com o Pix e o boleto.

Fatura do WHMCS com o Brasa C6: valor, vencimento, QR Code Pix, código copia e cola e linha digitável do Bolepix
O que o cliente vê. O QR Code Pix, o copia e cola e a linha digitável dentro da fatura, que baixa sozinha quando o pagamento entra.

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 C6, dentro do tema da sua área do cliente.

BR.S4 — Como instalar

Três passos, e o WHMCS já recebe pelo C6.

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 C6 no ambiente Teste com as credenciais de teste do C6 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 Client Secret, a chave Pix aleatória, 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 um módulo C6 que já existe?

Os módulos C6 para WHMCS que encontrei vendem o boleto e o Pix separados, e o de boleto mais novo custa R$ 19,98 por mês, perto de R$ 240 por ano. O Brasa C6 emite o boleto e o Pix na mesma cobrança, o Bolepix do C6, por R$ 99,90 por ano, e roda no WHMCS 8.8 em diante, inclusive no 9.

O que preciso no C6?

Conta PJ no C6 Bank (conta MEI não tem acesso à API do banco) e o cadastro de integração feito com o C6, que envia o Client ID, o Client Secret e o certificado. Para o QR Code sair no boleto, uma chave Pix aleatória da conta. 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 Bolepix. Pagou por um, o outro deixa de valer, então ninguém paga duas vezes.

Como a fatura é baixada?

O C6 avisa o seu WHMCS, e o WHMCS relê o boleto no próprio C6 antes de marcar a fatura como paga: tem de ser o boleto desta fatura, pago, 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 mostra o mesmo. Se o valor da fatura mudou, o boleto antigo é cancelado no C6 antes de sair o novo. Cada boleto leva uma chave desta fatura, e o WHMCS procura essa chave no C6 antes de emitir: se a resposta do banco se perdeu no caminho, a próxima abertura acha o boleto que já existe em vez de emitir outro.

E se a fatura for cancelada?

Cancelar a fatura no WHMCS cancela o boleto no C6, 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 por um WHMCS de teste com o fluxo inteiro contra um C6 simulado pela especificação oficial da API (emitir, mostrar o mesmo, trocar o valor, resposta perdida, pago a menor, aviso repetido, cancelar), e o pacote que você baixa foi carregado dentro de um WHMCS 9 de verdade. O Sandbox e a produção do C6 não foram provados, porque o C6 só libera o ambiente de teste depois do cadastro de integração de uma empresa. Antes de divulgar, gere uma fatura pequena para você mesmo no ambiente Teste, depois na Produção, 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 C6) nas configurações do gateway e use as credenciais de teste que o C6 envia: 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 estorno?

A versão 0.1 não faz reembolso pelo WHMCS: devolva pelo app do C6 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, 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 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.