Requisitos do sistema

• Versão do PHP: 5.6+
• Versão do WHMCS: 6.3.1+

Instação

1. Após fazer dowload do módulo, descompacte o arquivo no servidor e mova a pasta `gofasgerencianetcartao` e o arquivo `gofasgerencianetcartao.php` para a pasta `/modules/gateways/` do seu WHMCS;
2. No painel de controle do WHMCS, acesse Opções > Pagamentos > Portais para Pagamento > aba All Payment Gateways clique no módulo "Gofas Gerencianet - Cartão" para ativar;
3. Se seu WHMCS ainda não possui, crie um campo personalizado de cliente para o CPF e CNPJ, ou um campo personalizado para cada documento separados, um apenas para CPF e outro apenas para CNPJ. Crie também um campo personalizado para a Data de Nascimento do Cliente. Os campos personalizados são detectados automaticamente, pelo nome do campo.

Configuração

Após a ativação, na mesma página, acesse a aba Manage Existing Gateways, e inicie a configuração das opções a seguir:

1. Identificador da conta: Insira o seu "identificador da conta" Gerencianet (onde localizo?);
2. Client_Id - Produção: Insira o Client_Id do modo Produção da "aplicação" criada na nua conta Gerencianet > API;
3. Client_Secret - Produção: Insira o Client_Secret do modo Produção da sua aplicação;
4. Client_Id - Desenvolvimento: Insira o Client_Id do modo Desenvolvimento (modo de testes) da sua aplicação;
5. Client_Secret - Desenvolvimento: Insira o Client_Secret do modo Desenvolvimento da sua aplicação;
6. Sandbox: Marque essa opção para utilizar a API em modo "Desenvolvimento", use essa opção para realizar pagamentos de teste;
7. Debug: Marque essa opção para exibir resultados e erros retornados pela API Gerencianet e API interna do WHMCS. Atenção: NÃO use essa opção em Modo Produção, apenas para testes ou se precisar diagnosticar erros;
8. Valor mínimo: (apenas números) Insira o valor mínimo da fatura para permitir pagamento. Se não preenchido o valor mínimo será R$5,00, o valor mínimo permitido pela Gerencianet;
9. Desconto Recorrente: (Opcional, Cuidado) Com essa opção ativada, descontos aplicados à primeira Fatura de um pagamento recorrente, serão adicionados a todos os próximos pagamentos;
10. Permitir Parcelamento: Com essa opção ativada seu cliente verá opções de parcelamento na fatura quando aplicável;
11. Valor mínimo para parcelamento (apenas números): Insira o valor mínimo da fatura para permitir Pagamento Parcelado. Se não preenchido o valor mínimo será R$100,00;
12. Imagem do botão "Finalizar Pagamento": Se você desejar usar um botão personalizado, insira o URL da imagem que será usada como botão "Finalizar Pagamento" (tamanho recomendado: entre 160x40px e 339x40px).

Em versões do WHMCS menores que 7.2 será exibida a opção Administrador Atribuído: Insira o nome de usuário ou ID do administrador que será atribuído as transações. Necessário para usar a API interna do WHMCS.

• Fóruns de Suporte
• Documentação da API Gerencianet
• Cadastrar-se na Gerencianet

v3.1.1

v3.1.0

22/10/2020

• Nova opção: 5 - Administrador do WHMCS - Define o administrador com permissões para utilizar a API interna do WHMCS. Evita erros ocasionados por alterações introduzidas no WHMCS v8.+.;
• Formata números de telefone internacionais para o padrão requerido pela API Gerencianet. Evita erros introduzidos na versão 8.0.+ do WHMCS;
• Melhor tratamento de erros, mensagens de erro mais coerentes e destaque para os campos que o cliente precisa corrigir diretamente na fatura.
  

v3.0.0

08/10/2020

• • Nova opção: Exibir "salvar cartão" na fatura. Agora você pode escolher mostrar ou não o campo para o cliente assinalar, que autoriza os pagamentos recorrentes;
  • Melhorias para garantir compatibilidade completa com WHMCS 8.0+ e o com o novo Auto Login para WHMCS v3.0+;
  • Eliminação da dependência da SDK para PHP Gerencianet e todas as bibliotecas que compõem o pacote(elimina todos os erros relacionados ao GuzzleHTTP);

v2.1.4

• • • Melhoria na verificação de atualizações;

v2.1.3

• • • Substituição de versão da SDK Gerencianet para corrigir erros relacionados à biblioteca guzzlehttp;

v2.1.2

• • • Adicionado callback para tratar pagamentos recorrentes de versões anteriores do módulo.

v2.1.1

• • • Previne e redeclaração de funções no WHMCS 7.8+

v2.1.0

• • • Atualizada a SDK Gerencianet para versão 2.4.0;
    • Evita redeclarar funções já carregadas pelo módulo no pool do PHP.

v2.0.2

• • • Corrigido bug que estava criando pagamentos únicos quando deveria, ser criados pagamentos recorrentes.

v2.0.1

• • • Atualizada a SDK Gerencianet. Corrige incompatibilidades do Guzzle HTTP com versões do PHP entre 7.0 e 7.2

v2.0.0

• • • Parcelamento! Agora o módulo pagar em até 12x e você recebe de uma só vez, de acordo com as configurações da conta Gerencianet e a configuração "Valor mínimo para parcelamento", nas configurações do módulo;
    • Mais formas de confirmação de pagamento, agora o módulo da baixa em faturas pagas ao serem acessadas, mesmo antes de receber o callback da GN API;
    • Detecta campos CPF, CNPJ e Nascimento automaticamente, dispensando as configurações de ordem ou ID dos campos personalizados. Basta conter as palavras cpf, cnpj e nascimento nos campos (consulte a aba "Instalação em Detalhes");
    • Não exige mais definir "Administrador do WHMCS" nas configurações do módulo, para versões do WHMCS maiores que 7.2.3. Para versões menores o campo estará presente nas configurações e é obrigatório;
    • Novo campo no checkout para o cliente pode optar por pagamento recorrente, ou pagar todo mês manualmente. Antes, pagamentos de serviços recorrentes do WHMCS, sempre criavam assinaturas na API Gerencianet.
    • Aviso de atualização diretamente nas configurações do módulo;
    • Melhorias nas imagens e design, do checkout e das configurações;
    • Configurações enumeradas e mais intuitivas;
    • Atualizada a detecção de cartões Elo com começo 6504 e 6509 (gratidão Daniel);
    • Obtenção dos URLs do sistema por detecção dos links navegados, evitando erros mesmo que a os URLs do sistema estejam definidos incorretamente nas configurações gerais do WHMCS.

v1.2.3

• • • Corrigido o erro "Tipo inválido: null (esperado string).: /name" ao criar assinatura;

v1.2.2

• • • Agora nomes de itens de serviços/produtos da Fatura é limitado à 255 caracteres, caracteres adicionais são removidos para evitar o erro "A string é muito longa, máximo 255 caracteres: /items/0/name";
    • Atualização da SDK Gerencianet da versão 1.0.11 para a versão 2.0.0. A partir de agora o módulo obrigatoriamente requer php versão 5.5 ou maior.

v1.2.1

• • • Added: Desconto recorrente. Agora o módulo cria a assinatura mesmo se a fatura possui desconto. Aplica o mesmo desconto do primeiro pagamento a todos os pagamentos futuros;
    • Improved: Agora é possível adicionar créditos às faturas, mesmo quando a fatura já possui uma transação associada à ela, nesse caso, a transação anterior é cancelada e uma nova transação é criada com o valor atualizado. Importante: Faturas que tiveram crédito aplicado não criam assinaturas na API GN, para evitar que o desconto referente ao crédito seja aplicado aos pagamentos posteriores;
    • Improved: Agora descontos são aplicados à fatura,  mesmo quando a fatura já possui uma transação associada à ela, nesse caso, a transação anterior é cancelada e uma nova transação é criada com o valor atualizado. Evita o erro “valor -xxxx é menor que o mínimo 0.: /items/1/value”. Importante: Faturas que tiveram desconto aplicado não criam assinaturas na API GN, a menos que a opção “Desconto recorrente” esteja ativa, para evitar que o desconto seja aplicado aos pagamentos posteriores;
    • Improved: Agora o módulo aceita data de vencimento do cartão no formato MM/AAAA e MM/AA;
    • Improved: Agora o módulo aproveita o cache do navegador para arquivos estáticos, até que a versão do módulo seja atualizada ou o cache do navegador seja esvaziado;
    • Improved: Agora a função error_reporting() que força o WHMCS exibir todos os erros do php é acionada apenas quando a opção “debug” está ativa. Impede erros em versões do WHMCS maior que 7.1 quando o módulo é ativado juntamente com o módulo nativo de pagamento via cartão de créditos;
    • Improved: Maior espaçamento entre as imagens das bandeiras dos cartões para tornar mais agradável o layout do formulário de pagamento;
    • Improved: Agora o callback exibe a resposta completa do servidor na sessão “notificações” do painel de controle da API GN somente quando a opção debug está ativa;
    • Improved: Agora o módulo evita o erro “Tentativa de obter detalhes da transação, mas informou um charge_id incorreto “, quando a fatura possui transações geradas por outros módulos ou ao alternar do modo “Desenvolvimento” para “Produção” e vice versa;
    • Improved: Agora o módulo adiciona um prefixo aos IDs das transações gravadas no WHMCS que identifica o módulo que criou a transação +  modo (produção ou desenvolvimento) + periodicidade (pagamento uma vez ou recorrente ) + status da transação (new, waiting, paid ou unpaid) + ID da transação registrada na API Gerencianet;
      
    • Improved: Agora o módulo adiciona um prefixo aos “IDs do cadastro” (ID da assinatura / {$subscription_id} ) dos produtos/serviços com assinatura ativa, que identifica o módulo + ID da assinatura registrada na API Gerencianet.
      

v1.0.1

• • • Adição de versão dinâmica nos URLs de arquivos CSS e Javascript para contornar o cache do navegador após atualizações do módulo;
    • Remoção do link para página de contribuição no rodapé;
    • Adição de link para notas da versão.

v1.0

• • Lançamento =)