PIX no WHMCS: como receber pagamentos automáticos

Tempo de leitura: 4 minutos

Aceitar PIX no WHMCS com baixa automática é uma das melhorias que mais reduzem trabalho numa revenda: o cliente paga pelo QR Code da fatura e, segundos depois, o sistema marca como paga e reativa o serviço, sem ninguém conferir extrato. Neste guia você vai entender como essa integração funciona, o que escolher e como configurar. Se você ainda não tem o sistema, a Licença WHMCS Oficial da Rubfy é cobrada em reais, sem variação do dólar.

O WHMCS aceita PIX nativamente?

Não. O WHMCS é um sistema internacional e não traz PIX de fábrica. A integração é feita por um módulo de gateway fornecido pela instituição que processa o pagamento, como bancos digitais e intermediadores de pagamento brasileiros. Antes de escolher, confira no site de cada provedor se existe módulo para WHMCS e se ele é mantido e compatível com a sua versão do sistema.

Como funciona o PIX no WHMCS

o WHMCS gera a fatura do cliente;
o módulo cria uma cobrança PIX no provedor e mostra o QR Code e o código copia e cola na fatura;
o cliente paga pelo aplicativo do banco;
o provedor avisa o WHMCS por uma chamada automática (callback);
o WHMCS marca a fatura como paga e executa as automações: reativar serviço suspenso, renovar domínio, enviar recibo.

Os detalhes técnicos do PIX, como prazos e segurança, estão na página oficial do Banco Central.

Configurando o módulo

baixe o módulo do provedor escolhido e envie os arquivos para a pasta modules/gateways da instalação do WHMCS;
no painel administrativo, abra System Settings > Payment Gateways e ative o novo gateway;
cole as credenciais de API geradas no painel do provedor;
cadastre no provedor a URL de retorno (callback) indicada pelo módulo, para que os pagamentos sejam avisados;
faça um pagamento de teste de valor baixo e confirme a baixa automática.

Automações que fazem o PIX no WHMCS valer a pena

A baixa automática só mostra o seu valor quando as automações de cobrança estão bem configuradas. Em System Settings > Automation Settings, revise:

quantos dias antes do vencimento a fatura é gerada;
quantos lembretes são enviados e em que dias;
depois de quantos dias de atraso o serviço é suspenso;
a reativação automática ao receber o pagamento.

O artigo com as 10 automações do WHMCS para revendedores mostra a configuração recomendada de cada uma.

Cuidados importantes

validade da cobrança: o QR Code costuma ter prazo de expiração. Confira se o módulo gera um novo quando o cliente abre uma fatura antiga;
taxas: cada provedor cobra por transação. Coloque esse custo na sua conta de preço;
conciliação: uma vez por mês, compare os pagamentos do provedor com as faturas pagas no WHMCS;
PIX sem integração: aceitar PIX por chave comum funciona, mas exige que alguém confira e dê baixa manual em cada pagamento, o que atrasa a reativação do cliente.

Segurança da instalação

O módulo de pagamento conversa com o seu provedor financeiro, então mantenha o WHMCS atualizado, use HTTPS em toda a área do cliente e ative a autenticação em duas etapas para os administradores.

Perguntas frequentes

Posso oferecer PIX e cartão ao mesmo tempo?

Sim. O WHMCS aceita vários gateways ativos, e o cliente escolhe a forma de pagamento na fatura. Defina o PIX como padrão se quiser incentivar o pagamento instantâneo.

O PIX automático tem custo maior que o PIX por chave?

Tem uma taxa por transação cobrada pelo provedor, enquanto receber por chave na conta da empresa costuma ser gratuito. A diferença se paga no tempo economizado com conferência manual e na reativação instantânea do cliente, que reduz reclamação e cancelamento.

O cliente pagou e a fatura não baixou

Quase sempre é a URL de callback que não foi cadastrada no provedor ou está bloqueada por firewall. Consulte o log do gateway em Billing > Gateway Log para ver se o aviso chegou.

Licença WHMCS oficial, em reais, com a Rubfy

A Licença WHMCS Oficial da Rubfy é cobrada em reais e dá acesso ao ecossistema de módulos do WHMCS, incluindo integrações com cPanel, painéis de VPS e gateways de pagamento. Se você está começando, a Revenda de Hospedagem completa a operação com cPanel e WHM no Brasil.