Módulo de integração que automatiza a emissão de boletos registrados no WHMCS através da API cel_payments (antiga cel_cash, ex-Galax Pay). 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_payments 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_payments 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_payments, 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_payments 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_payments, 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.
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:
- Mensagem da fatura exibe
em vez da quebra de linha - #17bug
Correções:
- Erro fatal no PHP 8 quando o WHMCS lê a configuração do gateway fora da tela de gateways - #16
bug
Correções:
- Código HTTP do token lido antes da requisição e consulta de transação sem AuthorizationPartner - #15
bug
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

