Boleto com Pix ou só Pix
Cada fatura ganha uma cobrança na sua conta cel_payments: boleto com QR Code Pix, ou só o Pix, como você escolher.
Módulo de pagamento para WHMCS · cel_payments (Galax Pay) · GPL
Boleto e Pix pelo cel_payments. Fatura do WHMCS baixada sozinha, depois de conferida.
Se a sua empresa cobra pelo cel_payments, o antigo cel_cash e Galax Pay, cada fatura do WHMCS ganha um boleto com Pix, ou só um Pix, na sua própria conta, e o WHMCS baixa a fatura sozinho quando o cliente paga. Sem intermediário e sem taxa por fatura da nossa parte.
BR.S2 — O que o plugin faz
O cliente paga o Pix ou o boleto. O WHMCS confere no cel_payments e baixa.
Baixa conferida
A fatura só vira paga depois de o WHMCS reler a cobrança no cel_payments, paga e com o valor cheio.
Sem cobrança em dobro
Abrir a fatura de novo mostra a mesma cobrança. Resposta perdida no caminho: o WHMCS acha a que já existe.
Cancela junto
Fatura cancelada no WHMCS cancela a cobrança aberta no cel_payments, para ninguém pagar uma fatura morta.
Seu webhook fica como está
O módulo não troca o webhook da sua conta. A conferência de hora em hora dá a baixa mesmo sem ele.
Um módulo, um preço
Boleto e Pix no mesmo módulo, R$ 99,90 por ano por WHMCS, sem taxa por fatura da nossa parte.
Rodou inteiro contra o sandbox público do cel_payments (emitir, abrir de novo, trocar o valor, cancelar, Pix sozinho, cliente que já existia), com a baixa provada num WHMCS de teste e o pacote carregado num WHMCS 9 de verdade. Um pagamento de produção ainda não foi feito: antes de divulgar, gere uma fatura pequena e pague.
R$ 99,90 por ano por instalação do WHMCS, no Pix, boleto ou cartão, com as atualizações e o suporte do ano, sem taxa por fatura. O arquivo é liberado na área do cliente assim que o pagamento é confirmado. As tarifas de boleto e Pix são as do seu contrato com o cel_payments.
BR.S3 — Como fica na loja
A fatura, com o Pix e o boleto.
O bloco do pagamento é o HTML que o módulo gera, com dados de exemplo, numa fatura montada para a foto. O código Pix e a linha digitável são de exemplo; no seu WHMCS vêm os do cel_payments, dentro do tema da sua área do cliente.
BR.S4 — Como instalar
Três passos, e o WHMCS já recebe pelo cel_payments.
1. Envie os arquivos
Na área do cliente, baixe o .zip e descompacte na pasta raiz do WHMCS, a que tem o init.php. Ele só cria arquivos novos.
2. Veja no Sandbox
Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa cel_payments no ambiente Teste com o Galax ID e o Galax Hash do sandbox e abra uma fatura: o boleto com Pix de teste aparece sem cobrar ninguém.
3. Ligue a produção
Troque para Produção com o Galax ID e o Galax Hash da sua conta, libere o IP do WHMCS no Webservice e pague uma fatura pequena para conferir a baixa.
BR.S5 — Perguntas frequentes
O que perguntam antes de comprar.
Por que não usar o módulo cel_payments que já existe?
O que encontrei para WHMCS vende o boleto e o Pix como dois módulos, cada um a R$ 19,98 por mês, perto de R$ 480 por ano pelos dois. O Brasa faz boleto com Pix, ou só Pix, num módulo só, por R$ 99,90 por ano, e roda no WHMCS 8.8 em diante, inclusive no 9.
O que preciso no cel_payments?
A sua conta no cel_payments (antigo cel_cash e Galax Pay, da Celcoin) com o Galax ID e o Galax Hash, que ficam no painel em Configurações, Webservice, e o IP do servidor do WHMCS liberado nessa mesma tela. O WHMCS fala direto com o cel_payments: nada passa por servidor nosso.
Boleto ou Pix?
Você escolhe nas configurações do gateway: boleto com QR Code Pix na mesma cobrança, a partir de R$ 5,00, ou só Pix, a partir de R$ 1,50, que são os mínimos do cel_payments. A fatura mostra o QR Code, o copia e cola, a linha digitável e o link do boleto em PDF.
Como a fatura é baixada?
O WHMCS relê a cobrança no próprio cel_payments antes de marcar a fatura como paga: tem de ser a cobrança desta fatura, paga, com o valor cheio. Boleto pago a menor não baixa sozinho. A conferência roda de hora em hora pelo cron do WHMCS e também quando a fatura é aberta; com o webhook cadastrado, a baixa cai na hora.
Preciso trocar o webhook da minha conta?
Não. O cel_payments aceita um endereço de webhook só por conta, e muita gente já usa esse endereço em outro sistema. Por isso o módulo nunca troca o webhook sozinho: a tela do gateway mostra o endereço para você colar, se quiser a baixa na hora. Sem ele, a conferência de hora em hora dá a baixa.
Abrir a fatura de novo gera outra cobrança?
Não. A cobrança fica guardada com a fatura e a página mostra a mesma. Se o valor da fatura mudou, a antiga é cancelada no cel_payments antes de sair a nova. Cada cobrança leva uma chave desta fatura, e o WHMCS procura essa chave antes de emitir: se a resposta se perdeu no caminho, a próxima abertura acha a cobrança que já existe em vez de emitir outra.
Já uso outro módulo do cel_payments. Os meus clientes vão dar erro?
Não deveriam. O cel_payments recusa um segundo cadastro com o mesmo CPF ou CNPJ, e o módulo resolve isso sozinho: procura o cliente que já existe pelo documento e emite a cobrança nele.
E se a fatura for cancelada?
Cancelar a fatura no WHMCS cancela a cobrança no cel_payments, se ela ainda está aberta. Cobrança já paga fica como está e o log de atividades avisa. O caminho inverso fica de fora de propósito: a conferência nunca cancela fatura no WHMCS, porque isso cancelaria o serviço do seu cliente.
O que já foi testado, e o que não foi?
O módulo inteiro rodou contra o sandbox público do cel_payments: emitir o boleto pela página da fatura, abrir de novo sem duplicar, trocar o valor, cancelar a fatura, Pix sozinho e o cliente que já existia com o mesmo CPF. A baixa (pago, pago a menor, aviso repetido, resposta perdida) foi provada num WHMCS de teste contra um cel_payments simulado, e o pacote que você baixa foi carregado dentro de um WHMCS 9 de verdade. Um pagamento de produção ainda não foi feito: antes de divulgar, gere uma fatura pequena, pague o Pix e confira se ela foi baixada; se algo não fechar, chame no WhatsApp.
Posso testar sem cobrar ninguém?
Pode. Escolha o ambiente Teste (Sandbox do cel_payments) nas configurações do gateway e use o Galax ID e o Galax Hash do sandbox: a fatura mostra um boleto e um Pix de teste e ninguém é cobrado. Depois troque para Produção.
E o estorno?
A versão 0.1 não faz reembolso pelo WHMCS: devolva pelo painel do cel_payments e registre o reembolso na fatura do WHMCS. Baixa manual feita no painel do cel_payments também não baixa a fatura no WHMCS.
O que preciso para instalar?
WHMCS 8.8 ou mais novo, com PHP 8.1 ou mais novo e a extensão curl, e o cron do WHMCS ativo. As faturas têm de estar em Real. O CPF ou CNPJ vem do campo de imposto do cliente ou de um campo personalizado com CPF, CNPJ ou documento no nome, e o cliente precisa de um e-mail válido, que o cel_payments exige.
E se eu não renovar a licença?
O módulo continua funcionando no seu WHMCS como está, porque ele não consulta licença nem desliga recurso. A fatura da renovação sai 20 dias antes do vencimento; sem pagamento, a licença fica suspensa 30 dias depois e a área do cliente deixa de liberar as versões novas e o suporte. Pagou depois, ela volta a ficar ativa sozinha.
BR.S6 — Suporte
Sua loja tem algo diferente?
Cartão, assinatura recorrente do cel_payments, split e reembolso pelo WHMCS ficam de fora da versão 0.1. Se o seu WHMCS precisa de outra coisa, ou se a primeira fatura não fechar, chame no WhatsApp. Você fala com quem escreveu o módulo.