Módulo disponível para versão WHMCS v7+
Versão do Boleto Direto do MOIP (Wirecard) para o WHMCS v7+ de acordo com as novas regras da FEBRAPAN de junho de 2018. Esse módulo tem retorno automático com as taxas e gera o código de barra do boleto direto na fatura do WHMCS.
Módulo WHMCS MOIP Boleto Direto com retorno automático (Wirecard)
Módulo gratuito e open source.
Continue lendo
O que você vai ler
- Módulo disponível para versão WHMCS v7+
- Módulo WHMCS MOIP Boleto Direto com retorno automático (Wirecard)
- Como instalar o módulo WHMCS MOIP Boleto Direto (Wirecard)
- 1º Passo | Primeiro passo após a confirmação de pagamento
- 2º Passo | Configuração de segurança do WHMCS
- 3º Criando as chaves de usuário no WHMCS
- 4º Passo | Campo obrigatório no WHMCS
- 5º Passo | Ativando o módulo do boleto Wirecard (MOIP)
- 6º Passo | Configurando o módulo do boleto Wirecard (MOIP)
- 7º Passo | Salvar configurações do módulo
- 8º Passo opcional | Confirmações automáticas de pagamentos
- Como atualizar o módulo WHMCS MOIP Boleto Direto (Wirecard)
- Como corrigir os erros?
- 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.
- 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.
2º 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.
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
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):
Validação: /^\d{1,2}\/\d{1,2}\/\d{4}$/
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.
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?
Esta utilizando a versão WHMCS v7+?
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.
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.
Oi, estou sim. :/
@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 »
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.
Tenho o whmcs na versão 6.2.3 esse vai funcionar?
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.
Fui tentar ativar na hora que clico em portais de pagamento mostra esse erro: Gateway Module “moipPDBoleto” Not Activated
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.
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”
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.
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!
Olá Davi, inserimos sua sugestão para a próxima atualização do modulo whmcs boleto direto para o wirecard (moip). Obrigado pela ideia!
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?
Excelente módulo!!! Parabéns pelo trabalho
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 »
Olá Josimar obrigada pela sua sugestão. Mas infelizmente a informação do CPF é importante em alguns caso junto com o CNPJ, no momento não iremos juntar os 2 campos.
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.