{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Opencart - Pix","type":"basic","slug":"opencart-pix","excerpt":"Saiba onde, como baixar e instalar nosso módulo/plugin OpenCart - Pix com a forma de pagamento: Pix","body":"**Módulo de Integração Gerencianet PIX para OpenCart Brasil**\n\nO módulo Gerencianet para OpenCart permite receber pagamentos por meio do checkout transparente da nossa API. Este módulo é o Módulo Oficial da Gerencianet para o OpenCart, **compatível apenas com as versões do OpenCart superior a versão 3.0.3.3 (Brasil 1.5.0)**.\n\nVocê pode baixar o OpenCart [aqui](https://www.opencartbrasil.com.br/download).\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"IMPORTANTE!\",\n  \"body\": \"Este módulo contempla apenas pagamentos utilizando o Pix.\\nPara pagamentos via Boleto, consulte a página [OpenCart - Boletos](https://dev.gerencianet.com.br/docs/opencart)\"\n}\n[/block]\n# 1. Requisitos do sistema\n\n## Utilizando PHP 7.3\n    - Versão do MySQL: 5.6\n##Utilizando PHP 7.4\n    - Versão do MySQL: 8.x\n\nInstalação de dependências que podem estar faltando (substitua o x pelo número da versão do seu PHP): \n    - sudo apt-get install php7.x-dom\n    - sudo apt-get install php7.x-curl\n    - sudo apt-get install php7.x-gd\n    - sudo apt-get install php7.x-xml\n    - sudo apt-get install php7.x-zip\n\n- OpenCart necessita do <code>curl</code> ativado\n- É necessário que o <code>Real Brasileiro</code> esteja configurado como moeda padrão no Opencart.\n- Você deve utilizar o OpenCart Brasil. Caso ainda não tenha, baixe-o [aqui](https://www.opencartbrasil.com.br/download).\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"ATENÇÃO!\",\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 disponibilizado não funcionará em seu OpenCart, mas sim, que não testamos no mesmo ambiente.\\n\\n**Portanto, não garantimos o funcionamento deste módulo em ambientes diferentes dos citados acima.**\"\n}\n[/block]\n# 2. Instalação\n\nO módulo da Gerencianet para OpenCart pode ser instalado de duas formas:\n\n- *[Instalação Automática](#section-2-1-instala-o-autom-tica):* utilizando o arquivo de instalação do módulo compactado através da ferramenta de adicionar nova extensão do OpenCart;\n\n- *[Instalação Manual](#section-2-2-instala-o-manual):* os arquivos do módulo devem ser enviados manualmente para o servidor de hospedagem via FTP.\n\n\n## 2.1. Instalação Automática\n\n1. Faça o download do arquivo [gerencianet.ocmod.zip](https://github.com/gerencianet/gn-api-opencart-pix/blob/main/auto/gerencianet.ocmod.zip).\n\n2. Acesse o menu `Extensions > Extension Installer` (`Extensões > Instalador`), clique no botão **Upload**, selecione o arquivo 'gerencianet.ocmod.zip' (citado na primeira instrução) e aguarde a conclusão da instalação automática.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Caso você já tenha instalado o módulo da Gerencianet anteriormente, o OpenCart poderá informar que alguns arquivos serão sobrescritos. Não se preocupe, pois a instalação não afetará qualquer arquivo que não seja do módulo da Gerencianet já existente em sua loja.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"body\": \"Devido ao tamanho do arquivo de instalação do módulo, talvez seja necessário alterar o parâmetro <code>php_max_upload</code> do <code>php.ini</code> para, no mínimo, 3 mb.\"\n}\n[/block]\n## 2.2. Instalação Manual\n\n1. Faça o download dos [arquivos da última versão do módulo](https://github.com/gerencianet/gn-api-opencart-pix/tree/main/manual).\n2. Descompacte os arquivo baixado e realize o upload das pastas **admin**, **catalog** e **lib** para dentro do diretório principal do OpenCart.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Caso você já tenha instalado o módulo da Gerencianet anteriormente, o OpenCart poderá informar que alguns arquivos serão sobrescritos. Não se preocupe, pois a instalação não afetará qualquer arquivo que não seja do módulo da Gerencianet já existente em sua loja.\",\n  \"title\": \"NOTA\"\n}\n[/block]\n# 3. Configurações\n\nAcesse <code>Extensions >  Modifications</code> (<code>Extensões > Modificações</code>), selecione o módulo <code>Gerencianet PIX</code> e clique no botão <code>Refresh</code> (<code>Atualizar</code>) no canto superior direito da página.\n\nAo acessar <code>Extensions >  Extensions</code> (<code>Extensões > Extensões</code>), você deverá selecionar o tipo de extensão que deseja. Escolha <code>Payments</code> (<code>Pagamentos</code>). Você já visualizará o módulo da Gerencianet disponível na lista. Clique em <code>install</code> (<code>instalar</code>) para instalar o módulo e depois em <code>edit</code> (<code>editar</code>) para iniciar a configuração.\n\nTrês abas estarão disponíveis para realizar a configuração do módulo:\n\n* Geral\n* PIX\n* Status do Pedido\n\n## Configurações Gerais\n\nNesta aba é necessário informar:\n* As **credenciais de Produção e Desenvolvimento** da sua aplicação (obtidas na sua conta Gerencianet)\n* O **identificador da conta** (obtido na sua conta Gerencianet)\n* **Habilitar modo sandbox**: Determina se o módulo está em modo de testes. No modo de teste você pode gerar cobranças fictícias para testar o fluxo.\n* **Ativo**: Determina se o módulo de pagamentos da Gerencianet está Ativo ou Inativo.\n\n## PIX\n\nNesta aba, as seguintes propriedades podem ser configuradas:\n\n* **Chave PIX**: Determina a qual chave PIX o pagamento será enviado\n* **Caminho do certificado**: Deve ser informado o caminho onde se encontra o seu certificado de segurança `.pem`\n* **Desconto no Pagamento**: Você pode fornecer desconto para clientes que pagam por meio do PIX.\n* **Tempo de Vencimento (horas)**: Determina o tempo de validade do QrCode Gerado\n* **Validar mTLS**: Habilita ou desabilita a verificação de segurança utilizando mTLS. Mais informações você encontra [AQUI](https://dev.gerencianet.com.br/docs/api-pix#section-webhook)\n\n\n## Status do Pedido\n\nNesta aba é realizada a configuração dos Status de pagamento da Gerencianet com os Status de pagamento de sua loja. Assim, quando houver a alteração do status do pagamento na Gerencianet,  o status do pedido em sua loja será atualizado automaticamente de acordo com as configurações definidas.\n\n\n# 4. Dúvidas Frequentes\n\n** 4.1. É obrigatório possuir SSL em minha loja para aceitar pagamentos com o módulo?**\n\nPara que o módulo da Gerencianet para OpenCart funcione, não é necessário que a loja possua um certificado SSL. Contudo, é extremamente recomendado pela Gerencianet que os lojistas utilizem. Independente da sua utilização, todos os dados de pagamento são criptografados e transmitidos com segurança para validação do pagamento. A presença de um certificado SSL instalado em sua loja garante maior segurança para o lojista e para os clientes que realizam compras. A ausência do certificado SSL na tela de pagamento, pode fazer com que o lojista perca vendas, uma vez que o cliente pode se sentir inseguro para digitar dados de pagamento em uma página que não possui um certificado.\n\n<br />\n** 4.2. Quero usar o Checkout Transparente de forma que o cliente não saia da minha loja para realizar o pagamento. É possível?**\n\nSim. O módulo da Gerencianet para OpenCart utiliza o checkout transparente para realizar o pagamento dos clientes, ou seja, em nenhum momento o cliente irá sair da sua loja virtual para finalizar o pagamento. Assim, no último passo da compra, será solicitado ao clientes dos dados obrigatórios para efetivar o pagamento.\n\n<br />\n** 4.3. É possível utilizar as funcionalidades de MarketPlace ou Assinaturas com o módulo?**\n\nAinda não. Acompanhe nosso [changelog](https://dev.gerencianet.com.br/docs/changelog) para visualizar todas as novidades.\n\n<br />\n\n** 4.4.  Estou recebendo a mensagem *“Unauthorized”* ao tentar finalizar uma compra. O que fazer?**\nEssa mensagem de erro pode estar relacionada com a as credenciais informadas de forma incorreta. Verifique se as suas credenciais estão corretamente inseridas nos respectivos campos de PRODUÇÃO e Homologação. Confira em [nossa FAQ](https://gerencianet.com.br/artigo/estou-deparando-com-mensagem-de-unauthorized-sem-autorizacao-por-que/) informações detalhadas.\n\n<br />\n** 4.5. 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 <code>Extensions > Payments > Gerencianet > Editar</code> (ou em <code>Extensões > Pagamentos > Gerencianet > Editar</code>) e desmarque a opção <code>SandBox > Habilitar Sandbox Gerencianet (Ambiente de testes).</code>\n\n<br />\n** 4.6. Onde posso acompanhar as transações geradas pelo módulo?**\n\nAs transações geradas através do módulo podem ser acompanhadas em sua conta Gerencianet no link <code>API > Minhas Aplicações > Sua Aplicação</code>. Neste ambiente você poderá acompanhar todas as transações e suas respectivas situações.\n\n<br />\n** 4.7. 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 sub-aba \"histórico de requisições\" ([veja como usar este recurso](https://dev.gerencianet.com.br/docs/interpretando-erros-api)).\n\n<br />\n<hr>\n\n# 5. Suporte e Sugestões\n\nSuas sugestões de novas ideias e implementações para o módulo da Gerencianet para OpenCart são muito importantes. 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":5,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"60b77f5a81a9b300802e86d1","createdAt":"2021-06-02T12:53:46.716Z","user":"5e8b36bc27ee9b00181b36bf","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Módulos e Plugins","slug":"módulos","order":17,"from_sync":false,"reference":false,"_id":"606f2ca6c5ba91007878342e","__v":0,"createdAt":"2016-06-14T16:28:00.991Z","project":"575aeffae12cf20e002f306c","version":"606f2ca7c5ba9100787834c6"},"version":{"version":"1.1.0","version_clean":"1.1.0","codename":"2021","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["606f2ca6c5ba91007878342b","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","606f2ca6c5ba91007878342c","606f2ca6c5ba91007878342d","606f2ca6c5ba91007878342e","606f2ca6c5ba91007878342f","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","606f2ca6c5ba910078783430","606f2ca6c5ba910078783431","5783f78c5cbce30e0074e2b7","606f2ca6c5ba910078783432","606f2ca6c5ba910078783433","606f2ca6c5ba910078783434","606f2ca6c5ba910078783435","606f2ca6c5ba910078783436","606f2ca6c5ba910078783437","578529f887c9280e0090394b","606f2ca6c5ba910078783438","606f2ca6c5ba910078783439","606f2ca6c5ba91007878343a","606f2ca6c5ba91007878343b","606f2ca6c5ba91007878343c","606f2ca6c5ba91007878343d","606f2ca6c5ba91007878343e","606f2ca6c5ba91007878343f","606f2ca6c5ba910078783440","606f2ca6c5ba910078783441","60d61f026ddc3901a32ee5f1","60ec37c637005f015e54174e"],"_id":"606f2ca7c5ba9100787834c6","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":2,"forked_from":"575aeffae12cf20e002f306f"},"project":"575aeffae12cf20e002f306c","__v":0,"parentDoc":null}

Opencart - Pix

Saiba onde, como baixar e instalar nosso módulo/plugin OpenCart - Pix com a forma de pagamento: Pix

**Módulo de Integração Gerencianet PIX para OpenCart Brasil** O módulo Gerencianet para OpenCart permite receber pagamentos por meio do checkout transparente da nossa API. Este módulo é o Módulo Oficial da Gerencianet para o OpenCart, **compatível apenas com as versões do OpenCart superior a versão 3.0.3.3 (Brasil 1.5.0)**. Você pode baixar o OpenCart [aqui](https://www.opencartbrasil.com.br/download). [block:callout] { "type": "danger", "title": "IMPORTANTE!", "body": "Este módulo contempla apenas pagamentos utilizando o Pix.\nPara pagamentos via Boleto, consulte a página [OpenCart - Boletos](https://dev.gerencianet.com.br/docs/opencart)" } [/block] # 1. Requisitos do sistema ## Utilizando PHP 7.3 - Versão do MySQL: 5.6 ##Utilizando PHP 7.4 - Versão do MySQL: 8.x Instalação de dependências que podem estar faltando (substitua o x pelo número da versão do seu PHP): - sudo apt-get install php7.x-dom - sudo apt-get install php7.x-curl - sudo apt-get install php7.x-gd - sudo apt-get install php7.x-xml - sudo apt-get install php7.x-zip - OpenCart necessita do <code>curl</code> ativado - É necessário que o <code>Real Brasileiro</code> esteja configurado como moeda padrão no Opencart. - Você deve utilizar o OpenCart Brasil. Caso ainda não tenha, baixe-o [aqui](https://www.opencartbrasil.com.br/download). [block:callout] { "type": "warning", "title": "ATENÇÃO!", "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 disponibilizado não funcionará em seu OpenCart, mas sim, que não testamos no mesmo ambiente.\n\n**Portanto, não garantimos o funcionamento deste módulo em ambientes diferentes dos citados acima.**" } [/block] # 2. Instalação O módulo da Gerencianet para OpenCart pode ser instalado de duas formas: - *[Instalação Automática](#section-2-1-instala-o-autom-tica):* utilizando o arquivo de instalação do módulo compactado através da ferramenta de adicionar nova extensão do OpenCart; - *[Instalação Manual](#section-2-2-instala-o-manual):* os arquivos do módulo devem ser enviados manualmente para o servidor de hospedagem via FTP. ## 2.1. Instalação Automática 1. Faça o download do arquivo [gerencianet.ocmod.zip](https://github.com/gerencianet/gn-api-opencart-pix/blob/main/auto/gerencianet.ocmod.zip). 2. Acesse o menu `Extensions > Extension Installer` (`Extensões > Instalador`), clique no botão **Upload**, selecione o arquivo 'gerencianet.ocmod.zip' (citado na primeira instrução) e aguarde a conclusão da instalação automática. [block:callout] { "type": "info", "body": "Caso você já tenha instalado o módulo da Gerencianet anteriormente, o OpenCart poderá informar que alguns arquivos serão sobrescritos. Não se preocupe, pois a instalação não afetará qualquer arquivo que não seja do módulo da Gerencianet já existente em sua loja." } [/block] [block:callout] { "type": "danger", "body": "Devido ao tamanho do arquivo de instalação do módulo, talvez seja necessário alterar o parâmetro <code>php_max_upload</code> do <code>php.ini</code> para, no mínimo, 3 mb." } [/block] ## 2.2. Instalação Manual 1. Faça o download dos [arquivos da última versão do módulo](https://github.com/gerencianet/gn-api-opencart-pix/tree/main/manual). 2. Descompacte os arquivo baixado e realize o upload das pastas **admin**, **catalog** e **lib** para dentro do diretório principal do OpenCart. [block:callout] { "type": "info", "body": "Caso você já tenha instalado o módulo da Gerencianet anteriormente, o OpenCart poderá informar que alguns arquivos serão sobrescritos. Não se preocupe, pois a instalação não afetará qualquer arquivo que não seja do módulo da Gerencianet já existente em sua loja.", "title": "NOTA" } [/block] # 3. Configurações Acesse <code>Extensions > Modifications</code> (<code>Extensões > Modificações</code>), selecione o módulo <code>Gerencianet PIX</code> e clique no botão <code>Refresh</code> (<code>Atualizar</code>) no canto superior direito da página. Ao acessar <code>Extensions > Extensions</code> (<code>Extensões > Extensões</code>), você deverá selecionar o tipo de extensão que deseja. Escolha <code>Payments</code> (<code>Pagamentos</code>). Você já visualizará o módulo da Gerencianet disponível na lista. Clique em <code>install</code> (<code>instalar</code>) para instalar o módulo e depois em <code>edit</code> (<code>editar</code>) para iniciar a configuração. Três abas estarão disponíveis para realizar a configuração do módulo: * Geral * PIX * Status do Pedido ## Configurações Gerais Nesta aba é necessário informar: * As **credenciais de Produção e Desenvolvimento** da sua aplicação (obtidas na sua conta Gerencianet) * O **identificador da conta** (obtido na sua conta Gerencianet) * **Habilitar modo sandbox**: Determina se o módulo está em modo de testes. No modo de teste você pode gerar cobranças fictícias para testar o fluxo. * **Ativo**: Determina se o módulo de pagamentos da Gerencianet está Ativo ou Inativo. ## PIX Nesta aba, as seguintes propriedades podem ser configuradas: * **Chave PIX**: Determina a qual chave PIX o pagamento será enviado * **Caminho do certificado**: Deve ser informado o caminho onde se encontra o seu certificado de segurança `.pem` * **Desconto no Pagamento**: Você pode fornecer desconto para clientes que pagam por meio do PIX. * **Tempo de Vencimento (horas)**: Determina o tempo de validade do QrCode Gerado * **Validar mTLS**: Habilita ou desabilita a verificação de segurança utilizando mTLS. Mais informações você encontra [AQUI](https://dev.gerencianet.com.br/docs/api-pix#section-webhook) ## Status do Pedido Nesta aba é realizada a configuração dos Status de pagamento da Gerencianet com os Status de pagamento de sua loja. Assim, quando houver a alteração do status do pagamento na Gerencianet, o status do pedido em sua loja será atualizado automaticamente de acordo com as configurações definidas. # 4. Dúvidas Frequentes ** 4.1. É obrigatório possuir SSL em minha loja para aceitar pagamentos com o módulo?** Para que o módulo da Gerencianet para OpenCart 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 /> ** 4.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 OpenCart 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 /> ** 4.3. É possível utilizar as funcionalidades de MarketPlace ou Assinaturas com o módulo?** Ainda não. Acompanhe nosso [changelog](https://dev.gerencianet.com.br/docs/changelog) para visualizar todas as novidades. <br /> ** 4.4. 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 [nossa FAQ](https://gerencianet.com.br/artigo/estou-deparando-com-mensagem-de-unauthorized-sem-autorizacao-por-que/) informações detalhadas. <br /> ** 4.5. 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 <code>Extensions > Payments > Gerencianet > Editar</code> (ou em <code>Extensões > Pagamentos > Gerencianet > Editar</code>) e desmarque a opção <code>SandBox > Habilitar Sandbox Gerencianet (Ambiente de testes).</code> <br /> ** 4.6. 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 <code>API > Minhas Aplicações > Sua Aplicação</code>. Neste ambiente você poderá acompanhar todas as transações e suas respectivas situações. <br /> ** 4.7. 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 sub-aba "histórico de requisições" ([veja como usar este recurso](https://dev.gerencianet.com.br/docs/interpretando-erros-api)). <br /> <hr> # 5. Suporte e Sugestões Suas sugestões de novas ideias e implementações para o módulo da Gerencianet para OpenCart são muito importantes. 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>.