Módulo Gerencianet Cartão para WHMCS
Converta mais vendas com
pagamentos recorrentes e
parcelamento em até 12x,
via checkout 100% transparente.
Pague apenas o quanto usar e ainda obtenha tarifas especiais.
CHECKOUT RÁPIDO E INTERATIVO
SEM BUROCRACIA
Pessoas Físicas e Jurídicas só precisam criar uma conta e começar a receber com cartão no seu WHMCS ainda hoje, sem análise, homologação e etc.
ALTAMENTE SEGURO
O módulo não armazena dados de cartões dos clientes no seu WHMCS, os dados são enviados diretamente do navegador do cliente para os servidores Gerencianet, sem sequer passar pelo seu sistema.
100% TRANSPARENTE
O cliente realiza todo o processo de pagamento sem sair do seu site. O checkout é totalmente personalizado com a sua marca, diretamente nas faturas do seu WHMCS.
RETORNO AUTOMÁTICO
O módulo possui sistema de callback que processa notificações de pagamento automaticamente, você só precisa ativar e configurar o módulo e ele faz todo esse serviço por você.
PAGAMENTO PARCELADO
Permite ao cliente pagar parcelado em até 12x e você recebe o valor integral de uma só vez, de acordo com as configurações da conta.
PAGAMENTOS RECORRENTES
Permite automatizar os pagamentos no cartão do cliente utilizando o sistema de assinaturas da Gerencianet.
AJAX
O pagamento é executado em segundo plano e todo o processo de pagamento é realizado sem recarregar a página.
RECUPERAÇÃO DO CARRINHO
Se a operadora do cartão recusar o pagamento após ele ter ido para análise, o módulo avisa o seu cliente por email de forma que o leve a voltar à fatura e tentar novamente.
VEJA FUNCIONANDO:
INSTALAÇÃO SIMPLIFICADA
Suba o módulo para a pasta gateways do seu WHMCS
Após ativar, configure com as suas credenciais e preferências
Comece a receber pagamentos com cartão nas suas Faturas
DOWNLOAD
INSTALAÇÃO E CONFIGURAÇÃO
Requisitos do sistema
- Versão do PHP: 5.6+
- Versão do WHMCS: 6.3.1+
Instação
- 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;
- 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;
- 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:
- Identificador da conta: Insira o seu "identificador da conta" Gerencianet (onde localizo?);
- Client_Id - Produção: Insira o Client_Id do modo Produção da "aplicação" criada na nua conta Gerencianet > API;
- Client_Secret - Produção: Insira o Client_Secret do modo Produção da sua aplicação;
- Client_Id - Desenvolvimento: Insira o Client_Id do modo Desenvolvimento (modo de testes) da sua aplicação;
- Client_Secret - Desenvolvimento: Insira o Client_Secret do modo Desenvolvimento da sua aplicação;
- Sandbox: Marque essa opção para utilizar a API em modo "Desenvolvimento", use essa opção para realizar pagamentos de teste;
- 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;
- 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;
- 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;
- Permitir Parcelamento: Com essa opção ativada seu cliente verá opções de parcelamento na fatura quando aplicável;
- 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;
- 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.
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);
- Melhoria na verificação de atualizações;
- Substituição de versão da SDK Gerencianet para corrigir erros relacionados à biblioteca guzzlehttp;
- Adicionado callback para tratar pagamentos recorrentes de versões anteriores do módulo.
- Previne e redeclaração de funções no WHMCS 7.8+
- Atualizada a SDK Gerencianet para versão 2.4.0;
- Evita redeclarar funções já carregadas pelo módulo no pool do PHP.
- Corrigido bug que estava criando pagamentos únicos quando deveria, ser criados pagamentos recorrentes.
- Atualizada a SDK Gerencianet. Corrige incompatibilidades do Guzzle HTTP com versões do PHP entre 7.0 e 7.2
- 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.
- Corrigido o erro "Tipo inválido: null (esperado string).: /name" ao criar assinatura;
- 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.
- 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.
- 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.
- Lançamento =)
v2.1.4
v2.1.3
v2.1.2
v2.1.1
v2.1.0
v2.0.2
v2.0.1
v2.0.0
v1.2.3
v1.2.2
v1.2.1
v1.0.1
v1.0
Paque proporcionalmente ao quanto usar
O Módulo Gofas Gerencianet Cartão para WHMCS a partir da versão 3.0.0, calcula e repassa automaticamente para a conta Gerencianet da Gofas Software, o valor referente à comissão paga pelo uso do módulo. É utilizado o recurso Marketplace da API Gerencianet para automatizar o repasse. A comissão no valor de 0,5% do total da compra é repassada entre contas Gerencianet apenas quando um pagamento com cartão é confirmado.
Todas as versões menores que 3.0.0 continuam funcionais e não processam custo/comissão por uso.
Esses valores não são o mesmo que à tarifa do Cartão, pago separadamente à Gerencianet.