Boleto registrado do C6 Bank na fatura do WHMCS, com baixa automática.
Módulo de integração que emite boletos registrados pela API do C6 Bank direto nas faturas do WHMCS, com juros, multa, descontos e confirmação automática do pagamento. Desenvolvido pela Gofas Software.
- Por que usar
- Funcionalidades
- Requisitos
- Instalação
- Configuração
- Informações importantes
- Perguntas frequentes
- Changelog
- Suporte
- Licença
- Boleto na própria fatura. O cliente gera e paga o boleto do C6 Bank sem sair do seu site
- Baixa automática. O C6 Bank avisa o pagamento e a fatura é quitada sozinha, sem conferência de extrato
- Cobrança completa. Juros, multa e até três faixas de desconto por antecipação, direto no boleto registrado
- Boleto sempre atualizado. Se o valor ou o vencimento da fatura mudar, o boleto é atualizado ou reemitido
- Testes sem risco. O ambiente sandbox do C6 Bank valida todo o fluxo antes de ir para produção
- Boleto registrado emitido pela API do C6 Bank, com autenticação mTLS
- Confirmação automática de pagamento por webhook e baixa nas faturas
- Juros e multa por atraso, em percentual ou valor fixo
- Descontos simples ou escalonados, em até três faixas por data
- Atualização do boleto quando o valor ou o vencimento da fatura muda
- Linha digitável, valor e vencimento exibidos na fatura (opcionais)
- Boleto no email da fatura (opcional)
- Redirecionamento para o boleto ao acessar a fatura (opcional)
- Até quatro linhas de instrução no boleto
- Valor mínimo da fatura para permitir pagamento via boleto
- Cálculo da tarifa por boleto pago, preenchendo o campo "Taxas" (fee) da transação no WHMCS
- Dispensa configuração de campos CPF/CNPJ: o módulo detecta automaticamente os campos personalizados de clientes
- Suporte a produção e a testes (sandbox)
- Logs de diagnóstico configuráveis
- Aviso de atualização e verificação de versão na própria tela de configuração do módulo
- WHMCS 8.x ou superior
- PHP 8.2 ou superior, com cURL
- ionCube Loader 15 ou superior
- Cron do WHMCS ativo, para a baixa automática e a revalidação da licença
- Conta PJ no C6 Bank com API habilitada: Client ID, Client Secret e certificado mTLS (produção e testes)
- Baixe o arquivo em https://gofas.net/gc6bd/ e descompacte. Será criada a pasta
gofasc6boleto. - Copie as pastas
includesemodulesde dentro degofasc6boletopara a raiz da instalação do WHMCS, mesclando com as pastas existentes. - Ative o módulo em
Configurações > Portais para Pagamentos, clicando em "Gofas C6 Boleto". - Informe a chave de licença, as credenciais e o caminho do certificado.
- No portal de desenvolvedores do C6 Bank (https://developers.c6bank.com.br/), crie uma aplicação e obtenha o Client ID e o Client Secret de produção e de testes.
- Gere o certificado mTLS fornecido pelo C6 Bank e converta-o para
.pem. - Guarde o
.pemfora da pasta pública do site e informe o caminho completo na configuração do módulo.
Crie um campo personalizado de cliente para CPF e/ou CNPJ, ou dois campos distintos, um para cada documento. O módulo identifica os campos automaticamente.
- Chave de licença: obtida ao adquirir o módulo. Sem licença ativa o módulo não gera novos boletos.
- Client Id, Client Secret e Certificado de Segurança: credenciais e caminho do
.pem, em produção e em testes. - Sandbox: alterna entre o ambiente de testes e produção.
- Salvar Logs: grava informações de diagnóstico em
Utilitários > Logs > Registros do Módulo. - Tarifa e Valor mínimo: tarifa por boleto pago e valor mínimo da fatura para permitir o boleto.
- Boleto no email e Atualizar cobrança: envio do boleto no email da fatura e atualização do boleto quando a fatura muda.
- Dias para vencimento, Juros e Multa: prazo do boleto e encargos por atraso.
- Descontos: desconto simples ou escalonado, em até três faixas.
- Exibição na fatura: linha digitável, valor, vencimento e redirecionamento para o boleto.
- Instruções: até quatro linhas impressas no boleto.
- Enviar estatísticas de uso (opcional): controla o envio identificado das estatísticas de confirmação de pagamento. Desmarcado, as confirmações continuam sendo contabilizadas de forma anônima.
- A tarifa do boleto é paga separadamente ao C6 Bank, conforme o contrato da sua conta.
- O cron do WHMCS precisa estar ativo. É ele que confirma os pagamentos pendentes e revalida a licença.
- Sem licença ativa, os boletos já gerados continuam válidos e as baixas em andamento seguem funcionando. O módulo apenas deixa de gerar novos boletos até a licença ser regularizada.
- Nunca deixe o certificado
.pemdentro da pasta pública do site. - Sempre faça backup antes de mudar algo no seu sistema.
A baixa da fatura é automática?
Sim. O C6 Bank envia a notificação de pagamento ao WHMCS e o módulo quita a fatura correspondente.
E se eu alterar o valor ou o vencimento da fatura?
Com a opção de atualizar a cobrança ligada, o boleto é atualizado no C6 Bank. Caso contrário, o boleto anterior é cancelado e um novo é emitido.
O que acontece se a licença ficar inativa?
Os boletos já gerados continuam válidos e as baixas em andamento seguem funcionando. O módulo apenas deixa de gerar novos boletos até a licença ser regularizada.
O histórico de versões fica no final desta página.
Abra um tópico no fórum do módulo. Para enviar código ou logs, use um link do Gist (gist.github.com) ou do Pastebin (pastebin.com).
Correções:
- Exemplo de custom/params.php gera avisos PHP e endpoint external_id liga display_errors - #22
bug
Melhorias:
- Atualização importante de segurança - #21
- Remover o hook gofasc6boletoApplyLateFees.php do módulo pago - #20
Melhorias:
- Converter para módulo pago (verificação de licença + ionCube + produto WHMCS) - #19
- Implementado suporte completo a descontos no boleto (Simples e Escalonado). - #17
enhancement
Melhorias:
- Melhorada exibição do PDF no visualizador - #16
enhancement
Correções:
- Campos
originator_id,billing_schemeebilling_typesão preservados ao atualizar boleto - #15bug -
base64_pdf_fileagora é sempre gravado corretamente em emissão e atualização - #14bug - Ao falhar a alteração, o boleto antigo é cancelado na API e um novo é gerado - #13
bug - Garantido o funcionamento da opção "Alterar boleto" nas configurações - #12
bug - Garantido cancelamento automático do boleto na API C6 + exclusão local ao cancelar fatura no WHMCS - #11
bug
Melhorias:
- Simplificação da lógica de verificação do boleto gerado para a fatura e remoção de código desnecessário - #10
enhancement
Correções:
- Melhoria na atualização da data de vencimento e/ou valor do boleto - #9
bug
Correções:
- Melhorias no cancelamento, reemissão e visualização - #8
bug
Melhorias:
- Cancela o boleto e gera um novo caso a API atualizar o boleto falhar - #7
enhancement - Adicionado a opção de alterar o boleto já emitido ou cancelar e gerar um novo quando aplicável - #6
enhancement - Adicionado a capacidade de definir multa por atraso ao boleto - #5
enhancement - Adicionado a capacidade de definir juros por atraso ao boleto - #4
enhancement
Correções:
- Corrigido o bug ao invocar parâmetros de outro módulo - #3
bug
Melhorias:
- Lançamento - #1
enhancementgood first issue

