O que é o Gateway Pix PagHiper para o WHMCS?
O gateway Pix PagHiper é uma solução de pagamento via Pix para o sistema WHMCS.
Ele funciona em parceria com a PagHiper, de modo que, instalado e configurado no WHMCS, os pagamentos feitos no site caem instantaneamente na sua conta PagHiper.
O módulo Pix PagHiper é gratuito e está disponível para download, que pode também ser feito pelo repositório no GitHub.
Recursos do Pix PagHiper
Veja aqui um pouco daquilo que o módulo de gateway PIX PagHiper para o WHMCS pode oferecer:- Integração com o WHMCS
- Integração com contas PagHiper
- Pagamento instantâneo
- Atualizações e suporte inclusos
- Disponível 24 horas por dia
- Fácil usabilidade
- Rapidez nas transações
- Segurança total
- Possibilidade de definir critérios para a concessão de descontos
- Opção para a aplicação de descontos em pagamentos feitos via Pix
- Recurso para a cobrança de taxas percentuais sobre o valor de cada fatura
- Opção pela qual é possível isentar o cliente de taxas conforme o valor a ser pago
- Opção que possibilita a cobrança de taxas fixas sobre o valor de cada fatura
- Possibilidade de fixar valores máximos e mínimos para pagamentos feitos com este gateway
- Recurso de reemissão de faturas cuja forma de pagamento tenha sido o Pix
Requisitos e compatibilidade
Abaixo estão os requisitos mínimos exigidos para a utilização do módulo Pix PagHiper e as versões do PHP e do WHMCS com as quais ele é compatível.
Compatibilidade
- WHMCS 8.X: 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.
- Tema: Lagom 2.5+ e Twenty One 8.2+
Requisitos mínimos e compatibilidade
- cURL e JSON ativados;
- Uma conta na PagHiper.
Como instalar e configurar o Gateway?
Após o download do módulo, os próximos passos são a sua instalação e a sua configuração (nessa ordem). Confira a seguir como realizá-los:
Faça o upload do arquivo .zip para o painel de controle do seu servidor. Extraia-o e mova as pasta include e modules para a pasta WHMCS (a pasta raiz do sistema);
Em seguida, dentro do painel do WHMCS, vá até o menu superior, acesse o ícone de Configurações e clique em Apps & Integrations/Aplicativos e integrações;
Na página Aplicativos e integrações, acesse o campo de pesquisa e digite a expressão “PagHiper pix”. Então aparecerá um card chamado PagHiper PIX;
Acesse o card PagHiper PIX, e, na janela que será aberta, clique no botão Activate/Ativar para finalizar a instalação;
Após a instalação, será carregada a página de configuração do módulo. Nela, devem ser inseridos os dados da conta PagHiper (e-mail, chave API, token) e deve ser configurado o modo de funcionamento do módulo quanto a descontos, cobrança ou isenção de taxas, vencimento e assim por diante.
Ao final dessa configuração, clique no botão Salvar alterações.
Changelogs
Versão 2.5.3
Bugs resolvidos:
- Corrigir bug ao cancelar fatura quando gateway “paghiper” está desativado.
Data da atualização: 05/06/2023
Versão 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 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 2.5.0
Melhorias implementadas:
- 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:
- Configuração para definir valor mínimo e máximo que fatura precisa ter para poder ser paga via Boleto e Pix;
Data da atualização: 07/03/2023
Versão 2.4.2
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.
Melhorias implementadas:
- Mais dados para debug nos Logs de Portais de Pagamento.
Data da atualização: 10/01/2023
Versão 2.4.1
Bugs resolvidos:
- 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 2.4.0
Bugs resolvidos:
- Operadores ternários mostravam erros, dependendo da configuração do PHP;
- Implementar configuração para desconto por regra.
Melhorias implementadas:
- Compatibilidade com PHP 8.1;
- Queries convertidas para uso da classe Capsule (ao invés de MySQL).
Data da atualização: 09/01/2023
Versão 2.3.0
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.
Melhorias implementadas:
- 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.
Data da atualização: 20/06/2022
Versão 2.2.1
Bugs resolvidos:
- 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 2.2
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.
Melhorias implementadas:
- 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).
Data da atualização: 27/05/2021
Versão 2.2
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.
Melhorias implementadas:
- 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).
Data da atualização: 27/05/2021
Versão 2.1.0
- 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.
- 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.
Versão 2.0.3
- PDF de fatura mostrava boleto em branco de maneira intermitente;
- Pagamentos duplicados em alguns ambientes.
- Cancelamento automático de boletos (na baixa e pagamento parcial de faturas).
Versão 2.0.2
- 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.
Versão 2.0.1.3
Bugs resolvidos:
- Conciliação de multa/desconto impedia baixa das faturas como esperado no WHMCS v7.8.
Data da atualização: 14/10/2019
Versão 2.0.1.2
- 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.
Versão 2.0.1.1
- 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).
Versão 2.0.1
- Melhorada a lógica de busca de boletos emitidos (para faturas vencidas);
- Novo método de formação de URL de retorno.
- 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.
Versão 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).
- 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.
- 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.
Versão 1.2.1b
- Coluna de valores estava sendo criada como FLOAT, causando erro nas queries em algumas versões do MySQL. Boletos são reutilizados corretamente agora.
- Possibilidade de usar campos separados para CPF e CNPJ.
Versão 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.
Versão 1.2.0
Bugs resolvidos:
- 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.
Melhorias implementadas:
- 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).
Data da atualização: 20/01/2019
Versão 1.1.2.1
- Corrigido erro na formação da URL para recebimento de retorno.
Versão 1.1.2
- 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;
- Corrigido erro na formação da URL para recebimento de retorno.
- Informa a versão do módulo;
- Tabela criada para armazenar retornos da PagHiper.
Versão 1.1.1
- Problemas relacionados ao checkout transparente;
- Omissão de CPF/CNPJ.
Versão 1.1.0
- 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.
- 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.
Versão 1.0
- Lançamento Inicial.
Soluções de pagamento via Pix
Conheça também os demais módulos Pix. A Link Nacional desenvolve várias soluções de pagamento para o WHMCS e entre elas estão os módulos Pix das mais diferentes instituições financeiras. Aproveite e também para conhecer todos os outros módulos de pagamento Pix do WHMCS.