Módulo 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.
- 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 o boleto direto na fatura do WHMCS, sem sair do seu site
- Sem carteira de cobrança. Boletos registrados emitidos com o seu CPF ou CNPJ, sem burocracia bancária
- Baixa automática. Quando o boleto é pago, a fatura é quitada sozinha pelo cron, sem conferência de extrato
- Copiar em um clique. A linha digitável fica com botão de copiar na fatura, facilitando o pagamento pelo celular
- Testes sem risco. O ambiente sandbox da cel_cash valida todo o fluxo antes de ir para produção
- 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
- WHMCS >= 8.0
- 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 cel_cash com o módulo Webservice ativo
- Credenciais: Galax ID e Galax Hash (produção e testes)
- Baixe o arquivo em https://gofas.net/ggpbd/ e descompacte. Será criada a pasta
gofasgalaxpayboleto. - Copie as pastas
includesemodulesde dentro degofasgalaxpayboletopara a raiz da instalação do WHMCS, mesclando com as pastas existentes. - Ative o módulo em
Opções > Pagamentos > Portais para Pagamentos > aba All Payment Gateways. - Informe a chave de licença, o Galax ID e o Galax Hash.
- No painel administrativo, em
Módulos, ative o módulo Webservice. - Em
Módulos > Webservice > Configurar, copie as credenciais Galax ID e Galax Hash de produção. - 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.
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.
- 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.
- A tarifa do boleto é paga separadamente à cel_cash, conforme o plano da sua conta.
- O cron do WHMCS precisa estar ativo. É ele que confirma os pagamentos e revalida a licença.
- Sem licença ativa, as cobranças já geradas continuam válidas. O módulo apenas deixa de gerar novos boletos até a licença ser regularizada.
- Sempre faça backup antes de mudar algo no seu sistema.
A baixa da fatura é automática?
Sim. A cada rodada do cron o módulo consulta na cel_cash o status dos boletos em aberto e quita no WHMCS as faturas cujos boletos foram pagos.
Posso testar antes de cobrar de verdade?
Sim. Com o Sandbox ligado e as credenciais de testes, todo o fluxo roda no ambiente de testes da cel_cash, sem gerar cobrança real.
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.
Veja changelog.md.
Abrir issue no fórum do módulo.
Melhorias:
- Atualização importante de segurança - #14
Melhorias:
- Converter para módulo pago (verificação de licença + ionCube + produto WHMCS) - #13
- 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
Melhorias:
- Telemetria com consentimento (v1.3.0) - #6
Correções:
- Evita erro getGatewayVariables not defined na área do cliente - #5
bug
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

