Skip to content

Latest commit

 

History

History
100 lines (66 loc) · 5.69 KB

README.md

File metadata and controls

100 lines (66 loc) · 5.69 KB
Raw

Módulo de Integração Gerencianet para OpenCart Brasil

⚠️ Este módulo é compatível apenas com as versões do OpenCart 3.0.3.3 (Brasil 1.5.0) ou superior.⚠️

Em caso de dúvidas, você pode verificar a Documentação da API na Gerencianet e, necessitando de mais detalhes ou informações, entre em contato conosco, via nossos Canais de Comunicação.

Requisitos

Testado nas seguintes versões do PHP:

    PHP  7.2, 7.3 e 7.4

Dependências

Instalação de dependências que podem estar faltando (substitua o x pelo número da versão do seu PHP):

    sudo apt-get install php7.x-dom
    sudo apt-get install php7.x-curl
    sudo apt-get install php7.x-gd
    sudo apt-get install php7.x-xml
    sudo apt-get install php7.x-zip
  • OpenCart necessita do curl ativado
  • É necessário que o Real Brasileiro esteja configurado como moeda padrão no Opencart.

Instalação

Automática

  1. Faça o download do arquivo gerencianet.ocmod.zip.

  2. Acesse o menu Extensions > Extension Installer (Extensões > Instalador), clique no botão Upload, selecione o arquivo 'gerencianet.ocmod.zip' (citado na primeira instrução) e aguarde a conclusão da instalação automática.

⚠️ Caso você já tenha instalado o módulo da Gerencianet anteriormente, o OpenCart poderá informar que alguns arquivos serão sobrescritos. Não se preocupe, pois a instalação não afetará qualquer arquivo que não seja do módulo da Gerencianet já existente em sua loja. ⚠️

⚠️ Atenção: Devido ao tamanho do arquivo de instalação do módulo, talvez seja necessário alterar o parâmetro php_max_upload do php.ini para no mínimo 10mb. ⚠️

Manual

  1. Faça o download dos arquivos da última versão do módulo.
  2. Descompacte os arquivo baixado e realize o upload das pastas admin, catalog e lib para dentro do diretório principal do OpenCart.

⚠️ Caso você já tenha instalado o módulo da Gerencianet anteriormente, o OpenCart poderá informar que alguns arquivos serão sobrescritos. Não se preocupe, pois a instalação não afetará qualquer arquivo que não seja do módulo da Gerencianet já existente em sua loja. ⚠️

Configuração

Acesse Extensions > Modifications (Extensões > Modificações), selecione o módulo Gerencianet e clique no botão Refresh (Atualizar) no canto superior direito da página.

Ao acessar Extensions > Extensions (Extensões > Extensões), você deverá selecionar o tipo de extensão que deseja. Escolha Payments (Pagamentos). Você já visualizará o módulo da Gerencianet disponível na lista. Clique em install (instalar) para instalar o módulo e depois em edit (editar) para iniciar a configuração.

Cinco abas estarão disponíveis para realizar a configuração do módulo:

  • Geral
  • PIX
  • Boleto
  • Cartão de Crédito
  • Status do Pedido

Configurações Gerais

Nesta aba é necessário informar:

  • As credenciais de Produção e Desenvolvimento da sua aplicação (obtidas na sua conta Gerencianet)
  • O identificador da conta (obtido na sua conta Gerencianet)
  • Habilita o checkout em um passo: Determina se o checkout do plugin irá aparecer junto com o formulário de finalização do pedido ou se irá abrir uma nova página para finalização do pagamento.
  • Habilitar modo sandbox: Determina se o módulo está em modo de testes. No modo de teste você pode gerar cobranças fictícias para testar o fluxo.
  • Ativo: Determina se o módulo de pagamentos da Gerencianet está Ativo ou Inativo.

PIX

Nesta aba, as seguintes propriedades podem ser configuradas:

  • Chave PIX: Determina a qual chave PIX o pagamento será enviado
  • Caminho do certificado: Deve ser informado o caminho onde se encontra o seu certificado de segurança .pem
  • Desconto no Pagamento: Você pode fornecer desconto para clientes que pagam por meio do PIX.
  • Tempo de Vencimento (horas): Determina o tempo de validade do QrCode Gerado
  • Validar mTLS: Habilita ou desabilita a verificação de segurança utilizando mTLS. Mais informações você encontra AQUI

Boleto

Nesta aba, as seguintes propriedades podem ser configuradas:

  • Dias Para Vencimento: Determina a quantidade de dias para o vencimento do boleto, a contar da data de sua geração.
  • Desconto no pagamento: Determina a quantidade de desconto que será aplicado no boleto, em porcentagem.
  • Defina o percentual de multa: Configuração de multa para ser aplicada automaticamente no caso de pagamento após o vencimento do boleto.
  • Defina o percentual de juros: Configuração de jutos para ser aplicado automaticamente no caso de pagamento após o vencimento do boleto.
  • Observação: Permite incluir uma mensagem no boleto para o cliente final.
  • E-mail de cobrança: Caso selecionado, serão enviados e-mails sobre as transações para o cliente final.
  • Ativar boleto: Caso selecionado, ativará a opção boleto como forma de pagamento.

Cartão de Crédito

Nesta aba, as seguintes propriedades podem ser configuradas:

  • Ativar Cartão de Crédito: Caso selecionado, ativará a opção cartão de crédito como forma de pagamento.

Status do Pedido

Nesta aba é realizada a configuração dos Status de pagamento da Gerencianet com os Status de pagamento de sua loja. Assim, quando houver a alteração do status do pagamento na Gerencianet, o status do pedido em sua loja será atualizado automaticamente de acordo com as configurações definidas.