{"__v":67,"_id":"576030c84715f61700ae85ed","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:56.671Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"**Módulo de Integração Gerencianet para WooCommerce Oficial - Versão 0.5.3**\n\nO módulo Gerencianet para WordPress (WooCommerce) permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. Compatível com as versões <span class=\"label label-default\">2.2.x</span> <span class=\"label label-default\">2.3.x</span> <span class=\"label label-default\">2.4.x</span> <span class=\"label label-default\">2.5.x</span> e <span class=\"label label-default\">2.6.x</span> do WooCommerce.\n\nEste é o **Módulo Oficial de integração fornecido pela Gerencianet para WooCommerce**. Com ele, o proprietário da loja pode optar por receber pagamentos por boleto bancário e/ou cartão de crédito. Todo processo é realizado por meio do checkout transparente. Com isso, o comprador não precisa sair do site da loja para efetuar o pagamento.\n\nO módulo é compatível com o plugin <a href=\"http://wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/\" target=\"_blank\">WooCommerce Extra Checkout Fields for Brazil</a>. Com esse plugin instalado, algumas informações como CPF, número do endereço e bairro não serão solicitados no momento do pagamento.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"ATENÇÃO\",\n  \"body\": \"Antes de instalar o plugin da Gerencianet para WooCommerce, verifique os requisitos e compatibilidade. Caso sua loja esteja em produção, indicamos que realize um backup antes de iniciar o processo de instalação do plugin.\"\n}\n[/block]\n## Índice\n<hr>\n\nVá direto ao ponto ­- utilize o índice abaixo e veja diretamente o que você precisa:\n\n1. [Requisitos](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-1-requisitos)\n\n2. [Instalação do Plugin Gerencianet para WooCommerce (WordPress)](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-2-instala-o-do-plugin-gerencianet-para-woocommerce-wordpress-)\n\n3. [Configurações do Plugin Gerencianet para WooCommerce (WordPress)](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-3-configura-es-do-plugin-gerencianet-para-woocommerce-wordpress-)\n\n4. [Funcionamento do Plugin Gerencianet para WooCommerce (WordPress)](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-4-funcionamento-do-plugin-gerencianet-para-woocommerce-wordpress-)\n\n5. [Dúvidas Frequentes](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-5-d-vidas-frequentes)\n\n6. [Suporte e Sugestões](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-6-suporte-e-sugest-es)\n\n\n## 1. Requisitos\n<hr>\n\n- Versão mínima do PHP: <code>5.4.0</code>\n- Versão mínima do WooCommerce: <code>2.2.x</code>\n- Versão mínima do WordPress: <code>4.1</code>\n\n\n## 2. Instalação do Plugin Gerencianet para WooCommerce (WordPress)\n<hr>\n\nAntes de instalar o plugin, certifique-se que tenha instalado em sua página WordPress o plugin da loja virtual WooCommerce. Caso não possua, <a href=\"https://br.wordpress.org/plugins/woocommerce/\" title=\"Link Externo\" target=\"_blank\">faça o download</a> e instale em seu site.\n\nO Plugin da Gerencianet para WooCommerce pode ser instalado de duas formas diferentes:\n\n1. **Instalação Automática:** o plugin é instalado diretamente do repositório oficial do WordPress através da interface administrativa da loja;\n\n2. **Instalação Manual:** os arquivos do plugin devem ser enviados manualmente para o servidor de hospedagem via FTP.\n\n\n### Instalação Automática:\n<hr>\n\nPara instalar o plugin automaticamente através do repositório oficial do WordPress, é necessário seguir os passos:\n\n1. Acesse a interface administrativa da sua loja\n\n2. No menu de navegação, acesse <code>Plugins > Adicionar Novo</code>\n\n3. Procure por **Gerencianet** e acesse o plugin “**Woo Gerencianet Oficial**”. Verifique se o desenvolvedor é a **Gerencianet**, conforme figura abaixo.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/vG37hbTYSyiX03QjAByF_62169b2d41ad4e43b2a559d2896e930b.png\",\n        \"62169b2d41ad4e43b2a559d2896e930b.png\",\n        \"686\",\n        \"429\",\n        \"\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n4. Clique em <code>Instalar Agora</code> e depois do processo clique em <code>Ativar Plugin</code>.\n\n\n### Instalação Manual:\n<hr>\n\nPara instalar o plugin manualmente, o lojista deverá realizar o download dos arquivos do plugin e enviar para através de FTP para sua loja.\n\n1. O primeiro passo é realizar o download dos arquivos da última versão do plugin através do <a href=\"https://wordpress.org/plugins/woo-gerencianet-official/\" target=\"_blank\">repositório oficial do WordPress</a> ou através do <a href=\"https://github.com/gerencianet/gn-api-woocommerce/\" target=\"_blank\">repositório da Gerencianet no GitHub</a>;\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ONV2l70vQ3m4k3TdD1UI_13d9c17ace1343839577cfecfc05a53c.png\",\n        \"13d9c17ace1343839577cfecfc05a53c.png\",\n        \"678\",\n        \"574\",\n        \"#e15e25\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n2. Depois de baixar os arquivos, o lojista deve acessar a interface administrativa da loja e, no menu de navegação, acessar o link <code>Plugins > Adicionar novo > Fazer o upload do plugin</code> e enviar o arquivo **woo-gerencianet-oficial.zip**.\n\n3. Caso o lojista prefira, os arquivos podem ser descompactados e enviados diretamente via FTP para a pasta de plugins da instalação do WordPress (dentro de <code>/wp-content/plugins</code>).\n\n4. Após a instalação, clique em <code>Ativar o Plugin</code>.\n\n\n## 3. Configurações do Plugin Gerencianet para WooCommerce (WordPress)\n<hr>\n\nAntes de começar a receber pagamentos com a Gerencianet, o lojista deverá realizar a configuração do plugin, com suas credenciais e preferências.\n\n1. Para iniciar a configuração do plugin, no painel administrativo da loja, acesse: <code>WooCommerce > Configurações > Finalizar Compra > Gerencianet</code> e confira a tela de configurações do módulo Gerencianet:\n\n<img src=\"https://files.readme.io/8e6cf8e-wordpress-gerencianet.png\" height=\"1300\" width=\"600\">\n\n<br>\n\n2. Configure as credenciais de sua aplicação Gerencianet. Para criar uma nova aplicação, entre em sua conta Gerencianet e acesse o seguinte caminho: <code>API > Minhas Aplicações > Nova aplicação</code>. Insira as credenciais <code>Client_Id</code> e <code>Client_Secret</code> nos respectivos campos de configuração do plugin, de acordo com o ambiente que for utilizar (desenvolvimento ou produção).\n\nEssas credenciais (\"Client_Id\" e \"Client_Secret\") 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/QODtNklhRuCFexeiKjE8_a6505751b5744854a4b0b1431182ae0d.png\",\n        \"a6505751b5744854a4b0b1431182ae0d.png\",\n        \"1024\",\n        \"379\",\n        \"#f43a1a\",\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/mG5Ek8OpQ0GN381fvof9_e229cf290f7641b99711fb3045aad0bf.png\",\n        \"e229cf290f7641b99711fb3045aad0bf.png\",\n        \"1026\",\n        \"377\",\n        \"\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n<br />\n3. Insira o **Payee Code** (identificador da conta) Gerencianet. O identificar da sua conta pode ser encontrado conforme imagem a seguir:\n\n### Identificador da conta\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/utJbp2ZnQEKarGTFxpaC_285e10876778417a98a4a4df1908051b.png\",\n        \"285e10876778417a98a4a4df1908051b.png\",\n        \"766\",\n        \"587\",\n        \"#f4481e\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n4. Opte se deseja utilizar a funcionalidade de *“Checkout em um passo”*. Essa opção permite que o cliente insira todos os dados de pagamento como, por exemplo, os dados de cartão crédito, sem a necessidade de ser redirecionado para um outra página. Essa opção pode não ser compatível com todos temas, portanto recomenda-se que seja testado antes de utilizar em produção.\n\n5. Configure as opções de pagamento que deseja receber: **Boleto** e/ou **Cartão de Crédito**.\n\n6. Defina se deseja aplicar desconto para pagamentos com Boleto e insira o número de dias corridos para vencimento.\n\n7. Escolha se deseja que o plugin atualize os status dos pedidos da loja automaticamente, de acordo com as notificações de alteração do status da cobrança Gerencianet.\n\n8. Configure se deseja ativar o <code>Sandbox</code> (ambiente de testes) e <code>Debug</code>.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"Quando estiver em ambiente de produção, use o \\\"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]\n9. Recomendamos que antes de disponibilizar pagamentos pela Gerencianet, o lojista realize testes de cobrança com o sandbox (ambiente de testes) ativo para verificar se o procedimento de pagamento está acontecendo conforme esperado.\n\n10. Clique em <code>Salvar alterações</code> e a partir de agora seu plugin da Gerencianet estará pronto para receber pagamentos.\n\n\n## 4. Funcionamento do Plugin Gerencianet para WooCommerce (WordPress)\n<hr>\n\nApós ser habilitado, o plugin 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 uma página</code>, a página que o cliente digitará seus dados de pagamento será diferente.\n\nSe a opção de <code>Checkout em uma página</code> estiver ativa, seu cliente irá preencher os dados de pagamento na mesma tela de <code>Finalizar compra</code>, conforme as figuras abaixo:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/g2sySp1kTIqDr7dt949o_eba06367c3344843933447c965efeb5f.png\",\n        \"eba06367c3344843933447c965efeb5f.png\",\n        \"1021\",\n        \"614\",\n        \"#a1628b\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2ZazsvpDTRCb4qMOqFl1_5d21ebac657e4d02b04704f408560fd2.png\",\n        \"5d21ebac657e4d02b04704f408560fd2.png\",\n        \"787\",\n        \"825\",\n        \"\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\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 uma página</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>Finalizar Compra</code> será redirecionado para outra página para prosseguir com o pagamento:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/h6WZ0QylQM2KkfLFtIdT_06cb661ca092485d82950a393b901d69.png\",\n        \"06cb661ca092485d82950a393b901d69.png\",\n        \"1122\",\n        \"265\",\n        \"#a46393\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nClicando em <code>Finalizar Compra</code> o cliente será redirecionado para outra página, ainda dentro da loja, onde optará pelas opções de pagamento da Gerencianet, conforme figura abaixo:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/XPkQTepShu53uQA76uEF_a86230932b6b4ba38e6cae76aca77312.png\",\n        \"a86230932b6b4ba38e6cae76aca77312.png\",\n        \"1125\",\n        \"505\",\n        \"#c4975a\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nAmbas as telas de pagamento podem sofrer mudanças de acordo com o tema utilizado na loja.\n\n<br />\n## 5. Dúvidas Frequentes\n<hr>\n\n**1) É obrigatório possuir SSL em minha loja para aceitar pagamentos com o plugin?**\n\nPara que o módulo da Gerencianet para WooCommerce 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 plugin da Gerencianet para WooCommerce 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 plugin?**\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 plugin 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 plugin. 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 *“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 plugin em <code>WooCommerce > Configurações > Finalizar Compra > Gerencianet</code> e desmarque a opção <code>SandBox > Habilitar Sandbox Gerencianet (Ambiente de testes)</code>.\n\n<br />\n**7) Onde posso acompanhar as transações geradas pelo plugin?**\n\nAs transações geradas através do plugin 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**8) Quando tento realizar um pagamento recebo a mensagem *“Ocorreu um erro ao tentar realizar a sua requisição. Entre em contato com o proprietário da loja.”***\n\nEssa mensagem de erro pode ser exibida no momento da finalização da compra por diversos fatores. Neste caso, o primeiro passo é verificar as credenciais da sua aplicação. Se estiverem corretas, entre em contato com a Gerencianet informando o problema.\n\n<br />\n**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.\n\n<br />\n**10) Instalei o plugin e minha loja está apresentando um erro ou não abre. O que fazer?**\n\nQuando ocorrer algum problema depois de instalar o plugin da Gerencianet para WooCommerce, provavelmente os requisitos mínimos ou compatibilidade não foram respeitados. Para corrigir esse problema, pode ser necessário remover o plugin. O plugin pode ser removido pelo ambiente administrativo da loja. Se isso não for possível, será necessário realizar uma intervenção manual diretamente nos arquivos do servidor via FTP, removendo a pasta **woo-gerencianet-offical** do diretório **“plugins”** do WordPress. Para maiores informações, entre em contato com nossa equipe técnica.\n\n<br />\n## 6. Suporte e Sugestões\n<hr>\n\nSua sugestão de novas ideias e implementações para o plugin da Gerencianet para WooCommerce é 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 > WordPress (WooCommerce)\"*","slug":"wordpress-woocommerce","type":"basic","title":"WordPress (WooCommerce)"}

WordPress (WooCommerce)

Você está em: *"Módulos > WordPress (WooCommerce)"*

**Módulo de Integração Gerencianet para WooCommerce Oficial - Versão 0.5.3** O módulo Gerencianet para WordPress (WooCommerce) permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. Compatível com as versões <span class="label label-default">2.2.x</span> <span class="label label-default">2.3.x</span> <span class="label label-default">2.4.x</span> <span class="label label-default">2.5.x</span> e <span class="label label-default">2.6.x</span> do WooCommerce. Este é o **Módulo Oficial de integração fornecido pela Gerencianet para WooCommerce**. Com ele, o proprietário da loja pode optar por receber pagamentos por boleto bancário e/ou cartão de crédito. Todo processo é realizado por meio do checkout transparente. Com isso, o comprador não precisa sair do site da loja para efetuar o pagamento. O módulo é compatível com o plugin <a href="http://wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/" target="_blank">WooCommerce Extra Checkout Fields for Brazil</a>. Com esse plugin instalado, algumas informações como CPF, número do endereço e bairro não serão solicitados no momento do pagamento. [block:callout] { "type": "warning", "title": "ATENÇÃO", "body": "Antes de instalar o plugin da Gerencianet para WooCommerce, verifique os requisitos e compatibilidade. Caso sua loja esteja em produção, indicamos que realize um backup antes de iniciar o processo de instalação do plugin." } [/block] ## Índice <hr> Vá direto ao ponto ­- utilize o índice abaixo e veja diretamente o que você precisa: 1. [Requisitos](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-1-requisitos) 2. [Instalação do Plugin Gerencianet para WooCommerce (WordPress)](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-2-instala-o-do-plugin-gerencianet-para-woocommerce-wordpress-) 3. [Configurações do Plugin Gerencianet para WooCommerce (WordPress)](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-3-configura-es-do-plugin-gerencianet-para-woocommerce-wordpress-) 4. [Funcionamento do Plugin Gerencianet para WooCommerce (WordPress)](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-4-funcionamento-do-plugin-gerencianet-para-woocommerce-wordpress-) 5. [Dúvidas Frequentes](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-5-d-vidas-frequentes) 6. [Suporte e Sugestões](https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-6-suporte-e-sugest-es) ## 1. Requisitos <hr> - Versão mínima do PHP: <code>5.4.0</code> - Versão mínima do WooCommerce: <code>2.2.x</code> - Versão mínima do WordPress: <code>4.1</code> ## 2. Instalação do Plugin Gerencianet para WooCommerce (WordPress) <hr> Antes de instalar o plugin, certifique-se que tenha instalado em sua página WordPress o plugin da loja virtual WooCommerce. Caso não possua, <a href="https://br.wordpress.org/plugins/woocommerce/" title="Link Externo" target="_blank">faça o download</a> e instale em seu site. O Plugin da Gerencianet para WooCommerce pode ser instalado de duas formas diferentes: 1. **Instalação Automática:** o plugin é instalado diretamente do repositório oficial do WordPress através da interface administrativa da loja; 2. **Instalação Manual:** os arquivos do plugin devem ser enviados manualmente para o servidor de hospedagem via FTP. ### Instalação Automática: <hr> Para instalar o plugin automaticamente através do repositório oficial do WordPress, é necessário seguir os passos: 1. Acesse a interface administrativa da sua loja 2. No menu de navegação, acesse <code>Plugins > Adicionar Novo</code> 3. Procure por **Gerencianet** e acesse o plugin “**Woo Gerencianet Oficial**”. Verifique se o desenvolvedor é a **Gerencianet**, conforme figura abaixo. [block:image] { "images": [ { "image": [ "https://files.readme.io/vG37hbTYSyiX03QjAByF_62169b2d41ad4e43b2a559d2896e930b.png", "62169b2d41ad4e43b2a559d2896e930b.png", "686", "429", "", "" ] } ] } [/block] 4. Clique em <code>Instalar Agora</code> e depois do processo clique em <code>Ativar Plugin</code>. ### Instalação Manual: <hr> Para instalar o plugin manualmente, o lojista deverá realizar o download dos arquivos do plugin e enviar para através de FTP para sua loja. 1. O primeiro passo é realizar o download dos arquivos da última versão do plugin através do <a href="https://wordpress.org/plugins/woo-gerencianet-official/" target="_blank">repositório oficial do WordPress</a> ou através do <a href="https://github.com/gerencianet/gn-api-woocommerce/" target="_blank">repositório da Gerencianet no GitHub</a>; [block:image] { "images": [ { "image": [ "https://files.readme.io/ONV2l70vQ3m4k3TdD1UI_13d9c17ace1343839577cfecfc05a53c.png", "13d9c17ace1343839577cfecfc05a53c.png", "678", "574", "#e15e25", "" ] } ] } [/block] 2. Depois de baixar os arquivos, o lojista deve acessar a interface administrativa da loja e, no menu de navegação, acessar o link <code>Plugins > Adicionar novo > Fazer o upload do plugin</code> e enviar o arquivo **woo-gerencianet-oficial.zip**. 3. Caso o lojista prefira, os arquivos podem ser descompactados e enviados diretamente via FTP para a pasta de plugins da instalação do WordPress (dentro de <code>/wp-content/plugins</code>). 4. Após a instalação, clique em <code>Ativar o Plugin</code>. ## 3. Configurações do Plugin Gerencianet para WooCommerce (WordPress) <hr> Antes de começar a receber pagamentos com a Gerencianet, o lojista deverá realizar a configuração do plugin, com suas credenciais e preferências. 1. Para iniciar a configuração do plugin, no painel administrativo da loja, acesse: <code>WooCommerce > Configurações > Finalizar Compra > Gerencianet</code> e confira a tela de configurações do módulo Gerencianet: <img src="https://files.readme.io/8e6cf8e-wordpress-gerencianet.png" height="1300" width="600"> <br> 2. Configure as credenciais de sua aplicação Gerencianet. Para criar uma nova aplicação, entre em sua conta Gerencianet e acesse o seguinte caminho: <code>API > Minhas Aplicações > Nova aplicação</code>. Insira as credenciais <code>Client_Id</code> e <code>Client_Secret</code> nos respectivos campos de configuração do plugin, de acordo com o ambiente que for utilizar (desenvolvimento ou produção). Essas credenciais ("Client_Id" e "Client_Secret") 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/QODtNklhRuCFexeiKjE8_a6505751b5744854a4b0b1431182ae0d.png", "a6505751b5744854a4b0b1431182ae0d.png", "1024", "379", "#f43a1a", "" ] } ] } [/block] ### Ambiente de Desenvolvimento (sandbox, para testar sua integração) [block:image] { "images": [ { "image": [ "https://files.readme.io/mG5Ek8OpQ0GN381fvof9_e229cf290f7641b99711fb3045aad0bf.png", "e229cf290f7641b99711fb3045aad0bf.png", "1026", "377", "", "" ] } ] } [/block] <br /> 3. Insira o **Payee Code** (identificador da conta) Gerencianet. O identificar da sua conta pode ser encontrado conforme imagem a seguir: ### Identificador da conta [block:image] { "images": [ { "image": [ "https://files.readme.io/utJbp2ZnQEKarGTFxpaC_285e10876778417a98a4a4df1908051b.png", "285e10876778417a98a4a4df1908051b.png", "766", "587", "#f4481e", "" ] } ] } [/block] 4. Opte se deseja utilizar a funcionalidade de *“Checkout em um passo”*. Essa opção permite que o cliente insira todos os dados de pagamento como, por exemplo, os dados de cartão crédito, sem a necessidade de ser redirecionado para um outra página. Essa opção pode não ser compatível com todos temas, portanto recomenda-se que seja testado antes de utilizar em produção. 5. Configure as opções de pagamento que deseja receber: **Boleto** e/ou **Cartão de Crédito**. 6. Defina se deseja aplicar desconto para pagamentos com Boleto e insira o número de dias corridos para vencimento. 7. Escolha se deseja que o plugin atualize os status dos pedidos da loja automaticamente, de acordo com as notificações de alteração do status da cobrança Gerencianet. 8. Configure se deseja ativar o <code>Sandbox</code> (ambiente de testes) e <code>Debug</code>. [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "Quando estiver em ambiente de produção, use o \"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] 9. Recomendamos que antes de disponibilizar pagamentos pela Gerencianet, o lojista realize testes de cobrança com o sandbox (ambiente de testes) ativo para verificar se o procedimento de pagamento está acontecendo conforme esperado. 10. Clique em <code>Salvar alterações</code> e a partir de agora seu plugin da Gerencianet estará pronto para receber pagamentos. ## 4. Funcionamento do Plugin Gerencianet para WooCommerce (WordPress) <hr> Após ser habilitado, o plugin 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 uma página</code>, a página que o cliente digitará seus dados de pagamento será diferente. Se a opção de <code>Checkout em uma página</code> estiver ativa, seu cliente irá preencher os dados de pagamento na mesma tela de <code>Finalizar compra</code>, conforme as figuras abaixo: [block:image] { "images": [ { "image": [ "https://files.readme.io/g2sySp1kTIqDr7dt949o_eba06367c3344843933447c965efeb5f.png", "eba06367c3344843933447c965efeb5f.png", "1021", "614", "#a1628b", "" ] } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/2ZazsvpDTRCb4qMOqFl1_5d21ebac657e4d02b04704f408560fd2.png", "5d21ebac657e4d02b04704f408560fd2.png", "787", "825", "", "" ] } ] } [/block] 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 uma página</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>Finalizar Compra</code> será redirecionado para outra página para prosseguir com o pagamento: [block:image] { "images": [ { "image": [ "https://files.readme.io/h6WZ0QylQM2KkfLFtIdT_06cb661ca092485d82950a393b901d69.png", "06cb661ca092485d82950a393b901d69.png", "1122", "265", "#a46393", "" ] } ] } [/block] Clicando em <code>Finalizar Compra</code> o cliente será redirecionado para outra página, ainda dentro da loja, onde optará pelas opções de pagamento da Gerencianet, conforme figura abaixo: [block:image] { "images": [ { "image": [ "https://files.readme.io/XPkQTepShu53uQA76uEF_a86230932b6b4ba38e6cae76aca77312.png", "a86230932b6b4ba38e6cae76aca77312.png", "1125", "505", "#c4975a", "" ] } ] } [/block] Ambas as telas de pagamento podem sofrer mudanças de acordo com o tema utilizado na loja. <br /> ## 5. Dúvidas Frequentes <hr> **1) É obrigatório possuir SSL em minha loja para aceitar pagamentos com o plugin?** Para que o módulo da Gerencianet para WooCommerce 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 plugin da Gerencianet para WooCommerce 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 plugin?** 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 plugin 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 plugin. 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 *“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 plugin em <code>WooCommerce > Configurações > Finalizar Compra > Gerencianet</code> e desmarque a opção <code>SandBox > Habilitar Sandbox Gerencianet (Ambiente de testes)</code>. <br /> **7) Onde posso acompanhar as transações geradas pelo plugin?** As transações geradas através do plugin 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 /> **8) Quando tento realizar um pagamento recebo a mensagem *“Ocorreu um erro ao tentar realizar a sua requisição. Entre em contato com o proprietário da loja.”*** Essa mensagem de erro pode ser exibida no momento da finalização da compra por diversos fatores. Neste caso, o primeiro passo é verificar as credenciais da sua aplicação. Se estiverem corretas, entre em contato com a Gerencianet informando o problema. <br /> **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. <br /> **10) Instalei o plugin e minha loja está apresentando um erro ou não abre. O que fazer?** Quando ocorrer algum problema depois de instalar o plugin da Gerencianet para WooCommerce, provavelmente os requisitos mínimos ou compatibilidade não foram respeitados. Para corrigir esse problema, pode ser necessário remover o plugin. O plugin pode ser removido pelo ambiente administrativo da loja. Se isso não for possível, será necessário realizar uma intervenção manual diretamente nos arquivos do servidor via FTP, removendo a pasta **woo-gerencianet-offical** do diretório **“plugins”** do WordPress. Para maiores informações, entre em contato com nossa equipe técnica. <br /> ## 6. Suporte e Sugestões <hr> Sua sugestão de novas ideias e implementações para o plugin da Gerencianet para WooCommerce é 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>.