Módulo de pagamento Boleto para o WHMCS
Gateway de pagamento gratuito de boleto bancário para o WHMCS, o módulo facilita a emissão de boletos bancários dentro do WHMCS. Emita boletos de forma rápida, prática e segura e ofereça mais essa opção de pagamento aos seus clientes.

O que é o módulo de pagamento Boleto?
O módulo Boleto é uma solução de pagamento para o WHMCS, que funciona com base em uma tecnologia de processamento de dados da PagHiper. Com ele é possível receber pagamentos via Boleto bancário de forma prática e segura.
O Módulo Boleto é gratuito e está disponível para download também no repositório do GitHub
Para que serve?
Serve como uma possibilidade de transformar as faturas (acessadas no WHMCS) em boletos bancários, que podem posteriormente ser enviados aos clientes e pagos via Internet Banking ou em instituições como casas lotéricas, bancos e assim por diante.
Veja o Módulo funcionando
Módulo de pagamento Boleto para o WHMCS
Recursos do Módulo Boleto
- Integração com o sistema WHMCS
- Boleto anexo no e-mail da fatura
- Código de barras para PIX copia e cola
- QR Code para pagamento via PIX
- Opção de salvar o boleto em PDF
- Configuração de taxas
- Configuração de juros
- Configurar o vencimento do boleto
- Configuração de descontos por pagamento antecipado
- Atualizações e suporte inclusos
Requisitos e compatibilidade
Requisitos mínimos
cURL e JSON ativados;
Uma conta na PagHiper.
Compatibilidade
WHMCS 8.X: com todas as versões do WHMCS a partir da versão 8;
PHP 7.x. e PHP 8.1: compatível com a versão 7 do PHP e com as demais versões dessa sequência até a versão 8.1;
Mod_rewrite opcional.
Como Instalar e configurar o módulo
Uma vez adquirido o módulo de cartão de crédito, é necessário baixá-lo para, a partir de então, realizar a instalação. O download se realiza dentro da aba Serviços, na área do cliente.
Após o download, siga os seguintes passos para instalar o módulo e já configurá-lo para a utilização:
Passo 1
Primeiro, faça o upload do arquivo .zip, baixado no seu computador, para o painel de controle do seu servidor. Nele, extraia o arquivo do módulo, e em seguida mova as pasta Include e Modules para a pasta raiz do WHMCS;
Passo 2
Feito isso, vá ao menu superior do WHMCS, acesse o ícone de configurações e clique no item Apps & Integrations/ Aplicativos e integrações;
Passo 3
Na página Apps & Integrations/ Aplicativos e Integrações, acesse o campo de pesquisa e digite a palavra “Boleto“. Logo em seguida, aparecerá um card chamado PagHiper Boleto;
Abra o card do módulo e em seguida clique no botão Activate/Ativar para finalizar a instalação;
Passo 4
Feita a instalação, será carregada a página de configuração do Módulo Boleto. Nela devem ser preenchidos os campos que solicitam as informações a respeito da conta PagHiper (e-mail, chave API, Token); e também é necessário preencher os outros campos, que se referem ao modo de funcionamento do módulo: vencimento, cobrança ou isenção de taxas, juros e assim por diante;
Passo 5
Para finalizar, clique no botão Salvar alterações.
Melhorias nas versões do módulo – Changelog
Versão do gateway: 2.5.3:
- Corrigir bug ao cancelar fatura quando gateway “paghiper” está desativado.
Data da atualização: 05/06/2023
Versão do gateway: 2.5.2:
Bugs resolvidos
- Adicionar verificação para razão social;
- Adicionar verificação de acesso direto em validate_paghiper_taxid.php.
Data da atualização: 29/03/2023
Versão do gateway: 2.5.1:
- Remover código de log;
- Adicionar whmcs.json;
- Aprimorar documentação no README.
Data da atualização: 20/03/2023
Versão do gateway: 2.5:
- Configuração para definir valor mínimo e máximo que fatura precisa ter para poder ser paga via Boleto e Pix;
- Configuração para isentar a fatura de taxas, quando o valor da fatura passar o valor mínimo.
Bugs resolvidos:
- Arquivo attach_pdf_slip.php gerando erros em lugares do WHMCS.
Data da atualização: 07/03/2023
Versão do gateway: 2.4.2:
- Mais dados para debug nos Logs de Portais de Pagamento.
Bugs resolvidos:
- Label de transação (PIX/boleto) aparecendo trocado em algumas telas de erro;
- Erro 0x004681 aparecendo sem motivo em alguns casos;
- Problemas intermitentes com a atualização de status das faturas.
Data da atualização: 10/01/2023
Versão do gateway: 2.4.1:
- Emissão falhava ao configurar o gateway com um user admin inválido (função de fallback falhava);
- Mensagem “Table exists/Table does not exist” aparecendo de maneira intermitente.
Data da atualização: 09/01/2023
Versão do gateway: 2.4:
- Compatibilidade com PHP 8.1;
- Queries convertidas para uso da classe Capsule (ao invés de MySQL).
Bugs resolvidos:
- Operadores ternários mostravam erros, dependendo da configuração do PHP;
- Implementar configuração para desconto por regra.
Data da atualização: 09/01/2023
Versão do gateway: 2.3:
- Validação de dados e campos aplicada no checkout do front-end;
- Mais pontos e informações de log;
- Refatoração e melhor eficiência de código.
Bugs resolvidos:
- Transações sendo pagas de maneira duplicada;
- Transações PIX sendo exibidas a clientes em alguns casos, ao invés de re-emitidas;
- Melhor validação de TaxID (CPF/CNPJ);
- Transações pagáveis sendo ignoradas, caso multa por atraso seja aplicada pelo WHMCS;
- Warnings e Deprecated errors;
- Dados de clientes sem cadastro não estavam disponíveis para emissão, em algumas circunstâncias;
- Suporte a campo de razão social separado;
- Número de telefone não estava sendo anexado à transação.
Data da atualização: 20/06/2022
Versão do gateway: 2.2.1
- Código PIX com quebra de linha indesejada no PDF anexo;
- Crash ao marcar pedido como pago ou cancelado via painel;
- Conciliação (adição de taxa ou desconto a fatura) impedindo a baixa.
Data da atualização: 17/06/2021
Versão do gateway: 2.2:
- Checagem e validação de CPF/CNPJ no checkout, na página de invoice e na tela de boleto/PIX;
- Exibição das tags de boleto/PIX no editor de templates de e-mail;
- Suporte a campo de razão social (opcional);
- Melhor lógica de reaproveitamento de boletos;
- Mais informações nos logs;
- Melhor manipulação de CPF/CNPJ para criação de faturas;
- Tela de erro, caso o valor com desconto por pagamento antecipado seja menor que R$ 3;
- Tela de erro genérica (evita tela branca, caso uma transação não possa ser gerada).
Bugs resolvidos:
- Boletos vencidos eram ignorados, ainda que dentro do período de tolerância;
- Erro ao cancelar boletos nos logs;
- Bloco de inserção de boleto/PIX PDF era executado apenas na primeira fatura da CRON (mod_lsapi);
- Melhor cálculo de desconto para pagamento antecipado;
- Maior distinção entre as mensagens (evita confusão no front-end);
- Melhor convenção de naming de funções (evita conflitos com outros módulos/gateways);
- Warning de operador ternário removido.
Data da atualização: 27/05/2021
Versão do gateway: 2.1:
- Suporte nativo ao PIX PagHiper;
- Processo de instalação simplificado;
- Novas telas de status e ícones;
- Pedidos com boleto agora levam o código de barras junto com a linha digitável;
- Melhorias de segurança;
- Refatoração completa do plug-in.
Bugs resolvidos:
- Em alguns casos, o campo de nome era utilizado na emissão do boleto, mesmo com CNPJ do cliente informado;
- Só exibíamos boleto e PIX para usuários com moeda em real.
Data da atualização: 18/12/2020
Versão do gateway: 2.0.6:
- Cancelamento automático de boletos (na baixa e pagamento parcial de faturas).
Bugs resolvidos:
- PDF de fatura mostrava boleto em branco de maneira intermitente;
- Pagamentos duplicados em alguns ambientes.
Data da atualização: 03/01/2020
Versão do gateway: 2.0.5:
- BUGFIX: Faturas parcialmente pagas agora são interpretadas corretamente;
- Segurança: Maior proteção contra XSS e SQL injection;
- Melhor precisão na determinação de nova data de vencimento, ao reemitir uma fatura vencida;
- Novo texto descritivo para a multa proporcional no back-end;
- Refatoração geral, redução do número de queries e mais.
Data da atualização: 14/11/2019
Versão do gateway: 2.0.4:
- Conciliação de multa/desconto impedia baixa das faturas como esperado no WHMCS v7.8.
Data da atualização: 14/10/2019
Versão do gateway: 2.0.3:
- Boleto não era resgatado caso taxa personalizada estivesse sendo aplicada;
- Multa fatorada e descrição fixa não funcionavam em circunstâncias específicas.
Data da atualização: 20/05/2019
Versão do gateway: 2.0.2:
- Boletos sendo emitidos para todas as faturas, independente do método de pagamento;
- Possível erro 500 causado pelo invoicepdf.tpl (Adicionada tag de fechamento do php).
Data da atualização: 09/02/2019
Versão do gateway: 2.0.1:
- Agora é possível configurar a nova data de vencimento para reemissão de boletos vencidos;
- Possibilidade de restrição na emissão de novos boletos ou emitir para todas as faturas por padrão;
- Novas telas de status;
- Novo hook para criação do boleto junto com a criação da fatura;
- Boleto anexo no e-mail da fatura;
- Seleção automática de usuário para uso na API Local do WHMCS (necessário para algumas operações internas);
- Novos pontos de log;
- Seleção automática de usuário admin para uso na localAPI.
Bugs e correções:
- Melhorada a lógica de busca de boletos emitidos (para faturas vencidas);
- Novo método de formação de URL de retorno.
Data da atualização: 08/02/2019
Versão do gateway: 2.0:
- Uso da nova API 2.0;
- Re-utilização de boletos;
- Juros/multas automáticos na emissão;
- Desconto por pagamento antecipado tbladmin;
- Conciliação (acréscimo ou decréscimo de valores) na compensação dos boletos;
- Acesso direto ao boleto bancário (por link no e-mail, sem a necessidade de log-in).
Melhorias:
- Adicionados endpoints para emissão do boleto bancário na emissão da fatura;
- Possibilidade de integração do boleto nos e-mails de notificação (boleto PDF na fatura e linha digitável no corpo do e-mail);
- Adicionado novo status “Reservado”, para pré-confirmação de pagamento;
- Atualização do ícone usado no checkout;
- Uso de classes bootstrap para melhor visual no checkout.
Bugs e correções:
- Log de notificação inválida estava armazenando array vazio, impossibilitando debug;
- Uso do total da fatura (ao invés do sub-total) – Isso corrige problemas relacionadas a aplicação de taxas, créditos e descontos;
- Compatibilidade com WHMCS 7.5;
- Erro ao emitir/visualizar boletos através de uma sub-conta.
Data da atualização: 01/02/2019
Versão do gateway: 1.2.2:
- Possibilidade de usar campos separados para CPF e CNPJ.
Bugs e correções:
- Coluna de valores estava sendo criada como FLOAT, causando erro nas queries em algumas versões do MySQL. Boletos são reutilizados corretamente agora.
Data da atualização: 26/01/2019
Versão do gateway: 1.2.1:
- Atualização de ícone de boleto bancário;
- Uso de classes bootstrap para melhor visual no checkout;
- Maior clareza nas instruções e remoção de passos desnecessários;
- Remoção da “integração avançada”;
- Preparação para implementação de linha digitável e boleto anexo no e-mail da fatura.
Data da atualização: 23/01/2019
Versão do gateway: 1.2:
- Compatibilidade com WHMCS 7.5;
- Implementação da nova API;
- Armazenamento de boletos em tabela, para consulta e reutilização;
- Juros, multas e desconto por pagamento antecipado;
- Conciliação na baixa (para evitar multas como crédito).
Bugs e correções:
- Uso do total da fatura para cálculo (ao invés do subtotal), para aplicação de descontos e créditos;
- Problema nas queries de atualização da tabela mod_paghiper;
- Erro ao emitir/visualizar boletos através de uma sub-conta.
Data da atualização: 20/01/2019
Versão do gateway: 1.1.3:
- Corrigido erro na formação da URL para recebimento de retorno.
Data da atualização: 30/09/2017
Versão do gateway: 1.1.2
Melhorias e novidades:
- Informa a versão do módulo;
- Tabela criada para armazenar retornos da PagHiper.
Bugs e correções:
- Cálculo de taxas no checkout transparente não era efetuado;
- URL do sistema não era retornada caso o WHMCS estivesse instalado em subdiretório;
- Caracteres nos nomes de campos personalizados vinham sem HTML entities.
Data da atualização: 03/05/2017
Versão do gateway: 1.1.1:
- Problemas relacionados ao checkout transparente
- Omissão de CPF/CNPJ
Data da atualização: 20/04/2017
Versão do gateway: 1.1
- Otimização geral e limpeza de código;
- Suporte a Checkout transparente;
- Integração avançada (campos recebidos podem ser salvos em uma tabela);
- Opção para abrir boleto por link direto;
- Envia o nome do cliente em caso de CPF, razão social em caso de CNPJ
Bugs e correções:
- Loga eventuais problemas com o checkout transparente para debug;
- Trata o campo de CPF/CNPJ para se adequar ao formato exigido pela PagHiper;
- Usa o nome de usuário admin por padrão, caso não seja informado.
Data da atualização: 13/04/2017
Versão do gateway: 1.0
- Lançamento inicial
Soluções de pagamentos para o WHMCS
A Link Nacional é parceira oficial do WHMCS e possui longa experiência no desenvolvimento, manutenção e atualização de tecnologias de pagamento. Tal como o Módulo Boleto, temos um catálogo com vários outros sistemas de pagamento para o WHMCS disponíveis. Nosso objetivo é oferecer as melhores soluções a quem busca por bons sistemas de pagamento para os seus sites. Portanto, se esse é o seu caso, aproveite e conheça também os demais módulos de pagamento para o WHMCS que oferecemos.