Ir para o conteúdo

Módulo cel_cash Boleto para WHMCS

versão downloads abrir issue

Módulo gratuito de integração que automatiza a emissão de boletos registrados no WHMCS através da API cel_cash. Cobranças com o seu CPF ou CNPJ, sem carteira de cobrança e sem burocracia, com confirmação de pagamento e baixa automática das faturas. Desenvolvido pela Gofas Software.

Sumário

Download

Baixar a versão mais recente

Funcionalidades

  • Boletos registrados emitidos com o seu CPF ou CNPJ, sem carteira de cobrança
  • Confirmação automática de pagamento e baixa nas faturas
  • Linha digitável na fatura, com opção de copiar em um clique
  • Informações do boleto nos emails das faturas
  • Redirecionamento para o boleto ao acessar a fatura (opcional)
  • Mensagem personalizada exibida na fatura
  • Valor mínimo da fatura para permitir pagamento via boleto
  • Cálculo da tarifa por transação confirmada, preenchendo o campo "Taxas" (fee) da lista de transações do 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.0
  • PHP >= 7.3
  • Conta cel_cash com o módulo Webservice ativo
  • Credenciais: Galax ID e Galax Hash (produção e testes)

Instalação

  1. Baixe o arquivo pelo link de download e descompacte. Será criada a pasta gofasgalaxpayboleto.
  2. Copie as pastas includes e modules de dentro de gofasgalaxpayboleto para a raiz da instalação do WHMCS, mesclando com as pastas existentes.
  3. Ative o módulo em Opções > Pagamentos > Portais para Pagamentos > aba All Payment Gateways.
  4. Informe o Galax ID e o Galax Hash.

Configuração

Pré configuração na cel_cash

  1. No painel administrativo, em Módulos, ative o módulo Webservice.
  2. Em Módulos > Webservice > Configurar, copie as credenciais Galax ID e Galax Hash de produção.
  3. Repita o processo no painel do modo de testes para obter as credenciais de sandbox. A homologação em sandbox é obrigatória antes de usar o Webservice em produção.

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 configuracoes do modulo

  • Galax ID e Galax Hash: credenciais do Webservice em produção.
  • Galax ID e Galax Hash (testes): credenciais do Webservice em sandbox.
  • Sandbox: gera cobranças em modo de testes.
  • Salvar Logs: grava informações de diagnóstico em Utilitários > Logs > Log de Módulo.
  • Valor mínimo: valor mínimo da fatura para permitir pagamento via boleto.
  • Tarifa do Boleto: valor em % pago por transação, usado para preencher o campo "Taxas" (fee) da transação no WHMCS.
  • Mensagem na fatura: texto exibido na fatura, acima do botão de visualizar o boleto.
  • Redirecionar para o Boleto: redireciona o cliente ao URL do boleto ao acessar a fatura.
  • Administrador do WHMCS: administrador com permissão para usar a API interna do WHMCS.
  • 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 à cel_cash, conforme o plano da sua conta.
  • Sempre faça backup antes de mudar algo no seu sistema.

Suporte

Abrir issue no fórum do módulo.

Licença

O código deste módulo é público para transparência e auditoria. Isso não transfere a titularidade nem concede licença livre de uso: o software é de propriedade da Gofas Software, protegido pela Lei 9.609/98 e pelos tratados de direitos autorais.

Trechos do contrato de licença de uso que se aplicam diretamente a este repositório:

  • Não redistribuir: é proibido o aluguel, o arrendamento, o empréstimo, a cessão e o licenciamento do software a terceiros, total ou parcial, assim como o fornecimento de serviços de hospedagem comercial do software (Cláusula 10ª, §3º).
  • Não modificar: é vedado qualquer procedimento que implique engenharia reversa, descompilação, desmontagem, tradução, adaptação ou modificação do software, bem como qualquer alteração não autorizada de suas funcionalidades (Cláusula 10ª, §2º).
  • Módulo alterado perde o suporte: a Gofas não se responsabiliza por defeitos decorrentes de alteração do software, de operação por pessoas não autorizadas ou da integração com softwares de terceiros (Cláusula 10ª, §7º). O suporte é uma cortesia e não é garantido pela licença (Cláusula 7ª, §1º).

Changelog

Melhorias:

  • readme: link de suporte para o forum do proprio modulo - #11
  • readme: contador do site, captura sem aviso de hook e secao de licenca - #10
  • readme: captura versionada, badges e sumario - #9
  • readme: marca correta e cel_cash (GalaxPay e a marca antiga) - #8
  • readme: conteudo da pagina do site transferido e captura de configuracao - #7

Comparar versões

Melhorias:

  • Telemetria com consentimento (v1.3.0) - #6

Correções:

  • Evita erro getGatewayVariables not defined na área do cliente - #5 bug

Comparar versões

Comparar versões

Melhorias:

  • Obtem diretório raíz do WHMCS consultando no banco de dados as informações da instalação a fim de evitar erros quando o arquivo é invocado em áreas imprevisíveis do sistema onde a busca relativa à localização atual do script não funciona como esperado - #4 enhancement
  • compatibilidade php8+ - #2

Correções:

  • Remove duplicate function - #1 bug

Comparar versões

Deixe um Comentário

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

Role para cima