Módulo de integração que permite receber pagamentos com cartão de crédito no WHMCS através da API cel_payments, 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_payments valida todo o fluxo antes de ir para produção
- Novas tentativas diárias no cartão salvo: quando a cobrança automática é recusada, o módulo tenta de novo uma vez por dia, em horário comercial, por até 10 dias depois do vencimento. Recupera pagamentos de cartões com limite momentaneamente esgotado e complementa as tentativas semanais do WHMCS
- 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_payments 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 as pastas
includesemodulesde dentro degofasgalaxpaycartaopara a raiz da instalação do WHMCS, mesclando com as pastas existentes. O arquivoincludes/hooks/gofasgalaxpaycartao.phpativa as novas tentativas diárias no cron do WHMCS. - 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_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 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_payments 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_payments, 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.
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:
- Arquivo de teste com token da Galax Pay no pacote do módulo - #21
bug
Melhorias:
- Versão 2.1.0: novas tentativas diárias no cartão salvo - #20
enhancement
Correções:
- Código HTTP do token lido antes da requisição e consulta de transação sem AuthorizationPartner - #19
bug
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

