O WHMCS não traz PIX nem boleto de fábrica. Eles entram por módulos de pagamento (gateways) de empresas brasileiras, que criam a cobrança e dão baixa na fatura sozinhos quando o cliente paga.
Escolha o provedor
Há módulos para WHMCS de vários intermediadores, como Asaas, Efí (antiga Gerencianet), Mercado Pago, PagHiper e Iugu. Antes de escolher, compare:
- Tarifas por PIX, por boleto e por cartão, e o prazo de recebimento.
- Compatibilidade do módulo com a sua versão do WHMCS e do PHP.
- Baixa automática por webhook (retorno), para a fatura ficar paga sem você conferir à mão.
- Se o módulo é mantido: atualizado recentemente e com suporte.
Instalação (passos gerais)
- Crie a conta no provedor e gere as chaves de API de produção e de teste (sandbox).
- Envie os arquivos do módulo para
modules/gateways/da sua instalação, como indicado pelo fornecedor. - WHMCS → System Settings → Payment Gateways → ative o módulo e cole as chaves.
- Copie a URL de retorno (webhook) mostrada pelo módulo e cadastre no painel do provedor.
- Defina o nome de exibição que o cliente vê, como "PIX" e "Boleto bancário".
Teste antes de divulgar
- Use o modo sandbox, ou crie uma fatura de R$ 1,00 para você mesmo.
- Pague e confira se a fatura muda para Paga sozinha em poucos minutos.
- Se não mudar, veja Billing → Gateway Log: ali aparece o retorno do provedor e o motivo da recusa.