Módulo de integração WHMCS Gerencianet Nova API – Boleto

O WHMCS é um poderoso gerenciador financeiro amplamente utilizado no mercado de hospedagem e venda de softwares, é sem dúvidas o mais popular da sua categoria, utilizado por empresas de renome no mundo da hospedagem de sites.
Gerencianet é um intermediador de pagamentos brasileiro que vem crescendo desde que começou a operar em 2007, com mais de 45 mil clientes em todo o Brasil, oferece soluções de pagamento via Boleto Bancário, Cartão de Crédito e Carnê. Sua API oferece formas de integrar o pagamento via Boleto e Checkout Transparente diretamente no seu site, loja ou aplicativo, sem necessidade de CNPJ e/ou conta bancária jurídica, além de oferecer taxas justas e competitivas.

Para você que está em busca de uma solução segura e eficaz para receber por boletos via WHMCS e se interessou pelas vantagens da Gerencianet, apresentamo-lhes o nosso novo módulo de integração do sistema de pagamentos Gerencianet com o gerenciador financeiro WHMCS, que você pode baixar gratuitamente aqui.

Descrição

No módulo Gofas Gerencianet Boleto o retorno de dados é automático, seu sistema é notificado e a atualização das faturas ocorre automaticamente quando o pagamento é confirmado, sem a necessidade de configurar URL de retorno do seu whmcs na sua conta Gerencianet, nem adicionar arquivos ao diretório /modules/gateways/callback/ da sua instalação WHMCS.

Instalar via FTP

1. Baixe a última versão do módulo aqui;
2. Descompacte o arquivo whmcs-gerencianet-boleto-master.zip e copie o arquivo gofasgerencianetboleto.php e o diretório gofasgerencianetboleto para dentro o diretório de gateways do WHMCS: /whmcs/modules/gateways/;

Instalação via SSH (Linux)

Execute o comando abaixo substituindo o caminho do diretório pelo caminho da sua instalação whmcs:

Configuração do módulo

1. Faça login na sua conta Gerencianet e acesse API > Minhas Aplicações > Nome da Aplicação;
2. Copie e salve em lugar seguro suas credenciais Client ID e Client Secret. Observe que são fornecidos credenciais diferentes para o modo de Produção e Desenvolvimento;
3. No painel de controle WHMCS, navegue até Opções > Pagamentos > Portais para Pagamento > All Payment Gateways e ative o módulo Gofas Gerencianet Boleto;
4. Configurar as opções do módulo;
   1. Client ID: Cole a Client ID obtida no passo 2;
   2. Client Secret: Cole a Client Secret obtida no passo 2;
   3. Desenvolvimento: Marque essa opção se você estiver utilizando o par de chaves “Client_Id” e “Client_Secret” do modo Desenvolvimento da sua aplicação GN;
   4. Debug: Marque essa opção para exibir resultados e erros retornados pela API Gerencianet e API interna do WHMCS. Use isso apenas em modo de testes ou se precisar diagnosticar erros;
   5. Exibir linha digitável e vencimento do Boleto: Marque essa opção para exibir na fatura a linha digitável do boleto (código de barras) e data de vencimento. A linha digitável é útil para pagamentos via internet banking. Exibir a data de vencimento do boleto pode ser útil, sendo que essa data em alguns casos pode ser diferente da data de vencimento da fatura;
   6. Redirecionar para o Boleto: Marque essa opção para redirecionar o cliente diretamente para o URL do boleto ao acessar a fatura;
   7. Enviar email em caso de erro: Adicione o ID do departamento de suporte que será notificado em caso de erro nas transações. Deixe em branco para desativar;
   8. Administrador atribuído: Insira o ID ou nome de usuário do administrador do WHMCS que será atribuído às transações(opcional, o usuário id 1 será atribuído se essa opção não for preenchida);
   9. Ordem do campo CPF: Insira a ordem de exibição do campo personalizado criado para coletar o CPF do cliente;
   10. Ordem do campo CNPJ: Insira a ordem de exibição do campo personalizado criado para coletar o CNPJ do cliente;
   11. Imagem do botão “Visualizar Boleto”: Insira o URL da imagem que será usada no chekout e faturas como botão “Visualizar Boleto” (opcional);
   12. Instruções do boleto: Insira até 4 linhas de instruções diferentes que serão inseridas no Boleto;
5. Salve e você já pode emitir Boletos!

Códigos de erro

Além dos códigos de erro GN API, fornecemos códigos e erros específicos do módulo para facilitar o diagnóstico e solução de falhas.

Erro 01: Erro de comunicação na 1ª conexão com a GN API, no momento de verificar se a fatura atual já gerou algum boleto. Verifique as os suas credenciais (client_id e client_secret) e as configurações do módulo, lembre-se de que as ceredenciais são diferentes para o ambiente de produção e desenvolvimento;

Erro 02: Falha ao gerar a transação, na 2º conexão com a GN API. Significa que o sistema constatou que não há nenhum boleto dentro do prazo de vencimento associado a fatura atual, mas não conseguiu gerar a transação. Verifique se os campos “Descrição” e “Valor total” da fatura estão configurados corretamente;

Erro 03: Erro de comunicação na 2º conexão com a GN API. Significa que o sistema constatou que não há nenhum boleto dentro do prazo de vencimento associado a fatura atual, mas não conseguiu se conectar novamente para gerar a transação. Ative a opção “Debug” do módulo para diagnosticar com maiores detalhes;

Erro 04: Erro de comunicação na 3º conexão com a GN API, no momento em que seria gerado o Boleto. Ative a opção “Debug” do módulo para diagnosticar com maiores detalhes;

Erros interativos

Erros que necessitam da interação do cliente não mostram códigos na tela, como em caso de CPF ou outras informações cadastrais inválidas, nesse caso é exibida uma mensagem personalizada com instruções e o link direto para a edição do cadastro, para que o próprio cliente possa alterar suas informações cadastrais e continuar o pagamento, sem ter de acionar o suporte.

Opcionalmente, você pode configurar o módulo para disparar um email ao departamento de suporte encarregado cada vez que um dos seus clientes ver um erro ao gerar o boleto, essa é uma ótima forma de identificar e corrigir o erro antes do cliente acionar o suporte e assim minimizar o impacto negativo que erros de aplicações podem causar :P A seguir você confere como aparecem os erros na tela para o cliente:

Erro: “Não foi possível gerar o boleto porque o seu CPF está incorreto.”

Erro: “Não foi possível gerar o boleto porque o seu Telefone está incorreto.”

Erro: “Não foi possível gerar o boleto porque o seu Nome e/ou Sobrenome estão incorretos.”

Suporte

Estamos compartilhando com muito amor esse software, que permite a qualquer pessoa e empresas gerar cobranças via boleto bancário, de forma descomplicada, eficaz e segura.

Para manter o módulo sempre atualizado e continuar aplicando melhorias, precisamos da sua colaboração. Se você achou esse módulo útil, ele trouxe vantagens para o seu negócio ou lhe ajudou de alguma forma, ficaremos imensamente gratos em ter o seu feedback, deixe seu comentário!

Você pode conhecer mais do nosso trabalho, receber atualizações e lançamentos em gofas.net e gofas.com.br. Também pode assinar nossos feeds via Facebook e Twitter.

Aguardamos seu comentário, bons negócios!