{"_id":"576030c84715f61700ae85ed","version":{"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","__v":30,"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"},"project":"575aeffae12cf20e002f306c","user":"57601a13af3e090e00108059","__v":67,"category":{"_id":"576030909b1a9a220067ca40","__v":0,"project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-06-14T16:28:00.991Z","from_sync":false,"order":11,"slug":"módulos","title":"Módulos e Plugins"},"parentDoc":null,"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.6.1**\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>, <span class=\"label label-default\">2.6.x</span> e <span class=\"label label-default\">3.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\" title=\"Link Externo\">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  \"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  \"title\": \"IMPORTANTE\"\n}\n[/block]\n# 1. Requisitos\n\n- Versão mínima do PHP: <code>5.5.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<br>\n\n<hr>\n\n# 2. Instalação do plugin Gerencianet para WooCommerce\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. <a href=\"https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-instala-o-autom-tica-\" title=\"Âncora Interna\"><em>Instalação Automática:</em></a> o plugin é instalado diretamente do repositório oficial do WordPress através da interface administrativa da loja;\n\n2. <a href=\"https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-instala-o-manual-\" title=\"Âncora Interna\"><em>Instalação Manual:</em></a> os arquivos do plugin devem ser enviados manualmente para o servidor de hospedagem via FTP.\n\n\n## Instalação Automática:\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\n<img src=\"https://files.readme.io/vG37hbTYSyiX03QjAByF_62169b2d41ad4e43b2a559d2896e930b.png\" alt=\"Instalar Plugin - Gerencioanet\">\n\n4. Clique em <code>Instalar Agora</code> e depois do processo clique em <code>Ativar Plugin</code>.\n\n\n## Instalação Manual:\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\" title=\"Link Externo\">repositório oficial do WordPress</a> ou através do <a href=\"https://github.com/gerencianet/gn-api-woocommerce/\" target=\"_blank\" title=\"Link Externo\">repositório da Gerencianet no GitHub</a>;\n\n<img src=\"https://files.readme.io/ONV2l70vQ3m4k3TdD1UI_13d9c17ace1343839577cfecfc05a53c.png\" alt=\"Instalacao Manual - Plugin Gerencianet\">\n\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<br>\n\n<hr>\n\n# 3. Configurações do plugin Gerencianet para WooCommerce\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<br>\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\n<br>\n\n<img src=\"https://files.readme.io/QODtNklhRuCFexeiKjE8_a6505751b5744854a4b0b1431182ae0d.png\" alt=\"Ambiente de Produção\">\n\n<br>\n\n## Ambiente de Desenvolvimento (sandbox, para testar sua integração)\n\n<br>\n\n<img src=\"https://files.readme.io/mG5Ek8OpQ0GN381fvof9_e229cf290f7641b99711fb3045aad0bf.png\" alt=\"Ambiente de Desenvolvimento\">\n\n<br />\n3. Insira seu \"Identificador da Conta\" Gerencianet. Confira onde localizá-lo, de acordo com o layout de sua plataforma (<a href=\"https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_n.png\" target=\"_blank\">opção 1</a> ou <a href=\"https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_p.png\" target=\"_blank\">opção 2</a>).\n\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<br>\n\n<hr>\n\n# 4. Funcionamento do plugin Gerencianet para WooCommerce\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\n<img src=\"https://files.readme.io/g2sySp1kTIqDr7dt949o_eba06367c3344843933447c965efeb5f.png\" alt=\"Formas de pagamento\">\n\n<img src=\"https://files.readme.io/2ZazsvpDTRCb4qMOqFl1_5d21ebac657e4d02b04704f408560fd2.png\" alt=\"Formas de pagamento\">\n\n<br>\n\nDesta forma, ao clicar em <code>Finalizar Compra</code>, os dados do cliente serão validados e, caso esteja tudo correto, a cobrança será gerada e a compra finalizada. O cliente então é redirecionado para a página de compra finalizada.\n\nCaso a opção de <code>Checkout em 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\n<img src=\"https://files.readme.io/h6WZ0QylQM2KkfLFtIdT_06cb661ca092485d82950a393b901d69.png\" alt=\"Formas de Pagamento\">\n\n<br>\n\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\n<img src=\"https://files.readme.io/XPkQTepShu53uQA76uEF_a86230932b6b4ba38e6cae76aca77312.png\" alt=\"Pagamento\">\n\n<br>\n\nAmbas as telas de pagamento podem sofrer mudanças de acordo com o tema utilizado na loja.\n\n<br>\n\n<hr>\n\n# 5. Dúvidas Frequentes\n\n## 5.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## 5.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## 5.3. É possível utilizar as funcionalidades de MarketPlace ou Assinaturas com o plugin?\n\nAinda não. Essa sugestão está registrada internamente, e caso este recurso seja incluído no módulo, será registrado no changelog de nossa API: <a href=\"https://dev.gerencianet.com.br/docs/changelog\" target=\"_blank\" title=\"Link Interno\">https://dev.gerencianet.com.br/docs/changelog</a>\n\n## 5.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, ou seja, o \"Client_Id\" e o \"Client_Secret\", além do \"identificador da conta\". Se estiverem corretas, entre em contato com a Gerencianet para que o problema seja analisado.\n\n## 5.5. Estou recebendo a mensagem *“Unauthorized”* ao tentar finalizar uma compra. O que fazer?\n\nEssa mensagem de erro está 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## 5.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## 5.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## 5.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, o próximo passo é você verificar, dentro de sua conta Gerencianet, quais são as informações que a API está retornando - para mais detalhes, consulte \"<a href=\"https://dev.gerencianet.com.br/docs/interpretando-erros-api\" target=\"_blank\" title=\"Link Interno\">Interpretando Erros da API</a>\".\n\n## 5.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## 5.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\n<hr>\n\n# 6. Suporte e Sugestões\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\" title=\"Link Externo\">Gerencianet</a>.","excerpt":"Você está em: *\"Módulos e Plugins > WordPress (WooCommerce)\"*","slug":"wordpress-woocommerce","type":"basic","title":"WordPress (WooCommerce)"}

WordPress (WooCommerce)

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

**Módulo de Integração Gerencianet para WooCommerce Oficial - Versão 0.6.1** 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>, <span class="label label-default">2.6.x</span> e <span class="label label-default">3.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" title="Link Externo">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", "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.", "title": "IMPORTANTE" } [/block] # 1. Requisitos - Versão mínima do PHP: <code>5.5.0</code> - Versão mínima do WooCommerce: <code>2.2.x</code> - Versão mínima do WordPress: <code>4.1</code> <br> <hr> # 2. Instalação do plugin Gerencianet para WooCommerce 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. <a href="https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-instala-o-autom-tica-" title="Âncora Interna"><em>Instalação Automática:</em></a> o plugin é instalado diretamente do repositório oficial do WordPress através da interface administrativa da loja; 2. <a href="https://dev.gerencianet.com.br/docs/wordpress-woocommerce#section-instala-o-manual-" title="Âncora Interna"><em>Instalação Manual:</em></a> os arquivos do plugin devem ser enviados manualmente para o servidor de hospedagem via FTP. ## Instalação Automática: 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. <img src="https://files.readme.io/vG37hbTYSyiX03QjAByF_62169b2d41ad4e43b2a559d2896e930b.png" alt="Instalar Plugin - Gerencioanet"> 4. Clique em <code>Instalar Agora</code> e depois do processo clique em <code>Ativar Plugin</code>. ## Instalação Manual: 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" title="Link Externo">repositório oficial do WordPress</a> ou através do <a href="https://github.com/gerencianet/gn-api-woocommerce/" target="_blank" title="Link Externo">repositório da Gerencianet no GitHub</a>; <img src="https://files.readme.io/ONV2l70vQ3m4k3TdD1UI_13d9c17ace1343839577cfecfc05a53c.png" alt="Instalacao Manual - Plugin Gerencianet"> 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>. <br> <hr> # 3. Configurações do plugin Gerencianet para WooCommerce 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: <br> <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) <br> <img src="https://files.readme.io/QODtNklhRuCFexeiKjE8_a6505751b5744854a4b0b1431182ae0d.png" alt="Ambiente de Produção"> <br> ## Ambiente de Desenvolvimento (sandbox, para testar sua integração) <br> <img src="https://files.readme.io/mG5Ek8OpQ0GN381fvof9_e229cf290f7641b99711fb3045aad0bf.png" alt="Ambiente de Desenvolvimento"> <br /> 3. Insira seu "Identificador da Conta" Gerencianet. Confira onde localizá-lo, de acordo com o layout de sua plataforma (<a href="https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_n.png" target="_blank">opção 1</a> ou <a href="https://gerencianet.com.br/wp-content/uploads/2017/10/payee_code_p.png" target="_blank">opção 2</a>). 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. <br> <hr> # 4. Funcionamento do plugin Gerencianet para WooCommerce 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: <img src="https://files.readme.io/g2sySp1kTIqDr7dt949o_eba06367c3344843933447c965efeb5f.png" alt="Formas de pagamento"> <img src="https://files.readme.io/2ZazsvpDTRCb4qMOqFl1_5d21ebac657e4d02b04704f408560fd2.png" alt="Formas de pagamento"> <br> 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: <img src="https://files.readme.io/h6WZ0QylQM2KkfLFtIdT_06cb661ca092485d82950a393b901d69.png" alt="Formas de Pagamento"> <br> 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: <img src="https://files.readme.io/XPkQTepShu53uQA76uEF_a86230932b6b4ba38e6cae76aca77312.png" alt="Pagamento"> <br> Ambas as telas de pagamento podem sofrer mudanças de acordo com o tema utilizado na loja. <br> <hr> # 5. Dúvidas Frequentes ## 5.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. ## 5.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. ## 5.3. É possível utilizar as funcionalidades de MarketPlace ou Assinaturas com o plugin? Ainda não. Essa sugestão está registrada internamente, e caso este recurso seja incluído no módulo, será registrado no changelog de nossa API: <a href="https://dev.gerencianet.com.br/docs/changelog" target="_blank" title="Link Interno">https://dev.gerencianet.com.br/docs/changelog</a> ## 5.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, ou seja, o "Client_Id" e o "Client_Secret", além do "identificador da conta". Se estiverem corretas, entre em contato com a Gerencianet para que o problema seja analisado. ## 5.5. Estou recebendo a mensagem *“Unauthorized”* ao tentar finalizar uma compra. O que fazer? Essa mensagem de erro está 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. ## 5.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>. ## 5.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. ## 5.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, o próximo passo é você verificar, dentro de sua conta Gerencianet, quais são as informações que a API está retornando - para mais detalhes, consulte "<a href="https://dev.gerencianet.com.br/docs/interpretando-erros-api" target="_blank" title="Link Interno">Interpretando Erros da API</a>". ## 5.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. ## 5.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> <hr> # 6. Suporte e Sugestões 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" title="Link Externo">Gerencianet</a>.