{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"OpenMage (Magento 1)","type":"basic","slug":"magento","excerpt":"Saiba onde, como baixar e instalar nosso módulo/plugin para OpenMage com as formas de pagamento: Pix, boleto bancário e cartão de crédito","body":"**Módulo Oficial da Gerencianet para o OpenMage**\n\nO módulo Gerencianet para OpenMage permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. \nATENÇÃO\nEste módulo é compatível com o OpenMage <span class=\"label label-default\">LTS 19.4.x</span>. \n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Caso você tenha ativado o Bolix em sua conta Gerencianet, as cobranças geradas pelo nosso módulo já virão com o Pix no boleto.\\nMais detalhes sobre o Bolix e como ativá-lo <a href=\\\"https://dev.gerencianet.com.br/docs/bolix-boleto-carne\\\" target=\\\"_blank\\\" title=\\\"Saiba mais sobre o Bolix\\\">aqui</a>\",\n  \"title\": \"Bolix\"\n}\n[/block]\n# Requisitos\n\n* Versão mínima do PHP: <code>7.0</code>\n* Versão mínima do OpenMage: <code>19.4.x</code>\n\n<br>\n\n<hr>\n\n# Instalação do Módulo\n\nO módulo da Gerencianet para OpenMage pode ser instalado utilizando o modgit ou enviando os arquivos manualmente para o servidor.\n\n### Instalar usando o [modgit](https://github.com/jreinke/modgit):\n\n    $ cd /path/to/openmage \n    $ modgit init\n    $ modgit add gerencianet https://github.com/gerencianet/gn-api-magento.git\n\n- Atualize o cache da sua loja acessando `Sistema > Gerenciador de Cache > Atualizar Cache`.\n\n### Instalar manualmente:\n\n- Baixe a [última versão](https://github.com/gerencianet/gn-api-magento/archive/master.zip) do módulo.\n- Descompacte o arquivo baixado e copie as pastas app, lib e skin para dentro do diretório principal do OpenMage*.\n- Execute os comandos:\n\n    ```\n    sudo find . -type d -exec chmod 755 {} \\;\n    sudo find . -type f -exec chmod 644 {} \\;\n    sudo chmod 777 -R app/etc/;\n    sudo chmod 777 -R var/;\n    sudo chmod 777 -R media/;\n```\n\n- Atualize o cache da sua loja acessando `Sistema > Gerenciador de Cache > Atualizar Cache`.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"\",\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<br>\n\n<hr>\n\n# Configurações\n\nAcessando `Sistema > Configuração > Formas de Pagamento`, 4 novos menus serão mostrados:\n\n- Gerencianet Pagamentos - Configurações Gerais\n- Gerencianet - Boleto\n- Gerencianet - Cartão de Cŕedito\n- Gerencianet - Pix\n\n<br>\n\n## **Gerencianet Pagamentos - Configurações Gerais**\n![Config](https://i.imgur.com/iVxDlsd.png)\n\n- **Habilitado:** Serve para habilitar ou desabilitar o módulo.\n- **Ambiente:** Serve para descrever se as transações acontecerão em ambiente de Produção ou Desenvolvimento.\n- **Modo debug:** Habilita o modo debug do módulo.\n- **Identificador da conta:** Identificador de Conta da Gerencianet.\n- **Credenciais de Desenvolvimento ou Produção:** Aqui você informa as suas credenciais, Client Id e Client Secret do ambiente selecionado.\n\n<br>\n\n### **Gerencianet - Boleto**\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\n![Boleto](https://i.imgur.com/NkbkCoE.png)\n\n- **Habilitado:** Serve para habilitar ou desabilitar a funcionalidade de Boletos.\n- **Título:** Altera o nome do método de pagamento no checkout.\n- **Dias para vencimento:** Validade do Boleto.\n- **Multa após vencimento:** Valor da multa a ser cobrada após o vencimento.\n- **Juros após vencimento:** Valor de juros a ser cobrado.\n- **Instruções no boleto:** Aqui você tem quatro campos que podem ser preenchido com mensagens no boleto, desde que as opções de juros e multa estejam zeradas.\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"ATENÇÃO\",\n  \"body\": \"Importante salientar que **os boletos gerados em sandbox (Ambiente de Homologação) 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 Homologação**, 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# 4. Dúvidas Frequentes\n\n## 4.1. É obrigatório possuir SSL em minha loja para aceitar pagamentos com o módulo?\n\nPara que o módulo da Gerencianet para OpenMage 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## 4.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 OpenMage 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## 4.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## 4.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## 4.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 HOMOLOGAÇÃO. Confira em [nossa FAQ](https://gerencianet.com.br/artigo/estou-deparando-com-mensagem-de-unauthorized-sem-autorizacao-por-que/) informações detalhadas.\n\n## 4.6. Está aparecendo a mensagem *“ATENÇÃO! Essa loja está em Modo Homologação. 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>Homologação</code> para <code>Produção</code>.\n\n## 4.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 \"Homologação\" você poderá acompanhar todas as transações e suas respectivas situações, de acordo com o ambiente que estiver utilizando.\n\n## 4.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 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\n<hr>\n\n# 5. Suporte e Sugestões\n\nSua sugestão de novas ideias e implementações para o módulo da Gerencianet para OpenMage é 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\" title=\"Link Externo\">Gerencianet</a>.","updates":[],"order":2,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"606f2ca7c5ba91007878344b","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Módulos e Plugins","slug":"módulos","order":17,"from_sync":false,"reference":false,"_id":"606f2ca6c5ba91007878342e","__v":0,"createdAt":"2016-06-14T16:28:00.991Z","project":"575aeffae12cf20e002f306c","version":"606f2ca7c5ba9100787834c6"},"createdAt":"2016-06-14T16:28:15.714Z","project":"575aeffae12cf20e002f306c","__v":115,"parentDoc":null,"user":"57601a13af3e090e00108059","version":{"version":"1.1.0","version_clean":"1.1.0","codename":"2021","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["606f2ca6c5ba91007878342b","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","606f2ca6c5ba91007878342c","606f2ca6c5ba91007878342d","606f2ca6c5ba91007878342e","606f2ca6c5ba91007878342f","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","606f2ca6c5ba910078783430","606f2ca6c5ba910078783431","5783f78c5cbce30e0074e2b7","606f2ca6c5ba910078783432","606f2ca6c5ba910078783433","606f2ca6c5ba910078783434","606f2ca6c5ba910078783435","606f2ca6c5ba910078783436","606f2ca6c5ba910078783437","578529f887c9280e0090394b","606f2ca6c5ba910078783438","606f2ca6c5ba910078783439","606f2ca6c5ba91007878343a","606f2ca6c5ba91007878343b","606f2ca6c5ba91007878343c","606f2ca6c5ba91007878343d","606f2ca6c5ba91007878343e","606f2ca6c5ba91007878343f","606f2ca6c5ba910078783440","606f2ca6c5ba910078783441","60d61f026ddc3901a32ee5f1","60ec37c637005f015e54174e"],"_id":"606f2ca7c5ba9100787834c6","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":2,"forked_from":"575aeffae12cf20e002f306f"},"githubsync":""}

OpenMage (Magento 1)

Saiba onde, como baixar e instalar nosso módulo/plugin para OpenMage com as formas de pagamento: Pix, boleto bancário e cartão de crédito

**Módulo Oficial da Gerencianet para o OpenMage** O módulo Gerencianet para OpenMage permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. ATENÇÃO Este módulo é compatível com o OpenMage <span class="label label-default">LTS 19.4.x</span>. [block:callout] { "type": "warning", "body": "Caso você tenha ativado o Bolix em sua conta Gerencianet, as cobranças geradas pelo nosso módulo já virão com o Pix no boleto.\nMais detalhes sobre o Bolix e como ativá-lo <a href=\"https://dev.gerencianet.com.br/docs/bolix-boleto-carne\" target=\"_blank\" title=\"Saiba mais sobre o Bolix\">aqui</a>", "title": "Bolix" } [/block] # Requisitos * Versão mínima do PHP: <code>7.0</code> * Versão mínima do OpenMage: <code>19.4.x</code> <br> <hr> # Instalação do Módulo O módulo da Gerencianet para OpenMage pode ser instalado utilizando o modgit ou enviando os arquivos manualmente para o servidor. ### Instalar usando o [modgit](https://github.com/jreinke/modgit): $ cd /path/to/openmage $ modgit init $ modgit add gerencianet https://github.com/gerencianet/gn-api-magento.git - Atualize o cache da sua loja acessando `Sistema > Gerenciador de Cache > Atualizar Cache`. ### Instalar manualmente: - Baixe a [última versão](https://github.com/gerencianet/gn-api-magento/archive/master.zip) do módulo. - Descompacte o arquivo baixado e copie as pastas app, lib e skin para dentro do diretório principal do OpenMage*. - Execute os comandos: ``` 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/; ``` - Atualize o cache da sua loja acessando `Sistema > Gerenciador de Cache > Atualizar Cache`. [block:callout] { "type": "info", "title": "", "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] <br> <hr> # Configurações Acessando `Sistema > Configuração > Formas de Pagamento`, 4 novos menus serão mostrados: - Gerencianet Pagamentos - Configurações Gerais - Gerencianet - Boleto - Gerencianet - Cartão de Cŕedito - Gerencianet - Pix <br> ## **Gerencianet Pagamentos - Configurações Gerais** ![Config](https://i.imgur.com/iVxDlsd.png) - **Habilitado:** Serve para habilitar ou desabilitar o módulo. - **Ambiente:** Serve para descrever se as transações acontecerão em ambiente de Produção ou Desenvolvimento. - **Modo debug:** Habilita o modo debug do módulo. - **Identificador da conta:** Identificador de Conta da Gerencianet. - **Credenciais de Desenvolvimento ou Produção:** Aqui você informa as suas credenciais, Client Id e Client Secret do ambiente selecionado. <br> ### **Gerencianet - Boleto** 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*. ![Boleto](https://i.imgur.com/NkbkCoE.png) - **Habilitado:** Serve para habilitar ou desabilitar a funcionalidade de Boletos. - **Título:** Altera o nome do método de pagamento no checkout. - **Dias para vencimento:** Validade do Boleto. - **Multa após vencimento:** Valor da multa a ser cobrada após o vencimento. - **Juros após vencimento:** Valor de juros a ser cobrado. - **Instruções no boleto:** Aqui você tem quatro campos que podem ser preenchido com mensagens no boleto, desde que as opções de juros e multa estejam zeradas. [block:callout] { "type": "danger", "title": "ATENÇÃO", "body": "Importante salientar que **os boletos gerados em sandbox (Ambiente de Homologação) 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 Homologação**, 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> # 4. Dúvidas Frequentes ## 4.1. É obrigatório possuir SSL em minha loja para aceitar pagamentos com o módulo? Para que o módulo da Gerencianet para OpenMage 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. ## 4.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 OpenMage 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. ## 4.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. ## 4.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. ## 4.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 HOMOLOGAÇÃO. Confira em [nossa FAQ](https://gerencianet.com.br/artigo/estou-deparando-com-mensagem-de-unauthorized-sem-autorizacao-por-que/) informações detalhadas. ## 4.6. Está aparecendo a mensagem *“ATENÇÃO! Essa loja está em Modo Homologação. 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>Homologação</code> para <code>Produção</code>. ## 4.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 "Homologação" você poderá acompanhar todas as transações e suas respectivas situações, de acordo com o ambiente que estiver utilizando. ## 4.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 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> # 5. Suporte e Sugestões Sua sugestão de novas ideias e implementações para o módulo da Gerencianet para OpenMage é 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" title="Link Externo">Gerencianet</a>.