Ir para o conteúdo

Módulo cel_payments Cartão para WHMCS

versão downloads fóruns do cel_payments Cartão

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.

Comprar o módulo

Sumário

Por que usar

  • 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

Funcionalidades

  • 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

Requisitos

  • 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)

Instalação

  1. Baixe o arquivo em https://gofas.net/ggpcd/ e descompacte. Será criada a pasta gofasgalaxpaycartao.
  2. Copie as pastas includes e modules de dentro de gofasgalaxpaycartao para a raiz da instalação do WHMCS, mesclando com as pastas existentes. O arquivo includes/hooks/gofasgalaxpaycartao.php ativa as novas tentativas diárias no cron do WHMCS.
  3. Ative o módulo em Opções > Pagamentos > Portais para Pagamentos > aba All Payment Gateways.
  4. Informe a chave de licença, o Galax ID e o Galax Hash.

Configuração

Pré configuração na cel_payments

  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.

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 configurações do módulo cel_payments Cartão, versão 2.0.0

  • 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.

Informações importantes

  • 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.

Perguntas frequentes

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.

Changelog

O histórico de versões fica no final desta página.

Suporte

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).

Licença

Contrato de licença de uso

Changelog

v2.1.1: remove arquivo de teste com token fixo - 13/10/2026

Correções:

  • Arquivo de teste com token da Galax Pay no pacote do módulo - #21 bug

v2.1.0: novas tentativas diárias no cartão salvo - 13/10/2026

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

v2.0.1: Atualização importante de segurança - 12/10/2026

Melhorias:

  • Atualização importante de segurança - #18

v2.0.0 - 27/09/2026

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

v1.2.0 - 12/07/2026

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

v1.1.2 - 07/06/2026

v1.1.1 - 20/05/2023

Melhorias:

  • compatibilidade php8+ - #5

Correções:

  • Corrigido erro "Argument #1 ($pieces) must be of type array" iframe.php:147 - #8 bug

Deixe um Comentário

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

Role para cima