Módulo de integração que gera cobranças Pix com código QR direto nas faturas do WHMCS através da API cel_payments, 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_payments 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_payments 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_payments.

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_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 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_payments 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_payments, 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.

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

Contrato de licença de uso

Correções:

• Mensagem da fatura exibe
  em vez da quebra de linha - #18 bug

Correções:

• Erro fatal no PHP 8 quando o WHMCS lê a configuração do gateway fora da tela de gateways - #17 bug

Correções:

• Código HTTP do token lido antes da requisição e consulta de transação sem AuthorizationPartner - #16 bug

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