{"_id":"576030b14715f61700ae85eb","version":{"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","__v":30,"createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","categories":["575aeffae12cf20e002f3070","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","57602fe5b82256240055c657","57602ff6c811102000cef302","576030909b1a9a220067ca40","57604518b82256240055c722","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","577680bf3cee3a0e00a000bc","577ff3b1ff48990e000c6806","5783f78c5cbce30e0074e2b7","5783f86292edb92200e6101c","5783f86dbfbba719003f0d8b","5783f8755cbce30e0074e2b8","5783f8b65cbce30e0074e2b9","5783f8bf5cbce30e0074e2ba","5783f8d8ce802f0e0087d574","578529f887c9280e0090394b","57852aeb87c9280e0090394d","57866e72b2f4060e00fa39ca","57ab6d5c39c2fd1900191879","57f39451ab0ee12000bef915","582499a0d90fa027009b259e","58c29df1258e5a1900b60478"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"2016","version_clean":"1.0.0","version":"1"},"project":"575aeffae12cf20e002f306c","user":"57601a13af3e090e00108059","parentDoc":null,"__v":65,"category":{"_id":"576030909b1a9a220067ca40","__v":0,"project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-06-14T16:28:00.991Z","from_sync":false,"order":11,"slug":"módulos","title":"Módulos e Plugins"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-14T16:28:33.502Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"**Módulo de Integração Gerencianet para OpenCart 3.x - Versão 3.0.0 (BETA)**\n\nO módulo Gerencianet para OpenCart permite receber pagamentos por meio do checkout transparente da nossa API. Este módulo é o Módulo Oficial da Gerencianet para o OpenCart, **compatível apenas com as versões do OpenCart superior a 3.0.2.0**.\n\n**Caso você tenha uma versão inferior do Opencart**, verifique a versão correta do módulo a ser baixado na seção [Versões do Módulo Gerencianet para OpenCart](https://dev.gerencianet.com.br/docs/opencart#section-6-vers-es-do-m-dulo-gerencianet-para-opencart), de acordo com com a versão do OpenCart utilizada.\n\n# 1. Requisitos\n\n- Versão mínima do PHP: <code>5.4.0</code>\n- Versão mínima do OpenCart: <code>3.0.2.0</code>\n- É necessário que o <code>Real Brasileiro</code> esteja configurado como moeda padrão no Opencart.\n\n<br>\n<hr>\n\n# 2. Pré-Instalação\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"Este passo só deve ser seguido caso você tenha a versão antiga do módulo Gerencianet/Opencart e o Opencart 3.0.x.\"\n}\n[/block]\n1. Desinstale o módulo antigo da Gerencianet;\n\n2. Apague os seguintes arquivos no servidor onde o OpenCart está instalado:\n\n  <pre>loja/admin/controller/payment/gerencianet.php\n\n  loja/admin/language/en-gb/payment/gerencianet.php\n\n  loja/admin/view/template/payment/gerencianet.tpl\n\n  loja/catalog/controller/payment/gerencianet.php\n\n  loja/catalog/language/en-gb/payment/gerencianet.php\n\n  loja/catalog/model/payment/gerencianet.php\n\n  loja/catalog/view/theme/default/template/payment/gerencianet.tpl\n\n  loja/catalog/view/theme/default/template/payment/gerencianet_payment.tpl\n\n  loja/catalog/view/theme/default/template/payment/gerencianet_success.tpl</pre>\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"ATENÇÃO\",\n  \"body\": \"Nenhum diretório deve ser apagado, apenas os arquivos citados acima.\"\n}\n[/block]\n<br>\n<hr>\n\n# 3. Instalação\n\nO módulo da Gerencianet para OpenCart pode ser instalado de duas formas:\n\n- *[Instalação Automática](https://dev.gerencianet.com.br/docs/opencart#section-3-1-instala-o-autom-tica):* utilizando o arquivo de instalação do módulo compactado através da ferramenta de adicionar nova extensão do OpenCart;\n\n- *[Instalação Manual](https://dev.gerencianet.com.br/docs/opencart#section-3-2-instala-o-manual):* os arquivos do módulo devem ser enviados manualmente para o servidor de hospedagem via FTP.\n\n\n## 3.1. Instalação Automática\n\n1. Faça o download do <a href=\"https://github.com/gerencianet/gn-api-opencart/blob/master/auto\" target=\"_blank\">instalador automático do módulo</a>;\n\n2. Na administração da loja OpenCart, acesse o menu <code>System > Settings</code> (ou <code>Configurações > Lojas</code>) e clique no botão <code>Edit</code> (ou <code>Editar</code>). Na aba FTP, preencha as informações de acesso ao FTP de sua hospedagem. Tenha atenção especial ao campo <code>FTP Root</code> (ou <code>Diretório FTP</code>), que é o caminho completo para o diretório raiz em que está instalado o seu OpenCart. Em seguida, clique no botão <code>Save</code> (ou <code>Salvar</code>);\n\n3. Acesse o menu <code>Extensions > Extension Installer</code> (ou <code>Extensões > Instalador</code>), clique no botão <code>Upload</code>, selecione o arquivo <code>gerencianet.ocmod.zip</code> (citado na primeira instrução) e aguarde a conclusão da instalação automática.\n     * 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.\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"ATENÇÃO\",\n  \"body\": \"Devido ao tamanho do arquivo de instalação do módulo, talvez seja necessário alterar o parâmetro <code>php_max_upload</code> do <code>php.ini</code> para, no mínimo, 3 mb.\"\n}\n[/block]\n<br>\n\n## 3.2. Instalação Manual\n\n1. Faça o download dos <a href=\"https://github.com/gerencianet/gn-api-opencart/blob/master/manual\" target=\"_blank\">arquivos da última versão do módulo</a>;\n\n2. Descompacte os arquivos baixados e realize o upload das pastas <code>admin</code>, <code>catalog</code> e <code>lib</code> para dentro do diretório principal do OpenCart*.\n\n  - <em>*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.</em>\n\n<br>\n<hr>\n\n# 4. Configurações\n\nAo acessar <code>Extensions > Payments</code> (ou <code>Extensões > Pagamentos</code>), você já visualizará o módulo da Gerencianet disponível na lista. Clique em <code>Install</code> para instalar o módulo e depois em <code>edit</code> para iniciar a configuração.\n\nTrês abas estarão disponíveis para realizar a configuração do módulo:\n\n- Configurações Gerais\n- Credenciais\n- Status da Compra\n\n## Aba \"Configurações Gerais\"\n\n<br>\n\n<img src=\"https://files.readme.io/sy26mG7QreUEMFE0dTMJ_configuracao1.png\" alt=\"Aba Configurações Gerais\">\n\nNesta aba, as seguintes propriedades podem ser configuradas:\n\n- *Modo:* 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;\n\n- *Pagamentos permitidos:* Determina quais tipos de pagamentos serão aceitos pelo módulo;\n\n- *Dias para vencimento do Boleto:* Determina em quantos dias o boleto irá vencer após a data de geração;\n\n- *Desconto para pagamento no Boleto:* Você pode fornecer desconto para clientes que pagam por meio de Boleto Bancário;\n\n- *Instruções no Boleto Bancário:* Você pode definir quatro linhas com até 90 caracteres de instruções no Boleto Bancário. Se as linhas não forem preenchidas, serão exibidas as instruções padrões no boleto;\n\n- *Atualizar status dos pedidos do OpenCart automaticamente:* Determina se o módulo poderá atualizar automaticamente o status de um pedido de acordo com as notificações de atualização enviadas pela Gerencianet;\n\n- *Envio de e-mail automático da sua loja para notificar o cliente:* Notifica o cliente por um e-mail da sua loja quando uma atualização do status automática for realizada. Independente da opção, a Gerencianet enviará um e-mail para o cliente informando sobre a cobrança;\n\n- *Status:* Determina se o módulo de pagamentos da Gerencianet está Ativo ou Inativo.\n\n<br>\n\n## Aba \"Credenciais\"\n\n<br>\n\n<img src=\"https://files.readme.io/XWTvBmCkQAyNVbjb6jrr_configuracao2.png\" alt=\"Aba Credenciais\">\n\nNesta aba é necessário informar as credenciais de sua aplicação, isto é, o \"Client_Id\" e \"Client_Secret\" (veja onde localizar, de acordo com o ambiente: <a href=\"http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png\" target=\"_blank\">desenvolvimento</a> e <a href=\"http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png\" target=\"_blank\">produção</a>) da sua aplicação e o <a href=\"http://image.prntscr.com/image/cabe13e1e5b64449b942cf31139150ba.png\" target=\"_blank\">identificador da conta</a> obtidos na aplicação criada na Gerencianet (veja onde localizar, de acordo com o layout de sua plataforma - <a href=\"https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_n.png\" target=\"_blank\">opção 1</a> ou <a href=\"https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_p.png\" target=\"_blank\">opção 2</a>).\n\n<br>\n\n## Aba \"Status da Compra\"\n\n<br>\n\n<img src=\"https://files.readme.io/f35fmH3DTKuvEzWNAvV2_configuracao3.png\" alt=\"Aba Status da Compra\">\n\nNesta 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.\n\n<br>\n<hr>\n\n# 5. Funcionamento do Módulo\n\nApós ser habilitado, o módulo já estará disponível como uma opção de pagamento. Dependendo da sua configuração de habilitar ou não a opção de <code>Checkout em um passo</code>, a página que o cliente digitará seus dados de pagamento será diferente. Se a opção de <code>Checkout em um passo</code> estiver ativa, seu cliente irá preencher os dados de pagamento na mesma tela de <code>Finalizar compra</code>, conforme as figuras abaixo:\n\n<img src=\"https://files.readme.io/ujIGV8lCRydeWgvUc2yQ_pag1.png\" alt=\"Funcionamento do Módulo\">\n\n<img src=\"https://files.readme.io/kwp6VIN7RJ209eZUDLGs_pag2.png\" alt=\"Funcionamento do Módulo\">\n\nDesta forma, ao clicar em <code>Finalizar Compra</code>, os dados do cliente serão validados e, caso esteja tudo correto, a cobrança será gerada e a compra finalizada. O cliente então é redirecionado para a página de compra finalizada.\n\nCaso a opção de <code>Checkout em um passo</code> não estiver ativa, seu cliente irá preencher os dados pessoas e de entrega na página de <code>Finalizar Compra</code> e ao clicar em <code>Confirmar Pedido</code> será redirecionado para outra página para prosseguir com o pagamento, onde optará pelas opções de pagamento da Gerencianet, conforme figura abaixo:\n\n<img src=\"https://files.readme.io/uU9HNwvlTEZvn2LK6XdQ_pag_b1.png\">\n\nAmbas as telas de pagamento podem sofrer mudanças de acordo com o tema utilizado na loja.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"NOTA\",\n  \"body\": \"Se algum dos campos obrigatórios para o realizar o pagamento não for preenchido corretamente, ele será cobrado novamente no formulário de pagamento. Para **Boleto Bancário**, os campos obrigatórios são: **Nome, E-mail, CPF** e **Telefone**. Para **Cartão de Crédito**, os campos obrigatórios são: **Nome, E-mail, CPF, data de nascimento, Telefone, Endereço, Número, Bairro, CEP, Cidade** e **Estado**.</em>\"\n}\n[/block]\n<br>\n<hr>\n\n# 6. Versões do Módulo Gerencianet para OpenCart\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Versão do Módulo\",\n    \"h-1\": \"Status\",\n    \"h-2\": \"Repositório\",\n    \"h-3\": \"Versão do OpenCart Compatível\",\n    \"0-0\": \"1.x\",\n    \"1-0\": \"2.x\",\n    \"2-0\": \"3.x\",\n    \"0-1\": \"Mantido\",\n    \"1-1\": \"Mantido\",\n    \"2-1\": \"Mantido\",\n    \"0-2\": \"<a href=\\\"https://github.com/gerencianet/gn-api-opencart/tree/1.x\\\" target=\\\"_blank\\\">v1</a>\",\n    \"1-2\": \"<a href=\\\"https://github.com/gerencianet/gn-api-opencart/tree/2.x\\\" target=\\\"_blank\\\">v2</a>\",\n    \"2-2\": \"<a href=\\\"https://github.com/gerencianet/gn-api-opencart\\\" target=\\\"_blank\\\">v3</a>\",\n    \"0-3\": \"<code>>= 2.0</code>\",\n    \"1-3\": \"<code>>= 2.3</code>\",\n    \"2-3\": \"<code>>= 3.0</code>\"\n  },\n  \"cols\": 4,\n  \"rows\": 3\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"NOTA\",\n  \"body\": \"Durante alguns testes realizados no Opencart 2.3.0.2 quanto à troca de idiomas para português/br, observamos um mal funcionamento da loja, ocasionando, por exemplo, exclusão de alguns produtos da loja, dentre outros problemas que foram identificados. Salientamos que estes problemas não possuem nenhuma relação com o módulo disponibilizado pela Gerencianet.\\n\\nPara solucionar, acesse <a href=\\\"https://github.com/opencartbrasil/traducao/issues/27\\\" target=\\\"_blank\\\">este issue</a> no github do OpenCart Brasil e confira como proceder.\"\n}\n[/block]\n<br>\n<hr>\n\n# 7. Dúvidas Frequentes\n\n** 7.1. É obrigatório possuir SSL em minha loja para aceitar pagamentos com o módulo?**\n\nPara que o módulo da Gerencianet para OpenCart funcione, não é necessário que a loja possua um certificado SSL. Contudo é extremamente recomendado pela Gerencianet que os lojistas utilizem. Independente da sua utilização, todos os dados de pagamento são criptografados e transmitidos com segurança para validação do pagamento. A presença de um certificado SSL instalado em sua loja garante maior segurança para o lojista e para os clientes que realizam compras. A ausência do certificado SSL na tela de pagamento, pode fazer com que o lojista perca vendas, uma vez que o cliente pode se sentir inseguro para digitar dados de pagamento em uma página que não possui um certificado.\n\n<br />\n** 7.2. Quero usar o Checkout Transparente de forma que o cliente não saia da minha loja para realizar o pagamento. É possível?**\n\nSim. O módulo da Gerencianet para OpenCart utiliza o checkout transparente para realizar o pagamento dos clientes, ou seja, em nenhum momento o cliente irá sair da sua loja virtual para finalizar o pagamento. Assim, no último passo da compra, será solicitado ao clientes dos dados obrigatórios para efetivar o pagamento.\n\n<br />\n** 7.3. É possível utilizar as funcionalidades de MarketPlace ou Assinaturas com o módulo?**\n\nAinda não. Mas em breve será disponibilizada uma atualização que irá permitir a configuração dessas funcionalidades em sua loja virtual.\n\n<br />\n** 7.4. As parcelas das opções de pagamento não estão sendo carregadas. Como corrigir?**\n\nSe após a instalação e configuração do módulo as parcelas do cartão de crédito não carregarem ao clicar sobre as bandeiras dos cartões, o lojista deverá verificar as credenciais informadas na configuração do módulo. Se estiverem corretas, entre em contato com a Gerencianet para que o problema seja analisado.\n\n<br />\n** 7.5.  Estou recebendo a mensagem *“Unauthorized”* ao tentar finalizar uma compra. O que fazer?**\n\nEssa mensagem de erro pode estar relacionada com a as credenciais informadas de forma incorreta. Verifique se as suas credenciais estão corretamente inseridas nos respectivos campos de PRODUÇÃO e DESENVOLVIMENTO. Caso o erro persista, entre em contato com o suporte da Gerencianet.\n\n<br />\n** 7.6. Está aparecendo a mensagem *“Gerencianet Desabilitada: O modo Sandbox (Ambiente de testes) está ativo. Suas cobranças não serão validadas”*. Como corrigir?**\n\nEsta mensagem irá ser exibida quando seu módulo estiver configurado em ambiente de testes (sandbox). Para remover esta mensagem e começar a receber com a Gerencianet, acesse as configurações do módulo em <code>Extensions > Payments > Gerencianet > Editar</code> (ou em <code>Extensões > Pagamentos > Gerencianet > Editar</code>) e desmarque a opção <code>SandBox > Habilitar Sandbox Gerencianet (Ambiente de testes).</code>\n\n<br />\n** 7.7. Onde posso acompanhar as transações geradas pelo módulo?**\n\nAs transações geradas através do módulo podem ser acompanhadas em sua conta Gerencianet no link <code>API > Minhas Aplicações > Sua Aplicação</code>. Neste ambiente você poderá acompanhar todas as transações e suas respectivas situações.\n\n<br />\n** 7.8. Quando tento realizar um pagamento recebo a mensagem *“Ocorreu um erro ao tentar realizar a sua requisição. Entre em contato com o proprietário da loja.”***\n\nEssa mensagem de erro pode ser exibida no momento da finalização da compra por diversos fatores. Neste caso, o primeiro passo é verificar as credenciais da sua aplicação. Se estiverem corretas, entre em contato com a Gerencianet informando o problema.\n\n<br />\n** 7.9. Como alterar as informações do topo do Boleto?**\n\nCaso queira alterar alguma das informações contidas no boleto, entre em contato com a Gerencianet através de ticket ou telefone para verificar se é possível alterar as informações que deseja.\n\n<br />\n<hr>\n\n# 8. Suporte e Sugestões\n\nSua sugestão de novas ideias e implementações para o módulo da Gerencianet para OpenCart é muito importante. Portanto, caso você tenha alguma ideia, entre em contato com a nossa equipe. Iremos analisar sua sugestão e avaliar a possibilidade de implantação.\n\nCaso você tenha alguma dúvida, entre em contato conosco pelo site <a href=\"https://gerencianet.com.br/\" target=\"_blank\">Gerencianet</a>.","excerpt":"Você está em: *\"Módulos e Plugins > OpenCart\"*","slug":"opencart","type":"basic","title":"OpenCart"}

OpenCart

Você está em: *"Módulos e Plugins > OpenCart"*

**Módulo de Integração Gerencianet para OpenCart 3.x - Versão 3.0.0 (BETA)** O módulo Gerencianet para OpenCart permite receber pagamentos por meio do checkout transparente da nossa API. Este módulo é o Módulo Oficial da Gerencianet para o OpenCart, **compatível apenas com as versões do OpenCart superior a 3.0.2.0**. **Caso você tenha uma versão inferior do Opencart**, verifique a versão correta do módulo a ser baixado na seção [Versões do Módulo Gerencianet para OpenCart](https://dev.gerencianet.com.br/docs/opencart#section-6-vers-es-do-m-dulo-gerencianet-para-opencart), de acordo com com a versão do OpenCart utilizada. # 1. Requisitos - Versão mínima do PHP: <code>5.4.0</code> - Versão mínima do OpenCart: <code>3.0.2.0</code> - É necessário que o <code>Real Brasileiro</code> esteja configurado como moeda padrão no Opencart. <br> <hr> # 2. Pré-Instalação [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "Este passo só deve ser seguido caso você tenha a versão antiga do módulo Gerencianet/Opencart e o Opencart 3.0.x." } [/block] 1. Desinstale o módulo antigo da Gerencianet; 2. Apague os seguintes arquivos no servidor onde o OpenCart está instalado: <pre>loja/admin/controller/payment/gerencianet.php loja/admin/language/en-gb/payment/gerencianet.php loja/admin/view/template/payment/gerencianet.tpl loja/catalog/controller/payment/gerencianet.php loja/catalog/language/en-gb/payment/gerencianet.php loja/catalog/model/payment/gerencianet.php loja/catalog/view/theme/default/template/payment/gerencianet.tpl loja/catalog/view/theme/default/template/payment/gerencianet_payment.tpl loja/catalog/view/theme/default/template/payment/gerencianet_success.tpl</pre> [block:callout] { "type": "danger", "title": "ATENÇÃO", "body": "Nenhum diretório deve ser apagado, apenas os arquivos citados acima." } [/block] <br> <hr> # 3. Instalação O módulo da Gerencianet para OpenCart pode ser instalado de duas formas: - *[Instalação Automática](https://dev.gerencianet.com.br/docs/opencart#section-3-1-instala-o-autom-tica):* utilizando o arquivo de instalação do módulo compactado através da ferramenta de adicionar nova extensão do OpenCart; - *[Instalação Manual](https://dev.gerencianet.com.br/docs/opencart#section-3-2-instala-o-manual):* os arquivos do módulo devem ser enviados manualmente para o servidor de hospedagem via FTP. ## 3.1. Instalação Automática 1. Faça o download do <a href="https://github.com/gerencianet/gn-api-opencart/blob/master/auto" target="_blank">instalador automático do módulo</a>; 2. Na administração da loja OpenCart, acesse o menu <code>System > Settings</code> (ou <code>Configurações > Lojas</code>) e clique no botão <code>Edit</code> (ou <code>Editar</code>). Na aba FTP, preencha as informações de acesso ao FTP de sua hospedagem. Tenha atenção especial ao campo <code>FTP Root</code> (ou <code>Diretório FTP</code>), que é o caminho completo para o diretório raiz em que está instalado o seu OpenCart. Em seguida, clique no botão <code>Save</code> (ou <code>Salvar</code>); 3. Acesse o menu <code>Extensions > Extension Installer</code> (ou <code>Extensões > Instalador</code>), clique no botão <code>Upload</code>, selecione o arquivo <code>gerencianet.ocmod.zip</code> (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. [block:callout] { "type": "danger", "title": "ATENÇÃO", "body": "Devido ao tamanho do arquivo de instalação do módulo, talvez seja necessário alterar o parâmetro <code>php_max_upload</code> do <code>php.ini</code> para, no mínimo, 3 mb." } [/block] <br> ## 3.2. Instalação Manual 1. Faça o download dos <a href="https://github.com/gerencianet/gn-api-opencart/blob/master/manual" target="_blank">arquivos da última versão do módulo</a>; 2. Descompacte os arquivos baixados e realize o upload das pastas <code>admin</code>, <code>catalog</code> e <code>lib</code> para dentro do diretório principal do OpenCart*. - <em>*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.</em> <br> <hr> # 4. Configurações Ao acessar <code>Extensions > Payments</code> (ou <code>Extensões > Pagamentos</code>), você já visualizará o módulo da Gerencianet disponível na lista. Clique em <code>Install</code> para instalar o módulo e depois em <code>edit</code> para iniciar a configuração. Três abas estarão disponíveis para realizar a configuração do módulo: - Configurações Gerais - Credenciais - Status da Compra ## Aba "Configurações Gerais" <br> <img src="https://files.readme.io/sy26mG7QreUEMFE0dTMJ_configuracao1.png" alt="Aba Configurações Gerais"> Nesta aba, as seguintes propriedades podem ser configuradas: - *Modo:* 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; - *Pagamentos permitidos:* Determina quais tipos de pagamentos serão aceitos pelo módulo; - *Dias para vencimento do Boleto:* Determina em quantos dias o boleto irá vencer após a data de geração; - *Desconto para pagamento no Boleto:* Você pode fornecer desconto para clientes que pagam por meio de Boleto Bancário; - *Instruções no Boleto Bancário:* Você pode definir quatro linhas com até 90 caracteres de instruções no Boleto Bancário. Se as linhas não forem preenchidas, serão exibidas as instruções padrões no boleto; - *Atualizar status dos pedidos do OpenCart automaticamente:* Determina se o módulo poderá atualizar automaticamente o status de um pedido de acordo com as notificações de atualização enviadas pela Gerencianet; - *Envio de e-mail automático da sua loja para notificar o cliente:* Notifica o cliente por um e-mail da sua loja quando uma atualização do status automática for realizada. Independente da opção, a Gerencianet enviará um e-mail para o cliente informando sobre a cobrança; - *Status:* Determina se o módulo de pagamentos da Gerencianet está Ativo ou Inativo. <br> ## Aba "Credenciais" <br> <img src="https://files.readme.io/XWTvBmCkQAyNVbjb6jrr_configuracao2.png" alt="Aba Credenciais"> Nesta aba é necessário informar as credenciais de sua aplicação, isto é, o "Client_Id" e "Client_Secret" (veja onde localizar, de acordo com o ambiente: <a href="http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png" target="_blank">desenvolvimento</a> e <a href="http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png" target="_blank">produção</a>) da sua aplicação e o <a href="http://image.prntscr.com/image/cabe13e1e5b64449b942cf31139150ba.png" target="_blank">identificador da conta</a> obtidos na aplicação criada na Gerencianet (veja onde localizar, de acordo com o layout de sua plataforma - <a href="https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_n.png" target="_blank">opção 1</a> ou <a href="https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_p.png" target="_blank">opção 2</a>). <br> ## Aba "Status da Compra" <br> <img src="https://files.readme.io/f35fmH3DTKuvEzWNAvV2_configuracao3.png" alt="Aba Status da Compra"> 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. <br> <hr> # 5. Funcionamento do Módulo Após ser habilitado, o módulo já estará disponível como uma opção de pagamento. Dependendo da sua configuração de habilitar ou não a opção de <code>Checkout em um passo</code>, a página que o cliente digitará seus dados de pagamento será diferente. Se a opção de <code>Checkout em um passo</code> estiver ativa, seu cliente irá preencher os dados de pagamento na mesma tela de <code>Finalizar compra</code>, conforme as figuras abaixo: <img src="https://files.readme.io/ujIGV8lCRydeWgvUc2yQ_pag1.png" alt="Funcionamento do Módulo"> <img src="https://files.readme.io/kwp6VIN7RJ209eZUDLGs_pag2.png" alt="Funcionamento do Módulo"> Desta forma, ao clicar em <code>Finalizar Compra</code>, os dados do cliente serão validados e, caso esteja tudo correto, a cobrança será gerada e a compra finalizada. O cliente então é redirecionado para a página de compra finalizada. Caso a opção de <code>Checkout em um passo</code> não estiver ativa, seu cliente irá preencher os dados pessoas e de entrega na página de <code>Finalizar Compra</code> e ao clicar em <code>Confirmar Pedido</code> será redirecionado para outra página para prosseguir com o pagamento, onde optará pelas opções de pagamento da Gerencianet, conforme figura abaixo: <img src="https://files.readme.io/uU9HNwvlTEZvn2LK6XdQ_pag_b1.png"> Ambas as telas de pagamento podem sofrer mudanças de acordo com o tema utilizado na loja. [block:callout] { "type": "info", "title": "NOTA", "body": "Se algum dos campos obrigatórios para o realizar o pagamento não for preenchido corretamente, ele será cobrado novamente no formulário de pagamento. Para **Boleto Bancário**, os campos obrigatórios são: **Nome, E-mail, CPF** e **Telefone**. Para **Cartão de Crédito**, os campos obrigatórios são: **Nome, E-mail, CPF, data de nascimento, Telefone, Endereço, Número, Bairro, CEP, Cidade** e **Estado**.</em>" } [/block] <br> <hr> # 6. Versões do Módulo Gerencianet para OpenCart [block:parameters] { "data": { "h-0": "Versão do Módulo", "h-1": "Status", "h-2": "Repositório", "h-3": "Versão do OpenCart Compatível", "0-0": "1.x", "1-0": "2.x", "2-0": "3.x", "0-1": "Mantido", "1-1": "Mantido", "2-1": "Mantido", "0-2": "<a href=\"https://github.com/gerencianet/gn-api-opencart/tree/1.x\" target=\"_blank\">v1</a>", "1-2": "<a href=\"https://github.com/gerencianet/gn-api-opencart/tree/2.x\" target=\"_blank\">v2</a>", "2-2": "<a href=\"https://github.com/gerencianet/gn-api-opencart\" target=\"_blank\">v3</a>", "0-3": "<code>>= 2.0</code>", "1-3": "<code>>= 2.3</code>", "2-3": "<code>>= 3.0</code>" }, "cols": 4, "rows": 3 } [/block] [block:callout] { "type": "info", "title": "NOTA", "body": "Durante alguns testes realizados no Opencart 2.3.0.2 quanto à troca de idiomas para português/br, observamos um mal funcionamento da loja, ocasionando, por exemplo, exclusão de alguns produtos da loja, dentre outros problemas que foram identificados. Salientamos que estes problemas não possuem nenhuma relação com o módulo disponibilizado pela Gerencianet.\n\nPara solucionar, acesse <a href=\"https://github.com/opencartbrasil/traducao/issues/27\" target=\"_blank\">este issue</a> no github do OpenCart Brasil e confira como proceder." } [/block] <br> <hr> # 7. Dúvidas Frequentes ** 7.1. É obrigatório possuir SSL em minha loja para aceitar pagamentos com o módulo?** Para que o módulo da Gerencianet para OpenCart funcione, não é necessário que a loja possua um certificado SSL. Contudo é extremamente recomendado pela Gerencianet que os lojistas utilizem. Independente da sua utilização, todos os dados de pagamento são criptografados e transmitidos com segurança para validação do pagamento. A presença de um certificado SSL instalado em sua loja garante maior segurança para o lojista e para os clientes que realizam compras. A ausência do certificado SSL na tela de pagamento, pode fazer com que o lojista perca vendas, uma vez que o cliente pode se sentir inseguro para digitar dados de pagamento em uma página que não possui um certificado. <br /> ** 7.2. Quero usar o Checkout Transparente de forma que o cliente não saia da minha loja para realizar o pagamento. É possível?** Sim. O módulo da Gerencianet para OpenCart utiliza o checkout transparente para realizar o pagamento dos clientes, ou seja, em nenhum momento o cliente irá sair da sua loja virtual para finalizar o pagamento. Assim, no último passo da compra, será solicitado ao clientes dos dados obrigatórios para efetivar o pagamento. <br /> ** 7.3. É possível utilizar as funcionalidades de MarketPlace ou Assinaturas com o módulo?** Ainda não. Mas em breve será disponibilizada uma atualização que irá permitir a configuração dessas funcionalidades em sua loja virtual. <br /> ** 7.4. As parcelas das opções de pagamento não estão sendo carregadas. Como corrigir?** Se após a instalação e configuração do módulo as parcelas do cartão de crédito não carregarem ao clicar sobre as bandeiras dos cartões, o lojista deverá verificar as credenciais informadas na configuração do módulo. Se estiverem corretas, entre em contato com a Gerencianet para que o problema seja analisado. <br /> ** 7.5. Estou recebendo a mensagem *“Unauthorized”* ao tentar finalizar uma compra. O que fazer?** Essa mensagem de erro pode estar relacionada com a as credenciais informadas de forma incorreta. Verifique se as suas credenciais estão corretamente inseridas nos respectivos campos de PRODUÇÃO e DESENVOLVIMENTO. Caso o erro persista, entre em contato com o suporte da Gerencianet. <br /> ** 7.6. Está aparecendo a mensagem *“Gerencianet Desabilitada: O modo Sandbox (Ambiente de testes) está ativo. Suas cobranças não serão validadas”*. Como corrigir?** Esta mensagem irá ser exibida quando seu módulo estiver configurado em ambiente de testes (sandbox). Para remover esta mensagem e começar a receber com a Gerencianet, acesse as configurações do módulo em <code>Extensions > Payments > Gerencianet > Editar</code> (ou em <code>Extensões > Pagamentos > Gerencianet > Editar</code>) e desmarque a opção <code>SandBox > Habilitar Sandbox Gerencianet (Ambiente de testes).</code> <br /> ** 7.7. Onde posso acompanhar as transações geradas pelo módulo?** As transações geradas através do módulo podem ser acompanhadas em sua conta Gerencianet no link <code>API > Minhas Aplicações > Sua Aplicação</code>. Neste ambiente você poderá acompanhar todas as transações e suas respectivas situações. <br /> ** 7.8. Quando tento realizar um pagamento recebo a mensagem *“Ocorreu um erro ao tentar realizar a sua requisição. Entre em contato com o proprietário da loja.”*** Essa mensagem de erro pode ser exibida no momento da finalização da compra por diversos fatores. Neste caso, o primeiro passo é verificar as credenciais da sua aplicação. Se estiverem corretas, entre em contato com a Gerencianet informando o problema. <br /> ** 7.9. Como alterar as informações do topo do Boleto?** Caso queira alterar alguma das informações contidas no boleto, entre em contato com a Gerencianet através de ticket ou telefone para verificar se é possível alterar as informações que deseja. <br /> <hr> # 8. Suporte e Sugestões Sua sugestão de novas ideias e implementações para o módulo da Gerencianet para OpenCart é muito importante. Portanto, caso você tenha alguma ideia, entre em contato com a nossa equipe. Iremos analisar sua sugestão e avaliar a possibilidade de implantação. Caso você tenha alguma dúvida, entre em contato conosco pelo site <a href="https://gerencianet.com.br/" target="_blank">Gerencianet</a>.