Módulo GerenciaNet para WHMCS ÍNDICE SOBRE... 2 PRINCIPAIS FUNCIONALIDADES... 2 REQUISITOS... 2 INSTALAÇÃO... 2 CONFIGURAÇÃO INICIAL... 3 CONFIGURAÇÕES DIVERSAS... 4 Campos Customizáveis... 4 Limite... 4 Taxas... 4 Isentar... 5 Controle Transação... 5 Desativar Vencimento... 5 Detalhes Vencimento... 6 Prazo Vencimento Boleto... 6 Ajuste Vencimento... 6 Redirecionar... 7 URL do botão e Alvo... 7 Observações... 7 URL Redirecionamento... 8 Ambiente de testes... 8 Debug... 8 RETORNO AUTOMÁTICO... 9 SUPORTE/DÚVIDAS... 11 PERGUNTAS/RESPOSTAS... 11 1
SOBRE Módulo desenvolvido utilizando a API oficial https://bitly.com/apigerencianet da GerenciaNet que permite emissão/baixa automática de pagamentos via WHMCS. PRINCIPAIS FUNCIONALIDADES - Fácil integração dispensando usuário/senha ou email de acesso; - Cliente não precisa fornecer ( CPF, Data de Nascimento e Celular ); - Limitar a utilização do módulo por valor fixo; - Inclusão de Taxas ( percentual + auxiliar/taxa fixa ); - Possibilidade de isenção de taxas apartir de X reais; - Personalizar botão de pagamento; - Ajuste automático do vencimento da fatura; - Prazo boleto; - Retorno Automático sem cadastro prévio; - Log completo do Retorno Automático; - E etc... REQUISITOS - Qualquer versão/charset do WHMCS; - Conta GerenciaNet. INSTALAÇÃO Após efetuar o pedido/pagamento http://gerencianet.edvan.com.br/ você receberá o e-mail com as instruções de instalação/configuração. Descompacte o arquivo gerencianet.zip e envie as pastas/arquivos para raiz do seu WHMCS. Lembre-se de cadastrar a licença fornecida pela Edvan.com.br no arquivo configuration.php que fica na pasta raiz do seu WHMCS. Em seguida acesse http://seuwhmcs/admin/configgateways.php ou clique em Setup Payments Payment Gateways Em Activate Module localize o módulo GerenciaNet e clique em Activate Módulo instalado! 2
CONFIGURAÇÃO INICIAL 1) Acesse http://gerencianet.com.br/accounts/login insira seu e-mail/senha. Clique no menu Desenvolvedor e localize o botão Gerar novo token Selecione e copie o Token Insira o Token no módulo WHMCS no campo Token: Pronto, agora você poderá receber pagamentos via GerenciaNet. 3
CONFIGURAÇÕES DIVERSAS: - Campos customizáveis: possibilita a configuração dos campos customizáveis para evitar que o cliente informe manualmente os dados obrigatórios (checkout). - Limite: estabelece um limite em Reais para recusar pagamento! Exemplo, foi configurado R$ 50.00 Ao tentar pagar uma fatura com valor maior ou igual a R$ 50.00 o sistema não irá permitir. - Taxas: taxa de porcentagem sobre o total da fatura + Auxiliar ( valor adicional somado a taxa de porcentagem )! Para uma fatura de R$ 100.00 ( 5%= R$5,00 + 1.00 ) = R$ 106,00 4
- Isentar: Isenta o cliente de taxas quando o valor total da fatura for... - Controle Transação: permite configurar o status do retorno automático. O sistema da GerenciaNet retorna diversas informações mas para alimentar as transações capturamos apenas os dados ( Status, Tipo de Pagamento, Hora e ID da transação. Exemplo: São 8 modelos: - Desativar Vencimento: ao marcar essa opção o módulo não irá enviar a data de vencimento da fatura e será assumido o prazo padrão da GerenciaNet (4 dias) 5
- Detalhes Vencimento: ao marcar essa opção o módulo irá informar ao cliente os detalhes do vencimento Exemplo: - Prazo Vencimento Boleto: acrescenta um prazo (em dias) a ser somado com o vencimento da fatura. Exemplo, fatura vence em 28/07/2014 e configuramos mais 1(um) dia de prazo. - Ajuste Vencimento: atualiza o vencimento do boleto caso a fatura esteja vencida. Caso sua fatura esteja vencida (01/07/2014) o vencimento para pagamento via boleto será atualizado automaticamente para o dia corrente. Com um diferencial, se a fatura cair no sábado ou domingo o vencimento é ajustado para segunda-feira. 6
- Redirecionar: possibilita o redirecionamento automático para o checkout (página de pagamentos da GerenciaNet ) ao visualizar a fatura, finalizar um pedido ou ao efetuar um pagamento em massa. - Url do botão e Alvo: customiza o link Pagar agora por um botão de pagamento através de uma URL. O Alvo do Botão/Link indica a forma como o botão/link seja aberto no navegador. - Observações: através desse campo você poderá colocar uma observação para seu cliente, o campo suporta HTML. - URL Redirecionamento: ao concluir um pagamento no checkout da GerenciaNet é possível configurar o link do botão Voltar para Loja. 7
Caso você não informe nenhum link será enviado a URL do seu WHMCS com acesso a fatura paga, exemplo (http://meuwhmcs.com/viewinvoice.php?id=xxx) Também é possível ocultar/desabilitar o botão Voltar para Loja conforme exemplo abaixo: No campo URL redirecionamento escreva DESATIVAR e salve as alterações. - Ambientes de testes: possibilita realizar transações no ambiente de testes da GerenciaNet. - Debug: irá exibir 5 caixas de texto na visualização da fatura. Será possível visualizar as informações do módulo, dados do cliente, XML enviado a GerenciaNet, XML recebido da GerenciaNet e XML tratado. 8
RETORNO AUTOMÁTICO O retorno automático está localizado na pasta /modules/gateways/callback/ arquivo RetornoGerenciaNet.php Não é necessário efetuar configurações para o funcionamento, pois o módulo envia automaticamente a URL para GerenciaNet. Caso queira efetuar uma simulação para saber se o módulo ou WHMCS/servidor está recebendo o retorno acesse o painel da GerenciaNet clique no menu Desenvolvedor e escolha a opção Notificações No campo Cadastre sua url de notificação informe a url do retorno. http://meuwhmcs.com/modules/gateways/callback/retornogerencianet.php meuwhmcs.com=corresponde ao seu domínio. Em seguida clique no link testar No painel da GerenciaNet será informado o resultado do teste conforme exemplo abaixo: Acesse o admin WHMCS e clique no menu Billing >> Gateway Log 9
E confira o teste de conectividade. A GerenciaNet permite que você reenvie o status da transação efetuada, para isso vá em Envio manual de notificações localizado no menu Desenvolvedor >> Notificações Exemplo: No campo número da transação informe o ID da GerenciaNet O ID pode ser encontrado na fatura do seu WHMCS (caso algum retorno já tenha sido recebido). Ou no histórico de transações (página inicial da GerenciaNet) localize o campo Nº da solicitação 10
O Retorno (manual ou automático) só irá ser recebido com sucesso caso a fatura esteja com status Unpaid/Em Aberto. Se porventura a fatura já esteja Cancelada ou Paga o WHMCS irá receber o retorno, mas nenhuma ação será efetuada na fatura. Assim evitando que a fatura paga ou cancelada receba um crédito indevido. No Gateway Log será informado em detalhes: O campo Debug Data irá armazenar todos os detalhes de cada transação. SUPORTE/DÚVIDAS Dúvidas, sugestões ou problemas referente ao módulo GerenciaNet para WHMCS entre em contato através do link http://suporte.edvan.com.br PERGUNTAS/RESPOSTAS P= É possível cadastrar a logomarca da empresa no boleto? R= Não! No painel da GerenciaNet vá no menu Minha Conta >> Tela de Pagamento aonde será possível cadastrar sua logomarca e alterar as cores da tela. P= É possível personalizar as instruções do boleto? R= Não. P= Qual intervalo de recebimento do retorno automático após o cliente efetuar uma transação. R= Em torno de 5 minutos* P= Caso o cliente efetue um pagamento via cartão de crédito qual tempo para análise da transação. R= Entre em contato com a GerenciaNet P= Gostaria de personalizar as mensagens exibidas na fatura, é possível?. R= Sim, consulte as instruções do módulo. 11
P= Quando o cliente vai efetuar um pagamento, aparece a mensagem Falha Processamento GerenciaNet. R= Esse problema ocorre quando alguma configuração em seu módulo não está correta. No exemplo abaixo o TOKEN cadastrado no módulo está inválido, na página 3 confira como gerar um novo token. Outro exemplo, caso você trabalhe com boleto bancário o sistema da GerenciaNet não aceita pagamentos via boleto com faturas vencidas. Para resolver esse problema você tem 2 opções: - Desativar o vencimento - Efetuar o ajuste automático do vencimento. P= No perfil do meu cliente não consta os campos/dados CPF, Data de Nascimento ou Celular. R= Recomendamos que crie os campos customizáveis ou obrigatoriamente seu cliente terá que digitar os dados no checkout (página de conclusão do pagamento da GerenciaNet ). 12