Permite a emissão de boletos e integração do gateway da PagHiper ao seu WHMCS. Este módulo implementa emissão de boletos com retorno automático.
Requisitos | Detalhes |
Ter sistema WHMCS instalado | versão mínima 5.0 |
Ter acesso a pasta raiz de instalação | Pode ser acesso FTP ou via painel (cpanel) |
PHP, cUrl e JSON | versão >= 7.x do php |
Modulo PagHiper | Pode ser baixado em nosso gitHub (clique aqui) |
Como Instalar
Baixe o arquivo do modulo PagHiper, extraia e envie para a pasta raiz da instalação do seu WHMCS.
Dentro da área administrativa do seu WHMCS, vá em "Complementos/Addons" > Aplicativos e Integrações/Apps & Integrations.
Caso seja solicitado sua senha administrativa, digite e clique em: Confirmar senha/Confirm password.
Ao acessar Aplicativos e Integrações, vá na aba Procurar/Search, pesquise o nome: “PagHiper”. Ou se preferir acesse Negevar/Brower e clique na categoria Pagamentos/Payments e procure pelo módulo de nome: “PagHiper”.
Localizado a opção PagHiper, vamos clicar sobre o nome “PagHiper”, e ativar o módulo clicando em: “Ativar”
Assim que ativar, será exibido uma página semelhante a que se encontra na figura abaixo.
a) Esta opção deve ficar marcada, para que a opção do Boleto apareça na guia do pedido.
b) Nome que será exibido para o Cliente, referente a modalidade de pagamento.
c) E-mail cadastrado na PagHiper.
d) Api Key: pode ser obtido, em "Minha conta" >> Credenciais ou clicando aqui
e) Token: pode ser obtido, em "Minha conta" >> Credenciais ou clicando aqui
f) Campo personalizado para o CPF/CNPJ (caso ainda não tenha nenhum campo definido (Clique Aqui).
g) Caso utilize um campo personalizado para coletar a Razão Social do seu cliente. Este campo é opcional.
h) Taxa percentual: caso deseje acrescer o valor sobre o pedido. O valor definido aqui é porcentagem sobre o valor do pedido, por exemplo, se colocar 8.5 ficaria: 8,5% sobre o valor do pedido, em um pedido de R$ 100,00 seria acrescido R$8,50 ficando R$ 108,50
i) Taxa Fixa: caso deseje acrescer o valor sobre o pedido. O valor definido aqui é fixo. Se colocar o valor de 3, será adicionado R$3,00 ao valor do pedido, independente do valor do pedido.
Não recomendamos a utilização dos campos h) e i) que seria a cobrança de taxas de seus clientes.
j) Abrir boleto ao abrir fatura: possibilita abrir o boleto quando a fatura é visualizada.
k) Exibe ou não a frase fixa no PIX (configurada no painel da PagHiper): Não disponível na PagHiper ainda.
l) Tolerância para pagto: número de dias que o cliente poderá pagar o boleto após o vencimento (usado quando se aplica multa e juros).
m) Vencimento padrão para boletos emitidos: quantidade de dias para o vencimento de boletos reemitidos (para faturas já vencidas). Caso decida não permitir, você precisará mudar a data de vencimento manualmente.
n) Percentual de multa por atraso: valor em porcentagem que deseja cobrar de multa, caso esteja habilitado o pagamento após o vencimento.
o) Juros proporcional: ao aplicar 1% de juros máximo ao mês, esse percentual será cobrado proporcionalmente aos dias de atraso. Dividindo 1% por 30 dias = 0,033% por dia de atraso.
p) Qtde. de dias para aplicação de desconto: caso deseje informe a quantidade de dias que o cliente poderá pagar com antecedência para receber o desconto extra.
q) Desconto por pagto. antecipado: caso tenha configurado o campo anterior, neste campo deverá informar a porcentagem de desconto extra.
r) Gerar boletos para todos os pedidos: caso selecione “não”, boletos bancários e linhas digitáveis serão selecionadas somente caso o cliente selecione "Boleto Bancário" (ou o nome que você configurar no primeiro campo de configuração) como método de pagamento padrão.
s) Validar campos de CPF/CNPJ no checkout: caso selecione a opção “Não validar nenhum dos campos” o CPF/CNPJ não serão validados no momento do checkout, sendo assim selecione a opção que deseja validar.
t) Administrador atribuído: neste campo deve informar o nome do usuário administrador que utiliza para acessar o WHMCS.
u) Converter para processamento: selecione a opção de moeda que deseja transformar no processamento da compra.
Após preencher os dados, clique em: “Salvar Alterações”.
Adicione o texto abaixo no arquivo invoicepdf.tpl do seu tema, para anexar boletos e códigos PIX ao PDF das faturas (opcional)
<?php require_once(dirname(__FILE__).'/../../modules/gateways/paghiper/inc/helpers/attach_pdf_slip.php'); ?>
Atenção: Caso já possua modulo instalado nas versões anteriores e configurou o seu invoicepdf, você deve remover o conteúdo antigo da PagHiper, que inseriu no arquivo invoicepdf.tpl e deixar apenas o comando a cima.
Acesse nosso repositório no GitHub, para realizar o download do módulo WHMCS: https://github.com/paghiper/whmcs.
Pronto, agora é só testar e usar.
Vídeo tutorial
Comentários
0 comentário
Artigo fechado para comentários.