{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Magento 2","type":"basic","slug":"magento-2","excerpt":"Você está em: *\"Módulos e Plugins > Magento\"*","body":"**Módulo Oficial da Gerencianet para o Magento 2 - Versão 1.0.0**\n\nO módulo Gerencianet para Magento 2 permite receber pagamentos por meio do <strong>checkout transparente</strong> através da nossa API. Com ele, o proprietário da loja pode optar por receber pagamentos via boleto Bancário, Cartão de crédito e/ou Pix .\n\n# Requisitos\n\n- Versões do Magento 2 compatíveis: <code>2.3.3</code> a <code>2.4.3</code>\n- Versão mínima do PHP: <code>7.3.x</code> a <code>7.4.x</code>\n[block:callout]\n{\n \"type\": \"warning\",\n \"body\": \"Recomendamos que você possua um ambiente de testes para validar as alterações e atualizações antes de atualizar sua loja em produção. Também que seja feito um **backup** com todas as informações antes de executar qualquer procedimento de atualização/instalação.\",\n \"title\": \"ATENÇÃO!\"\n}\n[/block]\n<br>\n\n<hr>\n\n# Instalação do Módulo\nRealize o download do módulo e siga os seguintes passos de acordo com a forma que sua loja foi instalada:\n\n### Instalar usando o Composer\n\n- **Instale via packagist *\n - <code>composer require gerencianet/module-magento2</code>\n[block:callout]\n{\n \"type\": \"warning\",\n \"body\": \"Neste momento, podem ser solicitadas suas credenciais de autenticação do Magento. Caso tenha alguma dúvida, há uma descrição de como proceder neste [link da documentação oficial](http://devdocs.magento.com/guides/v2.0/install-gde/prereq/connect-auth.html).\",\n \"title\": \"Atenção!\"\n}\n[/block]\n2. Execute os comandos:\n\n - <code>bin/magento setup:upgrade</code>\n - <code>bin/magento setup:di:compile</code>\n - <code>bin/magento cache:clean</code>\n - <code>bin/magento setup:static-content:deploy -f</code>\n - <code>bin/magento cache:flush</code>\n\n### Instalar usando o Github\n- Realize o download do módulo: [Clicando aqui!](https://github.com/gerencianet/gn-api-magento2/archive/refs/heads/main.zip)\n\n 1. Extraia o conteúdo do download ZIP e mova o diretório <code>\\Magento2\\</code> para dentro da pasta <code>Gerencianet</code>;\n\n 2. Verifique se está dessa maneira seus diretórios na sua loja <code>app/code/Gerencianet/Magento2</code>\n\n 3. Habilite o módulo com o seguinte comando, <code>bin/magento module:enable Gerencianet_Magento2</code>\n\n 4. Instale a SDK PHP da Gerencianet utilizando o seguinte comando <code>composer require gerencianet/gerencianet-sdk-php:3.1.0</code>\n\n 5. Execute o comando: <code>bin/magento setup:upgrade</code>\n\n 6. Execute o comando: <code>bin/magento setup:di:compile</code>\n\n 7. Execute o comando: <code>bin/magento cache:clean</code>\n \n\n# Configurações\n\nAcesse no Painel Administrativo do Magento no menu lateral clique em **Lojas > Configuração > Clientes > Configurações de Cliente > Opções de Nome e Endereço**. Em *Número de Linhas em Endereço* você deve informar o número **4**, conforme imagem abaixo:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/6ab4614-Configuraes_do_endereo.png\",\n \"Configurações do endereço.png\",\n 1899,\n 966,\n \"#333\"\n ],\n \"caption\": \"Configurações do endereço\"\n }\n ]\n}\n[/block]\n**Certifique-se também que o campo de telefone esteja obrigatório.**\n\nApós realizar a configuração do Cliente, acesse no Painel Administrativo do Magento no menu lateral clique em `Lojas`, na sequencia clique em `Configuração`, no sub-menu `Vendas` clique em `Formas de Pagamento`. Será carregada a tela para configurar os meios de pagamentos do site.\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/c4a3e63-Configuraes_do_Modulo.png\",\n \"Configurações do Modulo.png\",\n 1899,\n 831,\n \"#333\"\n ],\n \"caption\": \"Configurações do Módulo\"\n }\n ]\n}\n[/block]\n# Como habilitar o Módulo da Gerencianet\n\nNo primeiro bloco de informação, está a configuração para habilitar ou desabilitar o módulo por completo, marque `Sim` para continuar a configuração. \n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/1d820be-Configuraes.png\",\n \"Configurações.png\",\n 1121,\n 527,\n \"#333\"\n ],\n \"caption\": \"Configurações do Módulo\"\n }\n ]\n}\n[/block]\nCampos: \n - **Ambiente**: Serve para descrever se as transações serão realizadas em ambiente de produção e homologação.\n - **Validação de mTLS**: se habilitado, validaremos o mTLS\n - **Identificador da Conta**: Identificador de Conta do Gerencianet\n - **Novo Order Status**: Serve para após a finalização da compra definir o Status do pedido.\n - **Credenciais de Desenvolvimento ou Produção**: Aqui você informa as suas credenciais (Client Id e Client Secret do ambiente selecionado).\n\nEm seguida temos as configurações de cartão de crédito, configurações de boleto e configurações de pix.\n\n_OBS: Para que todas as configurações a seguir funcionem, todo o passo a passo anterior deve ter sido seguido._\n\n### Cartão de Crédito \n\nNesta sessão você tem as configurações de cartão de crédito.\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/66d0334-Carto.png\",\n \"Cartão.png\",\n 1189,\n 260,\n \"#333\"\n ],\n \"caption\": \"Configurações do Cartão\"\n }\n ]\n}\n[/block]\nCampos: \n - **Habilitado**: Serve para habilitar ou desabilitar a funcionalidade de cartão de crédito.\n - **Título**: Altera o nome do método de pagamento no checkout.\n - **Sort Order**: Ordenação do método de pagamento.\n[block:callout]\n{\n \"type\": \"warning\",\n \"body\": \"*Toda configuração de parcelamento, é realizada através do painel da Gerencianet.*\"\n}\n[/block]\n### Pix \n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/a03cdc9-Pix.png\",\n \"Pix.png\",\n 1221,\n 508,\n \"#333\"\n ],\n \"caption\": \"Configurações do PIX\"\n }\n ]\n}\n[/block]\nNesta sessão você tem as configurações de pix.\nCampos: \n - **Habilitado**: Serve para habilitar ou desabilitar a funcionalidade do PIX.\n - **Título**: Altera o nome do método de pagamento no checkout.\n - **Dias de validade do Pix**: Tempo de validade do PIX (em segundos).\n - **Certificado Pix**: Certificado gerado no painel da Gerencianet\n - **Chave Pix**: Sua chave pix cadastrada na Gerencianet\n[block:callout]\n{\n \"type\": \"info\",\n \"body\": \"Caso a sua chave Pix esteja cadastrada como número de telefone, não se esqueça de seguir o padrão definido pelo BACEN informando +55 DDD e o número, exemplo: **+5531988887777**\",\n \"title\": \"Chave Pix\"\n}\n[/block]\n### Boleto \n\nNesta sessão você tem as configurações de boleto.\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/ed6b327-Boleto_.png\",\n \"Boleto_.png\",\n 1155,\n 862,\n \"#333\"\n ]\n }\n ]\n}\n[/block]\nCampos: \n - **Habilitado**: Serve para habilitar ou desabilitar a funcionalidade do boleto.\n - **Título**: Altera o nome do método de pagamento no checkout.\n - **Dias de validade do Boleto**: Validade do Boleto.\n - **Multa após o vencimento**: Valor da multa a ser cobrada após o vencimento.\n - **Juros após o vencimento**: Valor de juros a ser cobrado.\n - **Ordenação**: Ordenação do método de pagamento\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\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 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## 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 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## 4.3. É possível utilizar as funcionalidades de MarketPlace ou Assinaturas com o módulo?\n\nAinda não. Essa funcionalidade está em nosso backlog, mas ainda sem previsão de implementação\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 sub-aba \"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 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\" title=\"Link Externo\">Gerencianet</a>.","updates":[],"order":3,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"60d60a3e70a34700109eefb7","createdAt":"2021-06-25T16:54:22.891Z","user":"604a05aad26d8e0063848b8d","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Módulos e Plugins","slug":"módulos","order":19,"from_sync":false,"reference":false,"_id":"606f2ca6c5ba91007878342e","__v":0,"createdAt":"2016-06-14T16:28:00.991Z","project":"575aeffae12cf20e002f306c","version":"606f2ca7c5ba9100787834c6"},"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","61473375119247002a9c14d7","6283a3819575c60045513ea2"],"_id":"606f2ca7c5ba9100787834c6","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":4,"forked_from":"575aeffae12cf20e002f306f"},"project":"575aeffae12cf20e002f306c","__v":0,"parentDoc":null}
Magento 2
Você está em: *"Módulos e Plugins > Magento"*