Ir para o conteúdo

Módulo C6 Bank Boleto para WHMCS

versão downloads fóruns do C6 Bank Boleto

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.

Comprar o módulo

Sumário

Por que usar

  • 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

Funcionalidades

  • 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

Requisitos

  • 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)

Instalação

  1. Baixe o arquivo em https://gofas.net/gc6bd/ e descompacte. Será criada a pasta gofasc6boleto.
  2. Copie as pastas includes e modules de dentro de gofasc6boleto para a raiz da instalação do WHMCS, mesclando com as pastas existentes.
  3. Ative o módulo em Configurações > Portais para Pagamentos, clicando em "Gofas C6 Boleto".
  4. Informe a chave de licença, as credenciais e o caminho do certificado.

Configuração

Pré configuração no C6 Bank

  1. 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.
  2. Gere o certificado mTLS fornecido pelo C6 Bank e converta-o para .pem.
  3. Guarde o .pem fora da pasta pública do site e informe o caminho completo na configuração do módulo.

Pré configuração no WHMCS

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.

Opções do módulo

Tela de configurações do módulo C6 Bank Boleto, versão 2.0.0

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

Informações importantes

  • 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 .pem dentro da pasta pública do site.
  • Sempre faça backup antes de mudar algo no seu sistema.

Perguntas frequentes

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.

Changelog

O histórico de versões fica no final desta página.

Suporte

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

Licença

Contrato de licença de uso

Changelog

v2.0.2: ajustes no exemplo de parâmetros personalizados - 13/10/2026

Correções:

  • Exemplo de custom/params.php gera avisos PHP e endpoint external_id liga display_errors - #22 bug

v2.0.1: Atualização importante de segurança - 12/10/2026

Melhorias:

  • Atualização importante de segurança - #21
  • Remover o hook gofasc6boletoApplyLateFees.php do módulo pago - #20

v2.0.0 - 27/09/2026

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

v1.3.0 - 07/06/2026

v1.2.0 - 03/03/2026

Melhorias:

  • Melhorada exibição do PDF no visualizador - #16 enhancement

Correções:

  • Campos originator_id, billing_scheme e billing_type são preservados ao atualizar boleto - #15 bug
  • base64_pdf_file agora é sempre gravado corretamente em emissão e atualização - #14 bug
  • 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

v1.1.3 - 28/01/2026

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

v1.1.2 - 01/10/2025

Correções:

  • Melhorias no cancelamento, reemissão e visualização - #8 bug

v1.1.1 - 29/08/2025

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

v1.0.1 - 15/07/2025

Correções:

  • Corrigido o bug ao invocar parâmetros de outro módulo - #3 bug

v1.0.0 - 02/07/2025

Melhorias:

  • Lançamento - #1 enhancement good first issue

Deixe um Comentário

Você precisa fazer login para publicar um comentário.

Role para cima