Módulo de integração que permite receber pagamentos com cartão de crédito no WHMCS através da API cel_cash, com parcelamento configurável e confirmação 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
- Cartão na própria fatura. O cliente paga com cartão de crédito sem sair do seu site
- Parcelamento sob controle. Valor mínimo e número máximo de parcelas definidos por você
- Baixa automática. Pagamento aprovado quita a fatura na hora, sem conferência manual
- Cobrança recorrente. Cartões salvos permitem a captura automática nas próximas faturas
- Testes sem risco. O ambiente sandbox da cel_cash valida todo o fluxo antes de ir para produção
- Pagamento com cartão de crédito direto na fatura do WHMCS
- Parcelamento configurável, com valor mínimo e número máximo de parcelas
- Confirmação automática de pagamento e baixa nas faturas
- Valor mínimo da fatura para permitir pagamento com cartão
- 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/ggpcd/ e descompacte. Será criada a pasta
gofasgalaxpaycartao. - Copie a pasta
modulesde dentro degofasgalaxpaycartaopara 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.
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 novas cobranças no cartão.
- Galax ID e Galax Hash: credenciais do Webservice em produção.
- Sandbox Galax ID e Sandbox Galax Hash: credenciais do Webservice em modo de testes.
- Administrador do WHMCS: administrador com permissão para usar a API interna do WHMCS.
- Sandbox: gera cobranças em modo de testes.
- Salvar Logs: grava informações de diagnóstico em
Utilitários > Logs > Log de Módulo. - Tarifa: valor em % pago por transação, usado para preencher o campo "Taxas" (fee) da transação no WHMCS.
- Valor mínimo: valor mínimo da fatura para permitir pagamento com cartão.
- Permitir parcelamento: exibe as opções de parcelamento na fatura quando aplicável.
- Valor mínimo para parcelamento: valor mínimo da fatura para permitir parcelamento.
- Máximo de parcelas: número máximo de parcelas oferecidas ao cliente.
- 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 cartão é 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 novas cobranças no cartão até a licença ser regularizada.
- Sempre faça backup antes de mudar algo no seu sistema.
O pagamento é confirmado na hora?
Sim. Quando a cel_cash aprova a transação, o módulo registra o pagamento e quita a fatura no mesmo momento.
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 pagamentos já aprovados não são afetados. O módulo apenas deixa de processar novas cobranças no cartão até a licença ser regularizada.
Veja changelog.md.
Abrir issue no fórum do módulo.
Melhorias:
- Atualização importante de segurança - #18
Melhorias:
- Converter para módulo pago (verificação de licença + ionCube + produto WHMCS) - #17
- readme: link de suporte para o forum do proprio modulo - #15
- readme: contador do site, captura sem aviso de hook e secao de licenca - #14
- readme: captura versionada, badges e sumario - #13
- readme: marca correta e cel_cash (GalaxPay e a marca antiga) - #12
- readme: conteudo da pagina do site transferido e captura de configuracao - #11
Melhorias:
- Telemetria com consentimento (v1.2.0) - #10
Correções:
- Corrigido o erro array_merge(): Argument #1 must be of type array, null given in /gofasgalaxpaycartao/includes/config.php:172 - #9
bug
Melhorias:
- compatibilidade php8+ - #5
Correções:
- Corrigido erro "Argument #1 ($pieces) must be of type array" iframe.php:147 - #8
bug

