{"_id":"576030b14715f61700ae85eb","version":{"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","__v":31,"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","5a7c4127490e52002a7f643c"],"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","githubsync":"","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":12,"slug":"módulos","title":"Módulos e Plugins"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-14T16:28:33.502Z","link_external":false,"link_url":"","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.1.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 tabela abaixo, atentando-se à versão de seu OpenCart.\n\n# 1. Requisitos do sistema\n\n- Versão mínima do PHP: <code>5.4.0</code>\n- OpenCart necessita do <code>curl</code> ativado\n- É necessário que o <code>Real Brasileiro</code> esteja configurado como moeda padrão no Opencart.\n- Versão do OpenCart: *Vide tabela abaixo*\n\n# 1.1. Versões do módulo Gerencianet para OpenCart\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Versão do módulo Gerencianet\",\n    \"h-1\": \"Status\",\n    \"h-2\": \"Repositório (branch)\",\n    \"h-3\": \"Versão do OpenCart Compatível (*)\",\n    \"0-0\": \"0.4.0\",\n    \"1-0\": \"2.1.0\",\n    \"2-0\": \"3.1.0 (beta)\",\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\\\">Download v1</a>\",\n    \"1-2\": \"<a href=\\\"https://github.com/gerencianet/gn-api-opencart/tree/2.x\\\" target=\\\"_blank\\\">Download v2</a>\",\n    \"2-2\": \"<a href=\\\"https://github.com/gerencianet/gn-api-opencart\\\" target=\\\"_blank\\\">Download v3</a>\",\n    \"0-3\": \"<code>2.0.0.0 à 2.2.0.0</code>\",\n    \"1-3\": \"<code>2.x</code>\",\n    \"2-3\": \"<code>3.0.2.0</code>\"\n  },\n  \"cols\": 4,\n  \"rows\": 3\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"(*) Os requisitos do sistema foram definidos de acordo com os nossos testes. Se seu sistema não se encaixa nos requisitos, não significa que algum dos três módulos disponibilizados não funcionarão em seu OpenCart, mas sim, que não testamos no mesmo ambiente.\\n\\n**Portanto, não garantimos o funcionamento deste módulo em ambientes diferentes dos citados acima.**\"\n}\n[/block]\n# 2. Pré-Instalação\n\n**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\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[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"ATENÇÃO\",\n  \"body\": \"Importante salientar que **os boletos gerados em sandbox não são válidos e não podem ser pagos**, possuem a linha digitável \\\"zerada\\\" e uma marca d'água ao fundo informando ser um boleto de teste.\\n\\n**Os pagamentos de cobranças de sandbox utilizando cartão de crédito são fictícios, mesmo se utilizar um cartão \\\"real\\\".** Todos os pagamentos de cartão neste ambiente terão o pagamento confirmado automaticamente, mas é apenas uma alteração de status para \\\"Pago\\\". Este recurso permite que você teste a notificação do status <code>paid</code>.\\n\\n**Isso significa que todos os pagamentos realizados em sandbox não são reais e, portanto, não há cobrança de nenhuma importância financeira.** \\n\\nÉ importante saber que as palavras **Playground, Sandbox e Ambiente de Desenvolvimento**, no contexto da Gerencianet, são sinônimos no sentido de fazerem referência ao local de testes que oferecemos em que você pode testar à vontade sua integração com a API.\"\n}\n[/block]\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: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. Acompanhe nosso [changelog](https://dev.gerencianet.com.br/docs/changelog) para visualizar todas as novidades.\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 (chaves Client_Id, Client_Secret e também o \"identificador da conta\"). 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. Confira em [nossa FAQ](https://gerencianet.com.br/artigo/estou-deparando-com-mensagem-de-unauthorized-sem-autorizacao-por-que/) informações detalhadas.\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 e também conferir em sua API a subaba \"histórico de requisições\" ([veja como usar este recurso](https://dev.gerencianet.com.br/docs/interpretando-erros-api)).\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.1.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 tabela abaixo, atentando-se à versão de seu OpenCart. # 1. Requisitos do sistema - Versão mínima do PHP: <code>5.4.0</code> - OpenCart necessita do <code>curl</code> ativado - É necessário que o <code>Real Brasileiro</code> esteja configurado como moeda padrão no Opencart. - Versão do OpenCart: *Vide tabela abaixo* # 1.1. Versões do módulo Gerencianet para OpenCart [block:parameters] { "data": { "h-0": "Versão do módulo Gerencianet", "h-1": "Status", "h-2": "Repositório (branch)", "h-3": "Versão do OpenCart Compatível (*)", "0-0": "0.4.0", "1-0": "2.1.0", "2-0": "3.1.0 (beta)", "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\">Download v1</a>", "1-2": "<a href=\"https://github.com/gerencianet/gn-api-opencart/tree/2.x\" target=\"_blank\">Download v2</a>", "2-2": "<a href=\"https://github.com/gerencianet/gn-api-opencart\" target=\"_blank\">Download v3</a>", "0-3": "<code>2.0.0.0 à 2.2.0.0</code>", "1-3": "<code>2.x</code>", "2-3": "<code>3.0.2.0</code>" }, "cols": 4, "rows": 3 } [/block] [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "(*) Os requisitos do sistema foram definidos de acordo com os nossos testes. Se seu sistema não se encaixa nos requisitos, não significa que algum dos três módulos disponibilizados não funcionarão em seu OpenCart, mas sim, que não testamos no mesmo ambiente.\n\n**Portanto, não garantimos o funcionamento deste módulo em ambientes diferentes dos citados acima.**" } [/block] # 2. Pré-Instalação **Este passo só deve ser seguido caso você tenha a versão antiga do módulo Gerencianet/Opencart e o Opencart 3.0.x.** 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. [block:callout] { "type": "danger", "title": "ATENÇÃO", "body": "Importante salientar que **os boletos gerados em sandbox não são válidos e não podem ser pagos**, possuem a linha digitável \"zerada\" e uma marca d'água ao fundo informando ser um boleto de teste.\n\n**Os pagamentos de cobranças de sandbox utilizando cartão de crédito são fictícios, mesmo se utilizar um cartão \"real\".** Todos os pagamentos de cartão neste ambiente terão o pagamento confirmado automaticamente, mas é apenas uma alteração de status para \"Pago\". Este recurso permite que você teste a notificação do status <code>paid</code>.\n\n**Isso significa que todos os pagamentos realizados em sandbox não são reais e, portanto, não há cobrança de nenhuma importância financeira.** \n\nÉ importante saber que as palavras **Playground, Sandbox e Ambiente de Desenvolvimento**, no contexto da Gerencianet, são sinônimos no sentido de fazerem referência ao local de testes que oferecemos em que você pode testar à vontade sua integração com a API." } [/block] <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: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. Acompanhe nosso [changelog](https://dev.gerencianet.com.br/docs/changelog) para visualizar todas as novidades. <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 (chaves Client_Id, Client_Secret e também o "identificador da conta"). 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. Confira em [nossa FAQ](https://gerencianet.com.br/artigo/estou-deparando-com-mensagem-de-unauthorized-sem-autorizacao-por-que/) informações detalhadas. <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 e também conferir em sua API a subaba "histórico de requisições" ([veja como usar este recurso](https://dev.gerencianet.com.br/docs/interpretando-erros-api)). <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>.