Módulo de integração que gera cobranças Pix com código QR direto nas faturas do WHMCS através da API cel_cash, com confirmação automática do pagamento. Desenvolvido pela Gofas Software.

Comprar o módulo

• Por que usar
• Funcionalidades
• Requisitos
• Instalação
• Configuração
• Informações importantes
• Perguntas frequentes
• Changelog
• Suporte
• Licença

• Pix na própria fatura. O cliente paga pelo QR Code ou pelo copia e cola, sem sair do seu site
• Baixa automática. Quando o Pix é pago, a fatura é quitada sozinha, sem conferência de extrato
• Copiar em um clique. O código copia e cola fica com botão de copiar, ideal para o celular
• Visual sob controle. Mensagem, logo Pix, data e valor exibidos junto ao QR Code conforme a sua escolha
• Testes sem risco. O ambiente sandbox da cel_cash valida todo o fluxo antes de ir para produção

• Código QR na fatura do WHMCS, com copia e cola em um clique
• Confirmação automática de pagamento e baixa nas faturas
• Mensagem personalizada acima do código QR
• Exibição opcional do logo Pix, da data e hora e do valor total no código QR
• Valor mínimo da fatura para permitir pagamento via Pix
• 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 e chave Pix cadastrada
• Credenciais: Galax ID e Galax Hash (produção e testes)

1. Baixe o arquivo em https://gofas.net/ggppd/ e descompacte. Será criada a pasta gofasgalaxpaypix.
2. Copie as pastas includes e modules de dentro de gofasgalaxpaypix para a raiz da instalação do WHMCS, mesclando com as pastas existentes.
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.

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.
4. Cadastre a chave Pix na sua conta cel_cash.

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 QR Codes Pix.
• 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.
• Valor mínimo: valor mínimo da fatura para permitir pagamento via Pix.
• Tarifa Pix: valor em % pago por transação, usado para preencher o campo "Taxas" (fee) da transação no WHMCS.
• Mensagem acima do código QR: texto exibido na fatura, acima do código QR.
• Exibir Logo PIX: exibe o logo do Pix junto ao código QR.
• Exibir data e hora do código QR: exibe a data e a hora de geração do código.
• Exibir valor total do código QR: exibe o valor total da cobrança junto ao código QR.
• 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 Pix é 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 QR Codes Pix até a licença ser regularizada.
• Sempre faça backup antes de mudar algo no seu sistema.

A baixa da fatura é automática?

Sim. O módulo consulta na cel_cash o status do Pix gerado e quita no WHMCS as faturas pagas, pelo cron e também quando o cliente acessa a fatura.

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 QR Codes já gerados continuam válidos e as baixas em andamento seguem funcionando. O módulo apenas deixa de gerar novos QR Codes até a licença ser regularizada.

Veja changelog.md.

Abrir issue no fórum do módulo.

Contrato de licença de uso

Melhorias:

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

Melhorias:

• Converter para módulo pago (verificação de licença + ionCube + produto WHMCS) - #14
• readme: link de suporte para o forum do proprio modulo - #12
• readme: contador do site, captura sem aviso de hook e secao de licenca - #11
• readme: captura versionada, badges e sumario - #10
• readme: marca correta e cel_cash (GalaxPay e a marca antiga) - #9
• readme: conteudo da pagina do site transferido e captura de configuracao - #8

Melhorias:

• Telemetria com consentimento (v1.3.0) - #7

Correções:

• Evita erro getGatewayVariables not defined - #6 bug

Melhorias:

• Diretório raíz do WHMCS agora é obtido via banco de dados a consultando o diretório do template ativo (para casos onde localizações relativas podem falhar) - #5 enhancement

Melhorias:

• compatibilidade php8+ - #4
• Corrigido erro pela busca por arquivos desnecessários - #3