FB
Domínio Grátis

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

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

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.

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.

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 vote
Vote no Artigo
Subscribe
Notify of
guest

20 Comentários
Inline Feedbacks
View all comments
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
Reply to  rpego
26 de julho de 2018 23:00

Esta utilizando a versão WHMCS v7 ?

rpego
rpego
Reply to  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
Reply to  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
Reply to  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… Read more »

Davi Souza
Davi Souza
Admin
Reply to  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
Reply to  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
Reply to  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
Reply to  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
Reply to  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
Reply to  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
Reply to  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… Read more »

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.

Formulários GiveWP: aprenda como personalizá-los

Formulários GiveWP: aprenda como personalizá-los

Sistema de doação: entenda como receber doação online

Doação online: como aumentar as receitas da sua instituição?

UnionPay: rede de cartões para pagamentos e doações

UnionPay: rede de cartões para pagamentos e doações

Como descobrir o dono de um domínio ?

Como descobrir o dono de um domínio

Google Ad Grants: anuncie de graça e potencialize doações

Google Ad Grants: anuncie de graça e potencialize doações

Como abrir uma conta bancária no exterior?

Como abrir uma conta bancária no exterior

Últimas postagens