{"__v":115,"_id":"5760309fc0bca70e00afc06e","category":{"__v":0,"_id":"576030909b1a9a220067ca40","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"},"parentDoc":null,"project":"575aeffae12cf20e002f306c","user":"57601a13af3e090e00108059","version":{"__v":30,"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-14T16:28:15.714Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"**Módulo Oficial da Gerencianet para o Magento - Versão 0.2.6**\n\nO módulo Gerencianet para Magento permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. Este módulo é compatível com as versões <span class=\"label label-default\">1.7.x</span>, <span class=\"label label-default\">1.8.x</span> e <span class=\"label label-default\">1.9.x</span> do Magento. O módulo é compatível com diversos plugins de *one step checkout*, como por exemplo: *One Step Checkout 6*, *Checkout Venda Mais*, *IWD*, dentre outros.\n\n\n## Requisitos:\n<hr>\n\n* Versão mínima do PHP: <code>5.4.0</code>\n* Versão mínima do Magento: <code>1.7.0.0</code>\n\n\n## Instalação do Módulo:\n<hr>\n\nO módulo da Gerencianet para Magento pode ser instalado utilizando o modgit ou enviando os arquivos manualmente para o servidor.\n\n### i. Instalar usando o <a href=\"https://github.com/jreinke/modgit\" target=\"_blank\">modgit</a>:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"$ cd /path/to/magento\\n$ modgit init\\n$ modgit add gerencianet https://github.com/gerencianet/gn-api-magento.git\",\n      \"language\": \"text\",\n      \"name\": \"via modgit\"\n    }\n  ]\n}\n[/block]\n### ii. Instalar manualmente:\n\n1. Baixe a [última versão](https://github.com/gerencianet/gn-api-magento/archive/master.zip) do módulo Magento da Gerencianet;\n\n2. Descompacte o arquivo baixado e copie as pastas <code>app</code>, <code>lib</code> e <code>skin</code> para dentro do diretório principal do Magento*.\n\n3. Defina as seguintes permissões:\n   * **755** para todos os diretórios; **644** para todos os arquivos; **777** para <code>app/etc/</code>, <code>var/</code> e <code>media/</code>\n   * O procedimento acima seria equivalente a executar os comandos:\n   <pre>sudo find . -type d -exec chmod 755 {} \\;\nsudo find . -type f -exec chmod 644 {} \\;\nsudo chmod 777 -R app/etc/;\nsudo chmod 777 -R var/;\nsudo chmod 777 -R media/;\n</pre>\n\n4. Atualize o cache da sua loja acessando <code>Sistema > Gerenciador de Cache</code> (ou <code>System > Cache Management</code>), selecionando todos os tipos de cache.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"OBSERVAÇÃO\",\n  \"body\": \"*Ao substituir as pastas no seu projeto, o sistema pode informar que alguns arquivos serão sobrescritos. Não se preocupe, pode confirmar o procedimento pois a instalação não afetará nenhum arquivo já existente em seu projeto.\"\n}\n[/block]\n## Configurações:\n<hr>\n\nAcessando <code>Sistema > Configuração > Formas de Pagamento</code> (ou <code>System > Configuration > Payment Methods</code>), serão exibidos 3 (três) novos menus:\n\n* Gerencianet Transparente - Configurações Gerais\n* Gerencianet Transparente - Boleto\n* Gerencianet Transparente - Cartão de Crédito\n\n<br>\n\n<img src=\"https://files.readme.io/18c8b0e-magento_0-2-4.png\" alt=\"Imagem - Configurações Módulo Gerencianet para Magento\">\n\n<br>\n\nNo primeiro menu - <code>Checkout Transparente Gerencianet</code>, informe o identificador da conta e as credenciais da sua aplicação (*Client_Id* e *Client_Secret*) obtidos a partir da sua aplicação criada na Gerencianet, de acordo com o ambiente desejado (Desenvolvimento ou Produção).\n\nO identificador da conta e as credenciais podem ser encontradas conforme imagens a seguir:\n\n### Ambiente de Produção (DEPOIS que você já testou sua integração)\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/SGLQn4ZSxeNHx6FDVOYx_37948b55ba2547df8fb6c80167d11123.png\",\n        \"37948b55ba2547df8fb6c80167d11123.png\",\n        \"1021\",\n        \"381\",\n        \"#f23a1b\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n### Ambiente de Desenvolvimento (sandbox, para testar sua integração)\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/CFuzIY52R5iqD3xm66V1_a217cd4f9d22406e832ab6a11e85e24c.png\",\n        \"a217cd4f9d22406e832ab6a11e85e24c.png\",\n        \"1014\",\n        \"373\",\n        \"#e33f25\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n### Identificador da conta\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/RBq8qOBATzuXT5ma6z5V_8bb52451ef324bd3b2254c8cc681f1e2.png\",\n        \"8bb52451ef324bd3b2254c8cc681f1e2.png\",\n        \"395\",\n        \"243\",\n        \"#f36123\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n<br />\n\nPara habilitar e configurar informações do boleto, como as linhas de instrução e a quantidade de dias para vencimento, veja <code>Boleto Bancário - Gerencianet</code>.\n\nPara habilitar a opção de cartão de crédito, veja <code>Cartão de Crédito - Gerencianet</code>.\n\nPor padrão, o modulo utiliza sempre 4 linhas de endereço (acesse <code>Sistema > Configuração > Configuração do cliente > Opções de Nome e Endereço</code>. Marque <code>4</code> no campo <code>Número de linhas</code>), respectivamente, *street, number, complement* e *neighborhood*.\n\nAlém disso, a **data de nascimento** é obrigatória para cobranças via cartão e o CPF é obrigatório para qualquer tipo de pagamento. Acesse <code>Sistema > Configuração > Configuração do cliente > Opções de Nome e Endereço</code>. Marque <code>obrigatório</code> para <code>Exibir Data de Nascimento</code> e <code>Exibir CPF/CNPJ</code>.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"Quando estiver em ambiente de produção, use a \\\"Client_Id\\\" e \\\"Client_Secret\\\" da aba \\\"Produção\\\" e a opção sandbox desativada. Se estiver em desenvolvimento, use a Client_Id e Client_Secret da aba \\\"Desenvolvimento\\\" com a opção sandbox habilitada. Se não for realizado dessa forma, uma possível mensagem de \\\"unauthorized\\\" (sem autorização) poderá ser retornada.\"\n}\n[/block]\n**OBSERVAÇÃO:** 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**.\n\n<br />\n## Dúvidas Frequentes:\n<hr>\n\n**1) É obrigatório possuir SSL em minha loja para aceitar pagamentos com o módulo?**\n\nPara que o módulo da Gerencianet para Magento 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**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 Magento 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**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**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**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**6) Está aparecendo a mensagem *“ATENÇÃO! Essa loja está em Modo Desenvolvimento. Um boleto de teste será gerado no ambiente de Sandbox da Gerencianet”*. 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>Sistema > Configuração > Formas de Pagamento > Gerencianet Transparente</code> e altere a opção <code>Ambiente</code> de <code>Desenvolvimento</code> para <code>Produção</code>.\n\n<br />\n**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>. Através das abas \"Produção\" e \"Desenvolvimento\" você poderá acompanhar todas as transações e suas respectivas situações, de acordo com o ambiente que estiver utilizando.\n\n<br />\n**8) Quando tempo 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**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 a possibilidade de alteração das informações que deseja.\n\n<br />\n## Suporte e Sugestões:\n<hr>\n\nSua sugestão de novas ideias e implementações para o módulo da Gerencianet para Magento é 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 > Magento\"*","slug":"magento","type":"basic","title":"Magento"}

Magento

Você está em: *"Módulos > Magento"*

**Módulo Oficial da Gerencianet para o Magento - Versão 0.2.6** O módulo Gerencianet para Magento permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. Este módulo é compatível com as versões <span class="label label-default">1.7.x</span>, <span class="label label-default">1.8.x</span> e <span class="label label-default">1.9.x</span> do Magento. O módulo é compatível com diversos plugins de *one step checkout*, como por exemplo: *One Step Checkout 6*, *Checkout Venda Mais*, *IWD*, dentre outros. ## Requisitos: <hr> * Versão mínima do PHP: <code>5.4.0</code> * Versão mínima do Magento: <code>1.7.0.0</code> ## Instalação do Módulo: <hr> O módulo da Gerencianet para Magento pode ser instalado utilizando o modgit ou enviando os arquivos manualmente para o servidor. ### i. Instalar usando o <a href="https://github.com/jreinke/modgit" target="_blank">modgit</a>: [block:code] { "codes": [ { "code": "$ cd /path/to/magento\n$ modgit init\n$ modgit add gerencianet https://github.com/gerencianet/gn-api-magento.git", "language": "text", "name": "via modgit" } ] } [/block] ### ii. Instalar manualmente: 1. Baixe a [última versão](https://github.com/gerencianet/gn-api-magento/archive/master.zip) do módulo Magento da Gerencianet; 2. Descompacte o arquivo baixado e copie as pastas <code>app</code>, <code>lib</code> e <code>skin</code> para dentro do diretório principal do Magento*. 3. Defina as seguintes permissões: * **755** para todos os diretórios; **644** para todos os arquivos; **777** para <code>app/etc/</code>, <code>var/</code> e <code>media/</code> * O procedimento acima seria equivalente a executar os comandos: <pre>sudo find . -type d -exec chmod 755 {} \; sudo find . -type f -exec chmod 644 {} \; sudo chmod 777 -R app/etc/; sudo chmod 777 -R var/; sudo chmod 777 -R media/; </pre> 4. Atualize o cache da sua loja acessando <code>Sistema > Gerenciador de Cache</code> (ou <code>System > Cache Management</code>), selecionando todos os tipos de cache. [block:callout] { "type": "info", "title": "OBSERVAÇÃO", "body": "*Ao substituir as pastas no seu projeto, o sistema pode informar que alguns arquivos serão sobrescritos. Não se preocupe, pode confirmar o procedimento pois a instalação não afetará nenhum arquivo já existente em seu projeto." } [/block] ## Configurações: <hr> Acessando <code>Sistema > Configuração > Formas de Pagamento</code> (ou <code>System > Configuration > Payment Methods</code>), serão exibidos 3 (três) novos menus: * Gerencianet Transparente - Configurações Gerais * Gerencianet Transparente - Boleto * Gerencianet Transparente - Cartão de Crédito <br> <img src="https://files.readme.io/18c8b0e-magento_0-2-4.png" alt="Imagem - Configurações Módulo Gerencianet para Magento"> <br> No primeiro menu - <code>Checkout Transparente Gerencianet</code>, informe o identificador da conta e as credenciais da sua aplicação (*Client_Id* e *Client_Secret*) obtidos a partir da sua aplicação criada na Gerencianet, de acordo com o ambiente desejado (Desenvolvimento ou Produção). O identificador da conta e as credenciais podem ser encontradas conforme imagens a seguir: ### Ambiente de Produção (DEPOIS que você já testou sua integração) [block:image] { "images": [ { "image": [ "https://files.readme.io/SGLQn4ZSxeNHx6FDVOYx_37948b55ba2547df8fb6c80167d11123.png", "37948b55ba2547df8fb6c80167d11123.png", "1021", "381", "#f23a1b", "" ] } ] } [/block] ### Ambiente de Desenvolvimento (sandbox, para testar sua integração) [block:image] { "images": [ { "image": [ "https://files.readme.io/CFuzIY52R5iqD3xm66V1_a217cd4f9d22406e832ab6a11e85e24c.png", "a217cd4f9d22406e832ab6a11e85e24c.png", "1014", "373", "#e33f25", "" ] } ] } [/block] ### Identificador da conta [block:image] { "images": [ { "image": [ "https://files.readme.io/RBq8qOBATzuXT5ma6z5V_8bb52451ef324bd3b2254c8cc681f1e2.png", "8bb52451ef324bd3b2254c8cc681f1e2.png", "395", "243", "#f36123", "" ] } ] } [/block] <br /> Para habilitar e configurar informações do boleto, como as linhas de instrução e a quantidade de dias para vencimento, veja <code>Boleto Bancário - Gerencianet</code>. Para habilitar a opção de cartão de crédito, veja <code>Cartão de Crédito - Gerencianet</code>. Por padrão, o modulo utiliza sempre 4 linhas de endereço (acesse <code>Sistema > Configuração > Configuração do cliente > Opções de Nome e Endereço</code>. Marque <code>4</code> no campo <code>Número de linhas</code>), respectivamente, *street, number, complement* e *neighborhood*. Além disso, a **data de nascimento** é obrigatória para cobranças via cartão e o CPF é obrigatório para qualquer tipo de pagamento. Acesse <code>Sistema > Configuração > Configuração do cliente > Opções de Nome e Endereço</code>. Marque <code>obrigatório</code> para <code>Exibir Data de Nascimento</code> e <code>Exibir CPF/CNPJ</code>. [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "Quando estiver em ambiente de produção, use a \"Client_Id\" e \"Client_Secret\" da aba \"Produção\" e a opção sandbox desativada. Se estiver em desenvolvimento, use a Client_Id e Client_Secret da aba \"Desenvolvimento\" com a opção sandbox habilitada. Se não for realizado dessa forma, uma possível mensagem de \"unauthorized\" (sem autorização) poderá ser retornada." } [/block] **OBSERVAÇÃO:** 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**. <br /> ## Dúvidas Frequentes: <hr> **1) É obrigatório possuir SSL em minha loja para aceitar pagamentos com o módulo?** Para que o módulo da Gerencianet para Magento 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 /> **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 Magento 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 /> **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 /> **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 /> **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 /> **6) Está aparecendo a mensagem *“ATENÇÃO! Essa loja está em Modo Desenvolvimento. Um boleto de teste será gerado no ambiente de Sandbox da Gerencianet”*. 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>Sistema > Configuração > Formas de Pagamento > Gerencianet Transparente</code> e altere a opção <code>Ambiente</code> de <code>Desenvolvimento</code> para <code>Produção</code>. <br /> **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>. Através das abas "Produção" e "Desenvolvimento" você poderá acompanhar todas as transações e suas respectivas situações, de acordo com o ambiente que estiver utilizando. <br /> **8) Quando tempo 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 /> **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 a possibilidade de alteração das informações que deseja. <br /> ## Suporte e Sugestões: <hr> Sua sugestão de novas ideias e implementações para o módulo da Gerencianet para Magento é 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>.