{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"PrestaShop","type":"basic","slug":"prestashop","excerpt":"Saiba onde, como baixar e instalar nosso módulo/plugin PrestaShop com as formas de pagamento:  boleto bancário, cartão de crédito e pix.","body":"**Módulo de Integração Gerencianet para PrestaShop - Versão 1.0.0**\n\nO módulo Gerencianet para Prestashop permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. Compatível com a versão <span class=\"label label-default\">1.7.x</span> do PrestaShop.\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, cartão de crédito e/ou Pix. 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[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Caso você tenha ativado o <a href=\\\"https://gerencianet.com.br/bolix/\\\" target=\\\"_blank\\\" title=\\\"página Bolix\\\">Bolix</a> em sua conta Gerencianet, as cobranças geradas pelo nosso módulo/plugin já vão vir com o pix no boleto.\\nMais detalhes sobre o Bolix e como ativá-lo <a href=\\\"https://dev.gerencianet.com.br/docs/bolix-boleto-carne\\\" target=\\\"_blank\\\" title=\\\"Saiba mais sobre o Bolix\\\">aqui</a>.\",\n  \"title\": \"Bolix\"\n}\n[/block]\n# 1. Requisitos\n\n- Versão do PHP: <code>7.x</code>\n- Versão do PrestaShop: <code>1.7.x</code>\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Os requisitos do sistema foram definidos de acordo com os nossos testes. Se seu sistema não se encaixa nos requisitos, não significa que o módulo não vai funcionar em seu PrestaShop, mas sim, que não testamos no mesmo ambiente. **Portanto, não garantimos o funcionamento deste módulo em ambientes diferentes dos citados acima.**\",\n  \"title\": \"IMPORTANTE\"\n}\n[/block]\n<br>\n<hr>\n\n# 2. Instalação do Módulo\n\nO módulo da Gerencianet para PrestaShop pode ser instalado de forma automática:\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\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/GerencianetPrestashop.zip) (arquivo \"**GerencianetPrestashop.zip**\");\n\n2. Acesse a administração da sua loja, em <code>Módulos > Gerenciador de Módulos > Enviar um módulo</code> e envie o arquivo \"**GerencianetPrestashop.zip**\" que você acabou de baixar;\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f948522-modulo.png\",\n        \"modulo.png\",\n        1890,\n        529,\n        \"#333\"\n      ],\n      \"caption\": \"Enviar o módulo\"\n    }\n  ]\n}\n[/block]\n3. Depois de enviar o módulo para sua loja, clique em <code>Configurar</code> e aguarde a finalização do processo.\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/10c32b8-instalacao.png\",\n        \"instalacao.png\",\n        682,\n        376,\n        \"#333\"\n      ],\n      \"caption\": \"Módulo instalado\"\n    }\n  ]\n}\n[/block]\n\n# 3. Configurações do Plugin Gerencianet para PrestaShop\n\nPara configurar o Módulo da Gerencianet para Prestashop, ao clicar em <code>Configurar</code>,  no passo anterior, automaticamente já redireciona para a tela de configuração. Ou então, o lojista deverá acessar a interface administrativa da loja virtual e, no menu principal, acessar a opção <code>Módulos > Gerenciador de 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[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/b4df559-configuracao.png\",\n        \"configuracao.png\",\n        1392,\n        144,\n        \"#333\"\n      ],\n      \"caption\": \"Configuração do Plugin\"\n    }\n  ]\n}\n[/block]\n<br />\nAo entrar nas configurações do módulo, a seguinte interface será exibida:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5b93c97-interface.png\",\n        \"interface.png\",\n        1689,\n        284,\n        \"#333\"\n      ],\n      \"caption\": \"Interface do Plugin Gerencianet\"\n    }\n  ]\n}\n[/block]\n## Credenciais\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4c00ffa-credenciais.png\",\n        \"credenciais.png\",\n        1678,\n        729,\n        \"#333\"\n      ],\n      \"caption\": \"Configurações das Credenciais e Ambiente\"\n    }\n  ]\n}\n[/block]\nNesta seção, é 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=\"https://gnetbr.com/SyxQGhQOI9\" target=\"_blank\">Produção</a> e <a href=\"https://gnetbr.com/SyebXcmBfO\" target=\"_blank\">Homologação</a> da sua aplicação e o <a href=\"https://gnetbr.com/HkxOIXQd8q\" target=\"_blank\">Código Identificador da conta</a> obtidos na aplicação criada na Gerencianet.\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=\"https://gnetbr.com/SyxQGhQOI9\" target=\"_blank\">Produção</a> e <a href=\"https://gnetbr.com/SyebXcmBfO\" target=\"_blank\">Homologação</a>).\n\n2. Insira o <a href=\"https://gnetbr.com/HkxOIXQd8q\" target=\"_blank\">código identificador da conta</a> Gerencianet.\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"ATENÇÃO\",\n  \"body\": \"Importante salientar que **os boletos gerados em sandbox não são válidos e não podem ser pagos**, possuem a linha digitável \\\"zerada\\\" e uma marca d'água ao fundo informando ser um boleto de teste.\\n\\n**Os pagamentos de cobranças de sandbox utilizando cartão de crédito são fictícios, mesmo se utilizar um cartão \\\"real\\\".** Todos os pagamentos de cartão neste ambiente terão o pagamento confirmado automaticamente, mas é apenas uma alteração de status para \\\"Pago\\\". Este recurso permite que você teste a notificação do status <code>paid</code>.\\n\\n**Isso significa que todos os pagamentos realizados em sandbox não são reais e, portanto, não há cobrança de nenhuma importância financeira.** \\n\\nÉ importante saber que as palavras **Playground, Sandbox e Ambiente de Homologação**, no contexto da Gerencianet, são sinônimos no sentido de fazerem referência ao local de testes que oferecemos em que você pode testar à vontade sua integração com a API.\"\n}\n[/block]\nNesta seção também, você deverá configurar as seguintes propriedades:\n\n3. **Ambiente de emissão:** Configure se deseja ativar o módulo em Homologação (ambiente de testes) ou Produção (cobrança real);\n\n4. **Formas de Pagamento:** Selecione as opções de pagamento que deseja receber: Boleto, Cartão de Crédito e/ou Pix.\n\nAo clicar em <code>Salvar</code>, será possível configurar as formas de pagamento selecionadas. Então, surgirão as seguintes seções:\n\n## Configurações do Boleto\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f949c38-configuracao_boleto.png\",\n        \"configuracao_boleto.png\",\n        1676,\n        740,\n        \"#333\"\n      ],\n      \"caption\": \"Configurações do Boleto\"\n    }\n  ]\n}\n[/block]\nNesta seção, as seguintes propriedades podem ser configuradas:\n\n1. **Número de dias:** Configure o número de dias corridos para vencimento do Boleto.\n\n2. **Cancelar Boletos não pagos?:** Quando habilitado, cancela todos os Boletos que não foram pagos. Impedindo que o cliente pague o Boleto após a data de vencimento.\n\n3. **Ativar desconto?:** Quando habilitado, será aplicado desconto para pagamentos com Boleto.\n\n4. **Percentual de desconto do boleto:** Defina o percentual de desconto para pagamentos com Boleto.\n\n5. **Percentual de multa:** Defina se deseja aplicar multa em caso de atraso no pagamento do boleto\n\n6. **Percentual de juros:** Defina se deseja aplicar juros em caso de atraso no pagamento do boleto.\n\n7. **Enviar boleto por e-mail?:** Quando habilitado, o boleto será enviado por e-mail ao cliente.\n\n\n## Configurações do Pix\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ed6da89-configuracao_pix.png\",\n        \"configuracao_pix.png\",\n        1680,\n        612,\n        \"#333\"\n      ],\n      \"caption\": \"Configurações do Pix\"\n    }\n  ]\n}\n[/block]\nNesta seção, as seguintes propriedades podem ser configuradas:\n\n1. **Chave Pix:** Insira sua Chave Pix cadastrada em sua conta Gerencianet. Se você ainda não possui uma, veja <a target=\"blank\" href=\"https://gerencianet.com.br/artigo/como-cadastrar-chaves-pix/\">como cadastrar</a>.\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Chave Pix\",\n  \"body\": \"Caso a sua chave Pix esteja cadastrada como número de telefone, não se esqueça de seguir o padrão definido pelo BACEN informando +55 DDD e o número, exemplo: **+5531988887777**\"\n}\n[/block]\n2. **Certificado Pix:** Insira seu certificado (arquivo .p12 ou .pem). Se você ainda não possui um certificado, veja <a target=\"blank\" href=\"https://gerencianet.com.br/artigo/como-gerar-o-certificado-para-usar-a-api-pix/\">como gerar</a>.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Certificado Pix\",\n  \"body\": \"Após fazer o upload do seu certificado Pix, ele ficará salvo, porém o nome do certificado não ficará visível. Caso houver alguma falha, você receberá uma notificação ao salvar as configurações.\"\n}\n[/block]\n3. **Ativar desconto?:** Quando habilitado, será aplicado desconto para pagamentos com Pix.\n\n4. **Percentual de desconto do Pix:** Defina o percentual de desconto para pagamentos com Pix.\n\n5. **Tempo de vencimento em horas:** Defina o tempo, em horas, para o vencimento do pix após a emissão.\n\n6. **Validar mTLS:** Marque o campo \"Validar mTLS\" caso deseje utilizar a validação mTLS em seu servidor.\n\n\n<br>\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 e seu cliente terá as seguintes telas para preencher os dados de pagamento:\n\n**Boleto:**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1e25f4e-boleto.png\",\n        \"boleto.png\",\n        869,\n        501,\n        \"#333\"\n      ],\n      \"caption\": \"Tela de Pagamento Boleto\"\n    }\n  ]\n}\n[/block]\n**Cartão de Crédito**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c3be658-cartao.png\",\n        \"cartao.png\",\n        692,\n        1059,\n        \"#333\"\n      ],\n      \"caption\": \"Tela de Pagamento Cartão de Crédito\"\n    }\n  ]\n}\n[/block]\n**Pix:**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/0ed2793-pix.png\",\n        \"pix.png\",\n        867,\n        452,\n        \"#333\"\n      ],\n      \"caption\": \"Tela de Pagamento Pix\"\n    }\n  ]\n}\n[/block]\n\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 ou ficar em branco, o cliente receberá um alerta com um aviso. Para **Boleto Bancário**, os campos obrigatórios são: <strong>Nome e CPF</strong>. Para **Cartão de Crédito**, os campos obrigatórios são: <strong>Nome, CPF, Data de nascimento, Telefone, Endereço, Número, Bairro, CEP, Cidade e Estado.</strong>.  Para **Pix**, os campos obrigatórios são: <strong>Nome e CPF</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. Acompanhe nosso <a target=\"blank\" href=\"https://dev.gerencianet.com.br/docs/changelog\">changelog</a> para visualizar todas as novidades. \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 módulo as parcelas do cartão de crédito não carregarem ao clicar sobre as bandeiras dos cartões, o lojista deverá verificar as credenciais informadas na configuração do módulo (chaves Client_Id, Client_Secret e também o \"identificador da conta\"). Se estiverem corretas, entre em contato com a Gerencianet para que o problema seja analisado.\n<br>\n\n**5.5. Estou recebendo a mensagem “Unauthorized” ao tentar finalizar uma compra. O que fazer?**\n\nEssa mensagem de erro pode estar relacionada com a as credenciais informadas de forma incorreta. Verifique se as suas credenciais estão corretamente inseridas nos respectivos campos de PRODUÇÃO e Homologação. Confira em <a target=\"blank\" href=\"https://gerencianet.com.br/artigo/estou-deparando-com-mensagem-de-unauthorized-sem-autorizacao-por-que/\">nossa FAQ</a>.\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 e também conferir em sua API a subaba \"histórico de requisições\" <a target=\"blank\" href=\"https://dev.gerencianet.com.br/docs/interpretando-erros-api\">(veja como usar este recurso)</a>.\n\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>.","updates":[],"order":6,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"606f2ca7c5ba91007878344e","createdAt":"2016-06-14T16:29:19.220Z","parentDoc":null,"githubsync":"","__v":69,"version":{"version":"1.1.0","version_clean":"1.1.0","codename":"2021","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["606f2ca6c5ba91007878342b","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","606f2ca6c5ba91007878342c","606f2ca6c5ba91007878342d","606f2ca6c5ba91007878342e","606f2ca6c5ba91007878342f","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","606f2ca6c5ba910078783430","606f2ca6c5ba910078783431","5783f78c5cbce30e0074e2b7","606f2ca6c5ba910078783432","606f2ca6c5ba910078783433","606f2ca6c5ba910078783434","606f2ca6c5ba910078783435","606f2ca6c5ba910078783436","606f2ca6c5ba910078783437","578529f887c9280e0090394b","606f2ca6c5ba910078783438","606f2ca6c5ba910078783439","606f2ca6c5ba91007878343a","606f2ca6c5ba91007878343b","606f2ca6c5ba91007878343c","606f2ca6c5ba91007878343d","606f2ca6c5ba91007878343e","606f2ca6c5ba91007878343f","606f2ca6c5ba910078783440","606f2ca6c5ba910078783441","60d61f026ddc3901a32ee5f1","60ec37c637005f015e54174e","61473375119247002a9c14d7","6283a3819575c60045513ea2"],"_id":"606f2ca7c5ba9100787834c6","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":4,"forked_from":"575aeffae12cf20e002f306f"},"project":"575aeffae12cf20e002f306c","user":"57601a13af3e090e00108059","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Módulos e Plugins","slug":"módulos","order":19,"from_sync":false,"reference":false,"_id":"606f2ca6c5ba91007878342e","__v":0,"createdAt":"2016-06-14T16:28:00.991Z","project":"575aeffae12cf20e002f306c","version":"606f2ca7c5ba9100787834c6"}}

PrestaShop

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

**Módulo de Integração Gerencianet para PrestaShop - Versão 1.0.0** O módulo Gerencianet para Prestashop permite receber pagamentos por meio do <strong>checkout transparente da nossa API</strong>. Compatível com a versão <span class="label label-default">1.7.x</span> do PrestaShop. 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, cartão de crédito e/ou Pix. Todo processo é realizado por meio do checkout transparente. Com isso, o comprador não precisa sair do site da loja para efetuar o pagamento. [block:callout] { "type": "warning", "body": "Caso você tenha ativado o <a href=\"https://gerencianet.com.br/bolix/\" target=\"_blank\" title=\"página Bolix\">Bolix</a> em sua conta Gerencianet, as cobranças geradas pelo nosso módulo/plugin já vão vir com o pix no boleto.\nMais detalhes sobre o Bolix e como ativá-lo <a href=\"https://dev.gerencianet.com.br/docs/bolix-boleto-carne\" target=\"_blank\" title=\"Saiba mais sobre o Bolix\">aqui</a>.", "title": "Bolix" } [/block] # 1. Requisitos - Versão do PHP: <code>7.x</code> - Versão do PrestaShop: <code>1.7.x</code> [block:callout] { "type": "warning", "body": "Os requisitos do sistema foram definidos de acordo com os nossos testes. Se seu sistema não se encaixa nos requisitos, não significa que o módulo não vai funcionar em seu PrestaShop, mas sim, que não testamos no mesmo ambiente. **Portanto, não garantimos o funcionamento deste módulo em ambientes diferentes dos citados acima.**", "title": "IMPORTANTE" } [/block] <br> <hr> # 2. Instalação do Módulo O módulo da Gerencianet para PrestaShop pode ser instalado de forma automática: 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; ## 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/GerencianetPrestashop.zip) (arquivo "**GerencianetPrestashop.zip**"); 2. Acesse a administração da sua loja, em <code>Módulos > Gerenciador de Módulos > Enviar um módulo</code> e envie o arquivo "**GerencianetPrestashop.zip**" que você acabou de baixar; [block:image] { "images": [ { "image": [ "https://files.readme.io/f948522-modulo.png", "modulo.png", 1890, 529, "#333" ], "caption": "Enviar o módulo" } ] } [/block] 3. Depois de enviar o módulo para sua loja, clique em <code>Configurar</code> e aguarde a finalização do processo. [block:image] { "images": [ { "image": [ "https://files.readme.io/10c32b8-instalacao.png", "instalacao.png", 682, 376, "#333" ], "caption": "Módulo instalado" } ] } [/block] # 3. Configurações do Plugin Gerencianet para PrestaShop Para configurar o Módulo da Gerencianet para Prestashop, ao clicar em <code>Configurar</code>, no passo anterior, automaticamente já redireciona para a tela de configuração. Ou então, o lojista deverá acessar a interface administrativa da loja virtual e, no menu principal, acessar a opção <code>Módulos > Gerenciador de Módulos</code>. Procure pelo módulo da Gerencianet na lista que será exibida e depois clique em <code>Configurar</code>, conforme imagem abaixo: [block:image] { "images": [ { "image": [ "https://files.readme.io/b4df559-configuracao.png", "configuracao.png", 1392, 144, "#333" ], "caption": "Configuração do Plugin" } ] } [/block] <br /> Ao entrar nas configurações do módulo, a seguinte interface será exibida: [block:image] { "images": [ { "image": [ "https://files.readme.io/5b93c97-interface.png", "interface.png", 1689, 284, "#333" ], "caption": "Interface do Plugin Gerencianet" } ] } [/block] ## Credenciais [block:image] { "images": [ { "image": [ "https://files.readme.io/4c00ffa-credenciais.png", "credenciais.png", 1678, 729, "#333" ], "caption": "Configurações das Credenciais e Ambiente" } ] } [/block] Nesta seção, é 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="https://gnetbr.com/SyxQGhQOI9" target="_blank">Produção</a> e <a href="https://gnetbr.com/SyebXcmBfO" target="_blank">Homologação</a> da sua aplicação e o <a href="https://gnetbr.com/HkxOIXQd8q" target="_blank">Código Identificador da conta</a> obtidos na aplicação criada na Gerencianet. 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="https://gnetbr.com/SyxQGhQOI9" target="_blank">Produção</a> e <a href="https://gnetbr.com/SyebXcmBfO" target="_blank">Homologação</a>). 2. Insira o <a href="https://gnetbr.com/HkxOIXQd8q" target="_blank">código identificador da conta</a> Gerencianet. [block:callout] { "type": "danger", "title": "ATENÇÃO", "body": "Importante salientar que **os boletos gerados em sandbox não são válidos e não podem ser pagos**, possuem a linha digitável \"zerada\" e uma marca d'água ao fundo informando ser um boleto de teste.\n\n**Os pagamentos de cobranças de sandbox utilizando cartão de crédito são fictícios, mesmo se utilizar um cartão \"real\".** Todos os pagamentos de cartão neste ambiente terão o pagamento confirmado automaticamente, mas é apenas uma alteração de status para \"Pago\". Este recurso permite que você teste a notificação do status <code>paid</code>.\n\n**Isso significa que todos os pagamentos realizados em sandbox não são reais e, portanto, não há cobrança de nenhuma importância financeira.** \n\nÉ importante saber que as palavras **Playground, Sandbox e Ambiente de Homologação**, no contexto da Gerencianet, são sinônimos no sentido de fazerem referência ao local de testes que oferecemos em que você pode testar à vontade sua integração com a API." } [/block] Nesta seção também, você deverá configurar as seguintes propriedades: 3. **Ambiente de emissão:** Configure se deseja ativar o módulo em Homologação (ambiente de testes) ou Produção (cobrança real); 4. **Formas de Pagamento:** Selecione as opções de pagamento que deseja receber: Boleto, Cartão de Crédito e/ou Pix. Ao clicar em <code>Salvar</code>, será possível configurar as formas de pagamento selecionadas. Então, surgirão as seguintes seções: ## Configurações do Boleto [block:image] { "images": [ { "image": [ "https://files.readme.io/f949c38-configuracao_boleto.png", "configuracao_boleto.png", 1676, 740, "#333" ], "caption": "Configurações do Boleto" } ] } [/block] Nesta seção, as seguintes propriedades podem ser configuradas: 1. **Número de dias:** Configure o número de dias corridos para vencimento do Boleto. 2. **Cancelar Boletos não pagos?:** Quando habilitado, cancela todos os Boletos que não foram pagos. Impedindo que o cliente pague o Boleto após a data de vencimento. 3. **Ativar desconto?:** Quando habilitado, será aplicado desconto para pagamentos com Boleto. 4. **Percentual de desconto do boleto:** Defina o percentual de desconto para pagamentos com Boleto. 5. **Percentual de multa:** Defina se deseja aplicar multa em caso de atraso no pagamento do boleto 6. **Percentual de juros:** Defina se deseja aplicar juros em caso de atraso no pagamento do boleto. 7. **Enviar boleto por e-mail?:** Quando habilitado, o boleto será enviado por e-mail ao cliente. ## Configurações do Pix [block:image] { "images": [ { "image": [ "https://files.readme.io/ed6da89-configuracao_pix.png", "configuracao_pix.png", 1680, 612, "#333" ], "caption": "Configurações do Pix" } ] } [/block] Nesta seção, as seguintes propriedades podem ser configuradas: 1. **Chave Pix:** Insira sua Chave Pix cadastrada em sua conta Gerencianet. Se você ainda não possui uma, veja <a target="blank" href="https://gerencianet.com.br/artigo/como-cadastrar-chaves-pix/">como cadastrar</a>. [block:callout] { "type": "info", "title": "Chave Pix", "body": "Caso a sua chave Pix esteja cadastrada como número de telefone, não se esqueça de seguir o padrão definido pelo BACEN informando +55 DDD e o número, exemplo: **+5531988887777**" } [/block] 2. **Certificado Pix:** Insira seu certificado (arquivo .p12 ou .pem). Se você ainda não possui um certificado, veja <a target="blank" href="https://gerencianet.com.br/artigo/como-gerar-o-certificado-para-usar-a-api-pix/">como gerar</a>. [block:callout] { "type": "info", "title": "Certificado Pix", "body": "Após fazer o upload do seu certificado Pix, ele ficará salvo, porém o nome do certificado não ficará visível. Caso houver alguma falha, você receberá uma notificação ao salvar as configurações." } [/block] 3. **Ativar desconto?:** Quando habilitado, será aplicado desconto para pagamentos com Pix. 4. **Percentual de desconto do Pix:** Defina o percentual de desconto para pagamentos com Pix. 5. **Tempo de vencimento em horas:** Defina o tempo, em horas, para o vencimento do pix após a emissão. 6. **Validar mTLS:** Marque o campo "Validar mTLS" caso deseje utilizar a validação mTLS em seu servidor. <br> <hr> # 4. Funcionamento do Módulo Após ser habilitado, o módulo já estará disponível como uma opção de pagamento e seu cliente terá as seguintes telas para preencher os dados de pagamento: **Boleto:** [block:image] { "images": [ { "image": [ "https://files.readme.io/1e25f4e-boleto.png", "boleto.png", 869, 501, "#333" ], "caption": "Tela de Pagamento Boleto" } ] } [/block] **Cartão de Crédito** [block:image] { "images": [ { "image": [ "https://files.readme.io/c3be658-cartao.png", "cartao.png", 692, 1059, "#333" ], "caption": "Tela de Pagamento Cartão de Crédito" } ] } [/block] **Pix:** [block:image] { "images": [ { "image": [ "https://files.readme.io/0ed2793-pix.png", "pix.png", 867, 452, "#333" ], "caption": "Tela de Pagamento Pix" } ] } [/block] [block:callout] { "type": "info", "title": "OBSERVAÇÃO", "body": "Se algum dos campos obrigatórios para o realizar o pagamento não for preenchido corretamente ou ficar em branco, o cliente receberá um alerta com um aviso. Para **Boleto Bancário**, os campos obrigatórios são: <strong>Nome e CPF</strong>. Para **Cartão de Crédito**, os campos obrigatórios são: <strong>Nome, CPF, Data de nascimento, Telefone, Endereço, Número, Bairro, CEP, Cidade e Estado.</strong>. Para **Pix**, os campos obrigatórios são: <strong>Nome e CPF</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. Acompanhe nosso <a target="blank" href="https://dev.gerencianet.com.br/docs/changelog">changelog</a> para visualizar todas as novidades. <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 módulo as parcelas do cartão de crédito não carregarem ao clicar sobre as bandeiras dos cartões, o lojista deverá verificar as credenciais informadas na configuração do módulo (chaves Client_Id, Client_Secret e também o "identificador da conta"). Se estiverem corretas, entre em contato com a Gerencianet para que o problema seja analisado. <br> **5.5. Estou recebendo a mensagem “Unauthorized” ao tentar finalizar uma compra. O que fazer?** Essa mensagem de erro pode estar relacionada com a as credenciais informadas de forma incorreta. Verifique se as suas credenciais estão corretamente inseridas nos respectivos campos de PRODUÇÃO e Homologação. Confira em <a target="blank" href="https://gerencianet.com.br/artigo/estou-deparando-com-mensagem-de-unauthorized-sem-autorizacao-por-que/">nossa FAQ</a>. **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 e também conferir em sua API a subaba "histórico de requisições" <a target="blank" href="https://dev.gerencianet.com.br/docs/interpretando-erros-api">(veja como usar este recurso)</a>. <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>.