Módulo de pagamento para WHMCS · cel_payments · Cartão de crédito

Cartão de crédito pela sua conta cel_payments. O WHMCS cobra cada fatura no vencimento, sem cobrar duas vezes.

O cliente salva o cartão uma vez no WHMCS, o número vai direto para a sua conta cel_payments e cada fatura é cobrada no vencimento, à vista, com a baixa e o código da transação.

BR.S2 — O que o plugin faz

Do cartão salvo à fatura paga, sem passar por ninguém.

Cartão salvo no cel_payments

O cliente salva o cartão no WHMCS e o número vai direto para a sua conta cel_payments. O WHMCS guarda só o código.

Cobrado no vencimento

O cron do WHMCS cobra a fatura no cartão salvo, à vista, e baixa com o código da transação.

Nunca cobra duas vezes

Uma cobrança por fatura, dia e valor, procurada antes de cobrar: tentativa repetida ou resposta perdida acham a mesma.

Recusa com motivo

Cartão recusado fica registrado no WHMCS com o motivo, e o WHMCS tenta de novo nos dias que você escolheu.

Cliente reaproveitado

O pagador é achado pelo CPF ou CNPJ, inclusive o cadastrado pelo módulo de boleto e Pix.

Só o Galax ID e o Hash

Nada de servidor nosso no meio: o WHMCS fala direto com o cel_payments com as suas chaves.

Testado contra o Sandbox público do cel_payments e dentro de um WHMCS 9 real: cartão salvo, cobrança capturada, tentativa repetida sem cobrar de novo e cartão recusado. Ainda não rodou com cartão de verdade na produção: antes de divulgar, cobre uma fatura pequena num cartão seu.

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. A tarifa do cartão é a da sua conta cel_payments.

BR.S3 — Como fica na loja

O que fica registrado no WHMCS.

Registro do gateway no WHMCS com o Brasa Cartão cel_payments: cartão salvo com o número mascarado e fatura paga no cartão com o código da transação
O que o módulo registrou no WHMCS. Cartão salvo e fatura paga no Sandbox do cel_payments, num WHMCS 9 real.

Imagem montada com os dados reais do teste no Sandbox do cel_payments (cartão de teste, valor de R$ 19,90). No seu WHMCS, a cobrança aparece no registro do gateway e na fatura paga.

BR.S4 — Como instalar

Quatro passos, e o WHMCS passa a cobrar no cartão.

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. Prepare o cel_payments

No painel do cel_payments, confira que o cartão está liberado, copie o Galax ID e o Galax Hash em Configurações, Webservice e libere o IP do servidor do WHMCS.

3. Ative o gateway

Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa cel_payments (cartão de crédito), escolha o ambiente e cole as chaves.

4. Teste com valor baixo

No Sandbox, salve um cartão de teste e pague uma fatura. Em produção, cobre uma fatura pequena num cartão seu antes de oferecer aos clientes.

Pelo seu banco

Recebe por outro banco? Tem módulo para ele.

A mesma baixa automática, ligada à conta que você já usa. Cada módulo custa R$ 99,90 por ano.

Cartão cel_payments

Cartão de crédito salvo, cobrado no vencimento.

Você está nesta página.

BR.S5 — Perguntas frequentes

O que perguntam antes de comprar.

Já uso o módulo de boleto e Pix cel_payments. Preciso deste?

Só se quiser cobrar no cartão. O de boleto e Pix gera a cobrança para o cliente pagar; este guarda o cartão no cel_payments e o WHMCS cobra a fatura sozinho no vencimento. Os dois usam o mesmo cadastro do cliente no cel_payments e podem ficar ativos juntos.

O número do cartão fica no meu WHMCS?

Não. O WHMCS recebe o cartão no formulário dele e manda direto para o cel_payments. Do cartão, o WHMCS guarda só o código que o cel_payments devolve; número e CVV não ficam no seu banco. O seu WHMCS precisa estar com HTTPS.

Quando a fatura é cobrada?

No vencimento, pelo cron do WHMCS, ou na hora em que o cliente paga a fatura pela área do cliente. A cobrança é à vista e a fatura é baixada com o código da transação (TID).

O cron e o botão de tentar cobrança podem cobrar duas vezes?

Não. Cada fatura tem uma cobrança por dia e por valor, procurada no cel_payments antes de cobrar. Tentou de novo no mesmo dia, ou a resposta se perdeu no meio do caminho, o módulo acha a cobrança que já existe e devolve o mesmo resultado. Se o total da fatura mudou, sai uma cobrança com o valor novo.

E se o cartão for recusado?

A fatura fica em aberto e o WHMCS registra a recusa com o motivo. Ele tenta de novo nos dias que você configurou em Automação; no mesmo dia, uma nova tentativa devolve a mesma recusa, sem bater no cartão outra vez.

O cliente já existe no cel_payments. Duplica?

Não. O cliente é procurado pelo CPF ou CNPJ e reaproveitado, inclusive quando foi cadastrado por outro módulo ou sistema.

O que já foi testado, e o que não foi?

Rodou contra o Sandbox público do cel_payments: cartão salvo, cobrança capturada na hora, nova tentativa no mesmo dia sem cobrar de novo e cartão recusado sem virar pagamento. Rodou também dentro de um WHMCS 9 real, salvando o cartão e pagando a fatura no Sandbox. Ainda não rodou com cartão de verdade na produção: antes de divulgar, cobre uma fatura pequena num cartão seu.

O que fica de fora da versão 0.1?

Parcelamento (a cobrança é sempre à vista) e estorno pelo WHMCS: estorne no painel do cel_payments e registre o reembolso no WHMCS. Remover o cartão no WHMCS não inativa o cartão no cel_payments.

O que preciso para instalar?

WHMCS 8.8 ou mais novo, com PHP 8.1 ou mais novo e a extensão curl, o cron do WHMCS ativo e HTTPS. Uma conta cel_payments com cartão liberado, o Galax ID e o Galax Hash (Configurações, Webservice) e o IP do servidor do WHMCS liberado na mesma tela. Faturas em Real, a partir de R$ 5,00, e CPF ou CNPJ e e-mail no cadastro do cliente.

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.

Aceita cliente com CNPJ alfanumérico?

Sim, desde a versão 0.1.1. O CNPJ com letras que a Receita Federal emite desde julho de 2026 (como 12.ABC.345/01DE-35) passa na conferência do dígito e vai ao cel_payments com as letras. Versões anteriores recusavam esse cliente como documento inválido.

Dá para estornar pelo WHMCS?

Sim, desde a versão 0.1.2. O botão Reembolsar da fatura estorna no cel_payments o valor inteiro ou parte dele, e um estorno total já feito não é pedido de novo. O estorno parcial o cel_payments só aceita a partir do primeiro dia útil depois da captura; antes disso a recusa dele aparece no registro do gateway.

BR.S6 — Suporte

Sua loja tem algo diferente?

Parcelamento e estorno pelo WHMCS ficam de fora da versão 0.1. Se o seu WHMCS precisa de outra coisa, ou se a primeira cobrança não fechar, chame no WhatsApp. Você fala com quem escreveu o módulo.