FB
Grátis domínio, hospedagem e e-mail!

Módulo Boleto direto MOIP para o WHMCS com retorno automático (WireCard)

por | 12/03/21 12:12 | Notícias

Nós temos a solução

Tenha uma equipe profissional pronta para te ajudar rapidamente

Pagamento
Principais Recursos:
  • Código de barra direto na fatura.
  • Verifica os dados do usuário.
  • Retorno automático do pagamento.
  • Retorno com as taxa da transação.
  • Atualizações inclusas.
  • Suporte para instalação inclusa.
Última atualização: 28/05/2019 10:51
Próximas atualizações:
  • Editar os dados direto na fatura.
  • Testes com performance de Callback.
  • Enviar código de barra no PDF por email.

Módulos para WHMCS

Parceiro oficial do WHMCS para desenvolvimento de gateways, addons e módulos.

Como instalar o módulo WHMCS MOIP Boleto Direto (Wirecard)

O módulo esta disponível via github open source. E livre para contribuições.

1º Passo | Primeiro passo após a confirmação de pagamento

Download e Descompactar o arquivo

Faça o download do módulo, o arquivo esta compactado em .zip. Após baixar o arquivo descompacte-o. Dentro da pasta “moip_boleto_direto” tem 3 pastas, conforme imagem a seguir.

Suba as pastas “assets”, “modules” e “templates” dentro do diretório raiz que esta instalado o WHMCS. A pasta template contém o arquivo invoice.tpl da fatura do template “Six”.

Passo | Configuração de segurança do WHMCS

Dentro do administrativo do WHMCS em “Opções” >> “Configurações Gerais” entre na aba “Segurança”. Adicione o IP do servidor em: Restrição de Acesso ao API, clique no botão verde + para adicionar.

Nota: se o servidor utiliza IPV6, adicione-o também.

3º Criando as chaves de usuário no WHMCS

Definindo as permissões corretas

Para criar as chaves vc precisa criar uma chave e uma regra. Acesse Opções >> Staff Management >> Manage API Credentials

Na página Manage API Credentials entre na opção API Roles e clique no botão verde +Create API Role. Marque a opção Client e depois as opções: GetContacts, GetClients, GetClientsDetails, UpdateContact e UpdateClient.
Após ter criado a Roles clique em API Credentials e no botão verde + Generate New API Credentials. Preencha o formulário, selecione a Rolecriada e clique no botão Generate, vc terá 2 chaves que serão necessárias para a configuração do Modulo.

4º Passo | Campo obrigatório no WHMCS

Campos personalizados

É necessário ter 5 campos personalizados dentro do WHMCS. Se já tiver os campos personalizados criados verifique as configurações de cada campo e defina-os na configuração do modulo.

CPF (apenas números):

Data de nascimento:
Descrição: DD/MM/AAAA | 23/07/1988
Validação: /^\d{1,2}\/\d{1,2}\/\d{4}$/
CNPJ (apenas números):
Tipo de pessoa: Pessoa Física, Pessoa Jurídica, Estrangeiro
moipID (ao criar esse campo selecione a opção

5º Passo | Ativando o módulo do boleto Wirecard (MOIP)

Ativando o Portal de Pagamento

Acesse a área administrativa do WHMCS, acesse o menu “Opções” >> “Pagamentos” >> Portais para Pagamento. Ao acessar a página do Portais de pagamento conforme imagem acima, procure pela opção “MOIP Boleto Direto”.

6º Passo | Configurando o módulo do boleto Wirecard (MOIP)

As configurações do módulo são extensas, abaixo segue imagem de todas as configurações necessárias para o boleto. Serão necessários criar chaves de acesso ao WHMCS e chaves de API do MOIP.

  • MOIP Produção: Após inserir as chaves do WIRECARD de produção habilite esse campo.
  • Logomarca do boleto: Deve ser uma URL completa da imagem do logo em 75×40
  • Callback (retorno) automático: para confirmações de pagamento selecione a opção “Habilitar Callback Automático”. 
  • Chave do callback: é utilizada apenas quando o callback estiver ativo, é uma camada extra de segurança para tentar barrar a entrada de solicitações indevidas, insira um valor numérico aleatório. 

7º Passo | Salvar configurações do modulo

Com todas informações definida clique em  “Salvar Alterações”.

8º Passo opcional | Confirmações automáticas de pagamentos

Após ter clicado no botão “Salvar Alterações” e com a opção selecionada “Habilitar Callback Automático”, selecione um ID de notificação para receber as confirmações de pagamento. Selecione um ID e clique no botão “Salvar Alterações” novamente.

Como atualizar o módulo WHMCS MOIP Boleto Direto (Wirecard)

Faça o download do modulo pela área do cliente, descompacte o modulo e suba os novos arquivos via FTP, substituindo os arquivos antigos.

Como corrigir os erros?

“Oops! Something went wrong and we couldn’t process your request. Please go back to the previous page and try again. Error: Gateway Module “moipPDBoleto” Not Activated” 

Quando algum erro surgir, acesse o administrativo do WHMCS entre em “Opções” >> “Configurações Gerais. Acesse a aba “Outros” habilite os itens “Display Errors” e “Log Errors”. E informe o erro detalhado nos comentários dessa página que iremos resolver de imediato o problema.

Configuração de log de erros (debug)

Ative as opções de Debug nas configurações do módulo.

Habilitar Debug do Callback Automático
Ative esse recurso para obter log de uma solicitação de confirmação de pagamentos.

Habilitar Debug
Com esse recurso marcado, na fatura do cliente irá mostrar um log para ajudar na resolução de problema do módulo.

Nós temos a solução

Tenha uma equipe profissional pronta para te ajudar rapidamente

Redação: Link Nacional
A Companhia Link Nacional atua na área de tecnologia da informação (TI). E é especializada em oferecer serviços e soluções para internet. Fundada em 2004 na cidade de Ribeirão Preto/SP, hoje ela expandiu as suas áreas de negócios por todo o Brasil.
5 1 voto
Vote no Artigo
Inscrever-se
Notificar de
guest

20 Comentários
Feedbacks embutidos
Ver todos os comentários
rpego
rpego
26 de julho de 2018 22:55

Toda vez que faço o upload do arquivo para a pasta de Modulos/Gateways (moipPDBoleto.php) não consigo acessar a página de módulos de pagamento no WHMCS, ele retorna “Oops!
Something went wrong and we couldn’t process your request.
Please go back to the previous page and try again.

Error: Gateway Module “moipPDBoleto” Not Activated” O que fazer nesse caso?

Davi Souza
Davi Souza
Admin
Responder para  rpego
26 de julho de 2018 23:00

Esta utilizando a versão WHMCS v7 ?

rpego
rpego
Responder para  Davi Souza
8 de setembro de 2018 10:27

Oi,@Davi Souza! Eu coloquei o arquivo .js dentro da pasta assets >> js, o php em Gateways, os que estavam dentro da pasta callback, coloquei na pasta de mesmo nome dentro de gateways e o SDK e o arquivo “params.php” dentro de gateway. Estou fazendo algo errado?

PS.:@SeuTI obrigada pelo seu respaldo, vou buscar saber sobre essa outra plataforma.

Davi Souza
Davi Souza
Admin
Responder para  rpego
21 de setembro de 2018 15:23

Esta certo sim, basta subir de acordo com os pastas que esta no repositório, entre em contato com a gente pelo WhatsApp https://www.linknacional.com.br/suporte que fica mais fácil para lhe auxiliar, acabamos de “commitar” uma nova versão desse modulo, com alguns ajustes.

rpego
rpego
Responder para  Davi Souza
8 de setembro de 2018 10:12

Oi, estou sim. :/

Seu TI
Seu TI
24 de agosto de 2018 20:29

@rpego, eu tive este mesmo problema. Comigo funcionou somente na verão 5.6 do PHP. Como utilizo outros módulos que já não rodam mais nessas versões antigas do php acabei não usando. Mas gostaria muito, há tempos venho querendo testar o MOIP mas sempre esbarrei nessa questão de quero meu próprio já gera o barcode direto na fatura. MAs mante-lo ta ficando inviável por n’s questões, sem contar tbm que com a nova regra d boleto bancário o jeito é mesmo ir pra um intermediador. Po enquanto quebrando cabeça com o PagHiper, bom módulo… mas a empresa tem um atendimento ruim… Leia mais »

Davi Souza
Davi Souza
Admin
Responder para  Seu TI
28 de agosto de 2018 14:16

Sim ele funciona na versão do PHP7, entre em contato com a gente que te auxiliamos na instalação do modulo de gateway do MOIP no seu WHMCS. Ele já esta preparado para as novas regras do boleto da Febrapan. Obs.: realmente precisamos fazer um tutorial explicando como fazer a instalação.

Adriano Silva
Adriano Silva
30 de outubro de 2018 21:54

Tenho o whmcs na versão 6.2.3 esse vai funcionar?

Davi Souza
Davi Souza
Admin
Responder para  Adriano Silva
30 de outubro de 2018 21:58

Olá, talvez funcione, mas não tenho certeza pois foi testado apenas na versão 7 do WHMCS. Temos um modulo antigo que funcionava no 6 porém não teve mais atualizações, se quiser testar faça o download do modulo em: https://www.linknacional.com.br/download/GatewayMoipWHMCS.zip e por favor retorne aqui com o feedback se deu certo. Obrigado.

Adriano Silva
Adriano Silva
Responder para  Davi Souza
30 de outubro de 2018 22:13

Fui tentar ativar na hora que clico em portais de pagamento mostra esse erro: Gateway Module “moipPDBoleto” Not Activated

Davi Souza
Davi Souza
Admin
Responder para  Adriano Silva
31 de outubro de 2018 15:16

Olá Adriano, precisa fazer um ajuste no modulo antigo, colabore com 1 hora técnica (R$59,95) que fazemos os ajustes e instalamos para vc no seu WHMCS. Basta clicar no botão acima e realizar o pedido. Obrigado.

Marcos Silva
Marcos Silva
14 de dezembro de 2018 08:05

meu portais de pagamentos nao abre depois que mandei os arquivos para o ftp e configurei mas agora nao abre mais fica tentando entra mas ai da esse erro “Esta página não está funcionando Nenhum dado foi enviado. ERR_EMPTY_RESPONSE”

Davi Souza
Davi Souza
Admin
Responder para  Marcos Silva
28 de dezembro de 2018 14:57

Olá Marcos, tentamos lhe ajudar de todas as maneiras para tentar resolver sua dificuldade. Te aconselho fazer a atualização para a última versão do modulo boleto direto wmcs moip (wirecard), provavelmente seu problema será solucionado. Se continuar com dificuldades por favor entre em contato.

Davi
Davi
28 de dezembro de 2018 12:02

Olá Davi! Uma sugestão conforme conversamos no whatsapp seria adicionar a opção para que na fatura em PDF, seja enviado o codigo de barras do boleto, assim como já ocorre na tela da fatura!
Com este ajuste o cliente poderia apenas receber o e-mail e imprimir o boleto, nem precisaria acessar o link da fatura!

Imagino que seria um ajuste bem simples e produtivo!

Fica a sugestão!
Obrigado!

Davi Souza
Davi Souza
Admin
Responder para  Davi
28 de dezembro de 2018 15:00

Olá Davi, inserimos sua sugestão para a próxima atualização do modulo whmcs boleto direto para o wirecard (moip). Obrigado pela ideia!

Josimar
Josimar
Responder para  Davi Souza
25 de julho de 2019 07:17

Olá! A Atualização sugerida acima realmente é incrível. Enviar o boleto ou fatura com código de barras automaticamente por e-mail. Alguma previsão para o lançamento dessa funcionalidade?

Josimar
Josimar
28 de maio de 2019 15:01

Excelente módulo!!! Parabéns pelo trabalho

Josimar
Josimar
28 de julho de 2019 10:03

Segue uma sugestão de melhoria: Atualmente é necessário criar 3 campos personalizados, quais são: CPF, CNPJ e Tipo de Pessoa (se física ou jurídica). A Sugestão é: Unificar os campos CPF e CNPJ, o campo ficaria CPF/CNPJ. Base no Tipo de Pessoa escolhido o módulo irar tratar o campo como um ou como outro. Exemplo: Se o Tipo de Pessoa for igual a pessoa física então o campo CPF/CNPJ é um CPF. Se o Tipo de Pessoa for igual a pessoa jurídica então o campo CPF/CNPJ é um CNPJ. Justificativa: Os clientes geralmente não gostam de muitos campos para preencher… Leia mais »

Josimar
Josimar
28 de julho de 2019 10:14

Sugestão de melhoria: No arquivo viewinvoice.php colocar no final da fatura um link para o cliente voltar para área de administração. Esse link já está presente nos outros módulos do WHMCS. Seria interessante colocar no seu também. Do jeito que esta hoje o cliente fica sem saber como voltar para área de administração e acaba clicando na opção de fechar o navegador saindo assim do sistema.

Como fazer um link de confirmação de presença?

Como fazer um link de confirmação de presença?

Como fazer um link de confirmação de presença?O que é um link de confirmação de presença? Um link de confirmação de presença é uma URL enviada para confirmar a participação em um evento ou reunião. Leia maisComo criar um link de confirmação grátis? Para...

Como adicionar calendário em um site?

Como adicionar calendário em um site?

Como adicionar calendário em um site?Utilidades de um site com calendárioUm site com calendário facilita o agendamento de eventos, compartilha datas importantes e mantém visitantes informados e engajados.  Leia MaisComo adicionar calendário em um site? •...

O que é um estacionamento de domínio?

O que é um estacionamento de domínio?

O que é um estacionamento de domínio?O que é um estacionamento de domínio? Estacionar um domínio significa utilizar um domínio adicional e fazê-lo apontar para o conteúdo que está disponível em outro domínio principal. Leia maisRequisitos para estacionar um...

Conheça o Divi Theme

Conheça o Divi Theme

Conheça o Divi ThemeO que é o Divi Theme? O Divi é um tema premium para WordPress, desenvolvido pela Elegant Themes, que oferece um construtor visual intuitivo e vastas opções de personalização.Leia maisPrincipais funcionalidades do Divi Theme – Construtor...

Como adicionar conta de e-mail no Android?

Como adicionar conta de e-mail no Android?

Como adicionar conta de e-mail no Android?O que é uma conta de e-mail POP3? Uma conta de e-mail POP3 baixa mensagens do servidor para o dispositivo local, permitindo acesso offline e, geralmente, apagando-as do servidor após o download.Leia maisPor que configurar...

Como alterar a senha no WordPress?

Como alterar a senha no WordPress?

Como alterar a senha no WordPress?Por que alterar sua senha no WordPress? Alterar a senha no WordPress é crucial para a segurança. Além de evitar invasões, previne ataques de força bruta e controla o acesso ao seu site.Leia maisComo mudar a senha do WordPress?O...

Últimas postagens

Como descobrir o dono de um domínio?

Como descobrir o dono de um domínio?

Descobrindo o dono do domínio Descobrir o dono por trás de um domínio é muito útil quando se está interessado em comprá-lo ou fazer uma parceria com um site....