Pular para o conteúdo

Base de Conhecimento

Receber por PIX e boleto no WHMCS

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)

  1. Crie a conta no provedor e gere as chaves de API de produção e de teste (sandbox).
  2. Envie os arquivos do módulo para modules/gateways/ da sua instalação, como indicado pelo fornecedor.
  3. WHMCS → System Settings → Payment Gateways → ative o módulo e cole as chaves.
  4. Copie a URL de retorno (webhook) mostrada pelo módulo e cadastre no painel do provedor.
  5. Defina o nome de exibição que o cliente vê, como "PIX" e "Boleto bancário".

Teste antes de divulgar

  1. Use o modo sandbox, ou crie uma fatura de R$ 1,00 para você mesmo.
  2. Pague e confira se a fatura muda para Paga sozinha em poucos minutos.
  3. Se não mudar, veja Billing → Gateway Log: ali aparece o retorno do provedor e o motivo da recusa.
A moeda precisa estar em reais (BRL). Veja Deixar o WHMCS em português e em reais.

Esta resposta foi útil?

« Retornar