{"_id":"576030dfc811102000cef30a","parentDoc":null,"__v":69,"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","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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-14T16:29:19.220Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"**Módulo de Integração Gerencianet para PrestaShop - Versão 0.2.2**\n\nO módulo Gerencianet para Prestashop permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. Compatível com as versões do PrestaShop a partir de <span class=\"label label-default\">1.6.0</span>.\n\nEste é o Módulo de integração fornecido pela <a target=\"blank\" href=\"https://gerencianet.com.br\">Gerencianet </a>para PrestaShop. 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\n\n# 1. Requisitos\n\n- Versão mínima do PHP: <code>5.4.0</code>\n- Versão mínima do PrestaShop: <code>1.6.x</code>\n\n<br>\n\n<hr>\n\n# 2. Instalação do Módulo\n\nO módulo da Gerencianet para PrestaShop pode ser instalado de duas formas diferentes:\n\n1. *[Instalação Automática:](https://dev.gerencianet.com.br/docs/prestashop#section-instala-o-autom-tica)* utilizando o arquivo de instalação do módulo compactado através da ferramenta de adicionar novos Módulos do PrestaShop;\n\n2. *[Instalação Manual:](https://dev.gerencianet.com.br/docs/prestashop#section-instala-o-manual)* os arquivos do módulo devem ser enviados manualmente para o servidor de hospedagem via FTP.\n\n\n## Instalação Automática\n\n1. Faça o [download da última versão do módulo](https://github.com/gerencianet/gn-api-prestashop/raw/master/auto/gerencianet.zip) (arquivo \"**gerencianet.zip**\");\n\n2. Acesse a administração da sua loja, acesse <code>Módulos > Adicione um novo Módulo</code> e envie o arquivo \"**gerencianet.zip**\" que você acabou de baixar;\n\n3. Depois de enviar o módulo para sua loja, clica em <code>Instalar</code> e aguarde a finalização do processo.\n\n<img src=\"https://files.readme.io/gw9slIGgRP6Gby3J04UR_instalacao.png\" alt=\"Modulo Prestashop\">\n\n4. Configure o módulo em <code>Módulos > Gerencianet > Configurar</code> e comece a receber pagamentos.\n\n\n## Instalação Manual\n\n1. Faça o [download da última versão do módulo](https://github.com/gerencianet/gn-api-prestashop/raw/master/auto/gerencianet.zip) (arquivo \"**gerencianet.zip**\") e extraia seu conteúdo ou realize o <a href=\"https://github.com/gerencianet/gn-api-prestashop/tree/master/manual/gerencianet\" target=\"_blank\">download</a> da última versão descompactada (pasta <code>/manual</code>);\n\n2. Acesse a loja via FTP e envie toda a pasta <code>gerencianet</code> descompactada para a pasta de destino <code>modules</code> que se encontra na raiz dos arquivos da loja no servidor;\n\n3. Acesse a administração da loja e acesse <code>Módulos</code>. Procure pelo módulo da Gerencianet na lista, clique em <code>Instalar</code> e aguarde a finalização do processo;\n\n4. Configure o módulo em <code>Módulos > Gerencianet > Configurar</code> e comece a receber pagamentos.\n\n<br>\n\n<hr>\n\n# 3. Configurações do Plugin Gerencianet para PrestaShop\n\nPara configurar o Módulo da Gerencianet para Prestashop, o lojista deverá acessar a interface administrativa da loja virtual e, no menu principal, acessar o opção <code>Módulos</code>. Procure pelo módulo da Gerencianet na lista que será exibida e depois clique em <code>Configurar</code>, conforme imagem abaixo:\n\n<img src=\"https://files.readme.io/bzmdX57Q32G2Drn3Uu2n_modulo.png\" alt=\"Configurações do Plugin Gerencianet para PrestaShop\">\n\n<br />\nAo entrar na configuração do módulo, a seguinte interface será exibida:\n\n<img src=\"https://files.readme.io/YJQav2QORqsVcC4tvCq7_configuracao1.png\" alt=\"Configurações do Plugin Gerencianet para PrestaShop\">\n\nAs credencias e preferências deverão ser configuradas através das duas abas disponibilizadas:\n\n- [Configurações Gerais](https://dev.gerencianet.com.br/docs/prestashop#section-configura-es-gerais)\n- [Credenciais](https://dev.gerencianet.com.br/docs/prestashop#section-credenciais)\n\n\n## Configurações Gerais\n\n<img src=\"https://files.readme.io/bcrzCJqYTvGt0EOzsnU3_configuracao2.png\" alt=\"\">\n\nNesta aba, as seguintes propriedades podem ser configuradas:\n\n1. **Modo:** Configure se deseja ativar o módulo em Desenvolvimento (ambiente de testes) ou Produção (cobrança real);\n\n2. **Opções de Pagamento:** Configure as opções de pagamento que deseja receber: Boleto e/ou Cartão de Crédito.\n\n3. **Dias para vencimento do Boleto:** Configure o número de dias corridos para vencimento do Boleto.\n\n4. **Desconto para pagamento no boleto(%):** Defina se deseja aplicar desconto para pagamentos com Boleto.\n\n5. **Atualizar status dos pedidos PrestaShop automaticamente:** Configure se deseja que o módulo atualize os status dos pedidos da loja automaticamente de acordo com as notificações da Gerencianet.\n\n6. **Status:** Configure se o Módulo estará disponível para os clientes.\n\n\n## Credenciais\n\nNesta aba é necessário informar as credenciais de sua aplicação, isto é, o \"Client_Id\" e \"Client_Secret\" (veja onde localizar, de acordo com o ambiente: <a href=\"http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png\" target=\"_blank\">desenvolvimento</a> e <a href=\"http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png\" target=\"_blank\">produção</a>) da sua aplicação e o <a href=\"http://image.prntscr.com/image/cabe13e1e5b64449b942cf31139150ba.png\" target=\"_blank\">identificador da conta</a> obtidos na aplicação criada na 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\n<img src=\"https://files.readme.io/6ZWrELoRrOoRStdkTA9p_configuracao3.png\" alt=\"\">\n\n1. O lojista deverá inserir as credenciais de aplicação Gerencianet nos respectivos campos. Para ter acesso a essas credenciais, você deverá criar uma nova aplicação Gerencianet ou utilizar uma já existente. Para criar uma aplicação, entre em sua conta Gerencianet, acesse <code>API > Minhas Aplicações > Nova aplicação</code>. Escolha um nome e crie a nova aplicação. Agora já já terá acesso às credenciais da aplicação. Copie-as e insira nos respectivos campos da aba \"Credenciais\" em sua loja (Client_Id e Client_Secret de <a href=\"http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png\" target=\"_blank\">produção</a> e <a href=\"http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png\" target=\"_blank\">desenvolvimento</a>).\n\n2. Insira o <a href=\"http://image.prntscr.com/image/cabe13e1e5b64449b942cf31139150ba.png\" target=\"_blank\">identificador da conta</a> 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\n3. Clique em <code>Salvar</code> e agora sua loja virtual já está pronta para receber pagamentos pela Gerencianet.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"Quando estiver em ambiente de produção, use a Client_Id e Client_Secret da aba \\\"Produção\\\" e a opção sandbox desativada. Se estiver em desenvolvimento, use a Client_Id e Client_Secret da aba \\\"Desenvolvimento\\\" com a opção sandbox habilitada. Se não for realizado dessa forma, uma possível mensagem de \\\"unauthorized\\\" (sem autorização) poderá ser retornada.\"\n}\n[/block]\n<br>\n\n<hr>\n\n# 4. Funcionamento do Módulo\n\nApós ser habilitado, o módulo já estará disponível como uma opção de pagamento.\n\nDependendo da sua configuração de habilitar ou não a opção de <code>Pagamento em um passo</code>, a página que o cliente digitará seus dados de pagamento será diferente.\n\nSe a opção de <code>Pagamento em um passo</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/5euwivnkQqaNFoHZnRu8_pag1.png\" alt=\"\">\n\n<img src=\"https://files.readme.io/ANbX9Kp9SUCHilkjzpbe_pag2.png\" alt=\"\">\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>Pagamento em um passo</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>Confirmar Pedido</code> será redirecionado para outra página para prosseguir com o pagamento, onde optará pelas opções de pagamento da Gerencianet, conforme figura abaixo:\n\n<img src=\"https://files.readme.io/ijueYHj0SJiI4jnZKhrM_pag_b1.png\" alt=\"\">\n\nAmbas as telas de pagamento podem sofrer mudanças de acordo com o tema utilizado na loja.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"OBSERVAÇÃO\",\n  \"body\": \"Se algum dos campos obrigatórios para o realizar o pagamento não for preenchido corretamente, ele será cobrado novamente no formulário de pagamento. Para **Boleto Bancário**, os campos obrigatórios são: <strong>Nome, E-mail, CPF e Telefone</strong>. Para **Cartão de Crédito**, os campos obrigatórios são: <strong>Nome, E-mail, CPF, data de nascimento, Telefone, Endereço, Número, Bairro, CEP, Cidade e Estado.</strong>\"\n}\n[/block]\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 módulo?**\n\nPara que o módulo da Gerencianet para PrestaShop 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\ninstalado 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<br>\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 módulo da Gerencianet para PrestaShop 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<br>\n\n**5.3. É possível utilizar as funcionalidades de MarketPlace ou Assinaturas com o módulo?**\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\">https://dev.gerencianet.com.br/docs/changelog</a>\n<br>\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<br>\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<br>\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 módulo em \"Módulos\" > \"Gerencianet\" > \"Configurar\" e desmarque a opção “SandBox” > “Habilitar Sandbox Gerencianet (Ambiente de testes)”.\n<br>\n\n**5.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 “API” > “Minhas Aplicações” > “Sua Aplicação”. Neste ambiente você poderá acompanhar todas as transações e suas respectivas situações.\n<br>\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\">Interpretando Erros da API</a>\".\n<br>\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 se é possível alterar as informações que deseja.\n<br>\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 módulo da Gerencianet para PrestaShop é 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 e Plugins > PrestaShop\"*","slug":"prestashop","type":"basic","title":"PrestaShop"}

PrestaShop

Você está em: *"Módulos e Plugins > PrestaShop"*

**Módulo de Integração Gerencianet para PrestaShop - Versão 0.2.2** O módulo Gerencianet para Prestashop permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. Compatível com as versões do PrestaShop a partir de <span class="label label-default">1.6.0</span>. Este é o Módulo de integração fornecido pela <a target="blank" href="https://gerencianet.com.br">Gerencianet </a>para PrestaShop. 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. # 1. Requisitos - Versão mínima do PHP: <code>5.4.0</code> - Versão mínima do PrestaShop: <code>1.6.x</code> <br> <hr> # 2. Instalação do Módulo O módulo da Gerencianet para PrestaShop pode ser instalado de duas formas diferentes: 1. *[Instalação Automática:](https://dev.gerencianet.com.br/docs/prestashop#section-instala-o-autom-tica)* utilizando o arquivo de instalação do módulo compactado através da ferramenta de adicionar novos Módulos do PrestaShop; 2. *[Instalação Manual:](https://dev.gerencianet.com.br/docs/prestashop#section-instala-o-manual)* os arquivos do módulo devem ser enviados manualmente para o servidor de hospedagem via FTP. ## Instalação Automática 1. Faça o [download da última versão do módulo](https://github.com/gerencianet/gn-api-prestashop/raw/master/auto/gerencianet.zip) (arquivo "**gerencianet.zip**"); 2. Acesse a administração da sua loja, acesse <code>Módulos > Adicione um novo Módulo</code> e envie o arquivo "**gerencianet.zip**" que você acabou de baixar; 3. Depois de enviar o módulo para sua loja, clica em <code>Instalar</code> e aguarde a finalização do processo. <img src="https://files.readme.io/gw9slIGgRP6Gby3J04UR_instalacao.png" alt="Modulo Prestashop"> 4. Configure o módulo em <code>Módulos > Gerencianet > Configurar</code> e comece a receber pagamentos. ## Instalação Manual 1. Faça o [download da última versão do módulo](https://github.com/gerencianet/gn-api-prestashop/raw/master/auto/gerencianet.zip) (arquivo "**gerencianet.zip**") e extraia seu conteúdo ou realize o <a href="https://github.com/gerencianet/gn-api-prestashop/tree/master/manual/gerencianet" target="_blank">download</a> da última versão descompactada (pasta <code>/manual</code>); 2. Acesse a loja via FTP e envie toda a pasta <code>gerencianet</code> descompactada para a pasta de destino <code>modules</code> que se encontra na raiz dos arquivos da loja no servidor; 3. Acesse a administração da loja e acesse <code>Módulos</code>. Procure pelo módulo da Gerencianet na lista, clique em <code>Instalar</code> e aguarde a finalização do processo; 4. Configure o módulo em <code>Módulos > Gerencianet > Configurar</code> e comece a receber pagamentos. <br> <hr> # 3. Configurações do Plugin Gerencianet para PrestaShop Para configurar o Módulo da Gerencianet para Prestashop, o lojista deverá acessar a interface administrativa da loja virtual e, no menu principal, acessar o opção <code>Módulos</code>. Procure pelo módulo da Gerencianet na lista que será exibida e depois clique em <code>Configurar</code>, conforme imagem abaixo: <img src="https://files.readme.io/bzmdX57Q32G2Drn3Uu2n_modulo.png" alt="Configurações do Plugin Gerencianet para PrestaShop"> <br /> Ao entrar na configuração do módulo, a seguinte interface será exibida: <img src="https://files.readme.io/YJQav2QORqsVcC4tvCq7_configuracao1.png" alt="Configurações do Plugin Gerencianet para PrestaShop"> As credencias e preferências deverão ser configuradas através das duas abas disponibilizadas: - [Configurações Gerais](https://dev.gerencianet.com.br/docs/prestashop#section-configura-es-gerais) - [Credenciais](https://dev.gerencianet.com.br/docs/prestashop#section-credenciais) ## Configurações Gerais <img src="https://files.readme.io/bcrzCJqYTvGt0EOzsnU3_configuracao2.png" alt=""> Nesta aba, as seguintes propriedades podem ser configuradas: 1. **Modo:** Configure se deseja ativar o módulo em Desenvolvimento (ambiente de testes) ou Produção (cobrança real); 2. **Opções de Pagamento:** Configure as opções de pagamento que deseja receber: Boleto e/ou Cartão de Crédito. 3. **Dias para vencimento do Boleto:** Configure o número de dias corridos para vencimento do Boleto. 4. **Desconto para pagamento no boleto(%):** Defina se deseja aplicar desconto para pagamentos com Boleto. 5. **Atualizar status dos pedidos PrestaShop automaticamente:** Configure se deseja que o módulo atualize os status dos pedidos da loja automaticamente de acordo com as notificações da Gerencianet. 6. **Status:** Configure se o Módulo estará disponível para os clientes. ## Credenciais Nesta aba é necessário informar as credenciais de sua aplicação, isto é, o "Client_Id" e "Client_Secret" (veja onde localizar, de acordo com o ambiente: <a href="http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png" target="_blank">desenvolvimento</a> e <a href="http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png" target="_blank">produção</a>) da sua aplicação e o <a href="http://image.prntscr.com/image/cabe13e1e5b64449b942cf31139150ba.png" target="_blank">identificador da conta</a> obtidos na aplicação criada na 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>). <img src="https://files.readme.io/6ZWrELoRrOoRStdkTA9p_configuracao3.png" alt=""> 1. O lojista deverá inserir as credenciais de aplicação Gerencianet nos respectivos campos. Para ter acesso a essas credenciais, você deverá criar uma nova aplicação Gerencianet ou utilizar uma já existente. Para criar uma aplicação, entre em sua conta Gerencianet, acesse <code>API > Minhas Aplicações > Nova aplicação</code>. Escolha um nome e crie a nova aplicação. Agora já já terá acesso às credenciais da aplicação. Copie-as e insira nos respectivos campos da aba "Credenciais" em sua loja (Client_Id e Client_Secret de <a href="http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png" target="_blank">produção</a> e <a href="http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png" target="_blank">desenvolvimento</a>). 2. Insira o <a href="http://image.prntscr.com/image/cabe13e1e5b64449b942cf31139150ba.png" target="_blank">identificador da conta</a> 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>). 3. Clique em <code>Salvar</code> e agora sua loja virtual já está pronta para receber pagamentos pela Gerencianet. [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "Quando estiver em ambiente de produção, use a Client_Id e Client_Secret da aba \"Produção\" e a opção sandbox desativada. Se estiver em desenvolvimento, use a Client_Id e Client_Secret da aba \"Desenvolvimento\" com a opção sandbox habilitada. Se não for realizado dessa forma, uma possível mensagem de \"unauthorized\" (sem autorização) poderá ser retornada." } [/block] <br> <hr> # 4. Funcionamento do Módulo Após ser habilitado, o módulo 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>Pagamento em um passo</code>, a página que o cliente digitará seus dados de pagamento será diferente. Se a opção de <code>Pagamento em um passo</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/5euwivnkQqaNFoHZnRu8_pag1.png" alt=""> <img src="https://files.readme.io/ANbX9Kp9SUCHilkjzpbe_pag2.png" alt=""> 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>Pagamento em um passo</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>Confirmar Pedido</code> será redirecionado para outra página para prosseguir com o pagamento, onde optará pelas opções de pagamento da Gerencianet, conforme figura abaixo: <img src="https://files.readme.io/ijueYHj0SJiI4jnZKhrM_pag_b1.png" alt=""> Ambas as telas de pagamento podem sofrer mudanças de acordo com o tema utilizado na loja. [block:callout] { "type": "info", "title": "OBSERVAÇÃO", "body": "Se algum dos campos obrigatórios para o realizar o pagamento não for preenchido corretamente, ele será cobrado novamente no formulário de pagamento. Para **Boleto Bancário**, os campos obrigatórios são: <strong>Nome, E-mail, CPF e Telefone</strong>. Para **Cartão de Crédito**, os campos obrigatórios são: <strong>Nome, E-mail, CPF, data de nascimento, Telefone, Endereço, Número, Bairro, CEP, Cidade e Estado.</strong>" } [/block] <br> <hr> # 5. Dúvidas Frequentes **5.1. É obrigatório possuir SSL em minha loja para aceitar pagamentos com o módulo?** Para que o módulo da Gerencianet para PrestaShop 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> **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 módulo da Gerencianet para PrestaShop 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> **5.3. É possível utilizar as funcionalidades de MarketPlace ou Assinaturas com o módulo?** 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">https://dev.gerencianet.com.br/docs/changelog</a> <br> **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. <br> **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. <br> **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 módulo em "Módulos" > "Gerencianet" > "Configurar" e desmarque a opção “SandBox” > “Habilitar Sandbox Gerencianet (Ambiente de testes)”. <br> **5.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 “API” > “Minhas Aplicações” > “Sua Aplicação”. Neste ambiente você poderá acompanhar todas as transações e suas respectivas situações. <br> **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">Interpretando Erros da API</a>". <br> **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 se é possível alterar as informações que deseja. <br> <br> <hr> # 6. Suporte e Sugestões Sua sugestão de novas ideias e implementações para o módulo da Gerencianet para PrestaShop é 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>.