FB

Gateway PIX PagHiper
para o WHMCS

Adquira já este módulo Pix, instale-o no WHMCS do site e comece a receber pagamentos de maneira instantânea, diretamente na sua conta PagHiper. Conheça mais sobre essa solução.
Gateway PIX PagHiper para o WHMCS

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.

Requisitos e compatibilidade

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

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:

Arquivo ZIP

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);

$
Aplicativos e Integrações

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;

$
PagHiper

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;

Ativar Instalação

Acesse o card PagHiper PIX, e, na janela que será aberta, clique no botão Activate/Ativar para finalizar a instalação;

$
Configuração do Módulo

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.

$
Salvar Alteração

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
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.
Melhorias implementadas:
    • 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.
Data da atualização: 18/12/2020
Versão 2.0.3
Bugs resolvidos:
  • PDF de fatura mostrava boleto em branco de maneira intermitente;
  • Pagamentos duplicados em alguns ambientes.
Melhorias implementadas:
  • Cancelamento automático de boletos (na baixa e pagamento parcial de faturas).
Data da atualização: 03/01/2020
Versão 2.0.2
Melhorias implementadas:
  • 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 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
Bugs resolvidos:
  • 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 2.0.1.1
Bugs resolvidos:
  • 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 2.0.1
Bugs resolvidos:
  • Melhorada a lógica de busca de boletos emitidos (para faturas vencidas);
  • Novo método de formação de URL de retorno.
Melhorias implementadas:
  • 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.
Data da atualização: 08/02/2019
Versão 2.0
Novas funcionalidades:
  • 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).
Bugs resolvidos:
  • 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.
Melhorias implementadas:
  • 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.
Data da atualização: 01/02/2019
Versão 1.2.1b
Bugs resolvidos:
  • Coluna de valores estava sendo criada como FLOAT, causando erro nas queries em algumas versões do MySQL. Boletos são reutilizados corretamente agora.
Melhorias implementadas:
  • Possibilidade de usar campos separados para CPF e CNPJ.
Data da atualização: 26/01/2019
Versão 1.2.1
Melhorias implementadas:
  • 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 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
Bugs resolvidos:
  • Corrigido erro na formação da URL para recebimento de retorno.
Data da atualização: 30/09/2017
Versão 1.1.2
Bugs resolvidos:
  • 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.
Melhorias implementadas:
  • Informa a versão do módulo;
  • Tabela criada para armazenar retornos da PagHiper.
Data da atualização: 03/05/2019
Versão 1.1.1
Bugs resolvidos:
  • Problemas relacionados ao checkout transparente;
  • Omissão de CPF/CNPJ.
Data da atualização: 20/04/2017
Versão 1.1.0
Bugs resolvidos:
  • 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.
Melhorias implementadas:
  • 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.
Data da atualização: 13/04/2017
Versão 1.0
  • Lançamento Inicial.
WHMCS

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.