1dfd4479.fac31520.js

(window.webpackJsonp=window.webpackJsonp||[]).push([[28],{129:function(e,t,a){"use strict";a.r(t),a.d(t,"frontMatter",(function(){return i})),a.d(t,"metadata",(function(){return c})),a.d(t,"rightToc",(function(){return l})),a.d(t,"default",(function(){return s}));var n=a(2),r=a(6),o=(a(0),a(250)),i=(a(252),{id:"OpenCart",title:"OpenCart",hide_title:!0,sidebar_label:"OpenCart - Boleto and credit card"}),c={id:"Modulos/OpenCart",isDocsHomePage:!1,title:"OpenCart",description:"OpenCart - Boleto and credit card",source:"@site/docs\\Modulos\\OpenCart.md",permalink:"/documentation/docs/Modulos/OpenCart",sidebar_label:"OpenCart - Boleto and credit card",sidebar:"someSidebar",previous:{title:"OpenMage",permalink:"/documentation/docs/Modulos/OpenMage"},next:{title:"OpenCartPix",permalink:"/documentation/docs/Modulos/OpenCartPix"}},l=[{value:"1. System requirements",id:"1-system-requirements",children:[]},{value:"1.1. Gerencianet module versions for OpenCart",id:"11-gerencianet-module-versions-for-opencart",children:[]},{value:"2. Pre-Installation",id:"2-pre-installation",children:[]},{value:"3. Installation",id:"3-installation",children:[{value:"3.1. Automatic Installation",id:"31-automatic-installation",children:[]},{value:"3.2. Manual Installation",id:"32-manual-installation",children:[]}]},{value:"4. Settings",id:"4-settings",children:[{value:"Tab &quot;General Settings&quot;",id:"tab-general-settings",children:[]},{value:"Credentials",id:"credentials",children:[]},{value:"Tab &quot;Purchase Status&quot;",id:"tab-purchase-status",children:[]}]},{value:"5. Module Operation",id:"5-module-operation",children:[]},{value:"6. Gerencianet Module Versions for OpenCart",id:"6-gerencianet-module-versions-for-opencart",children:[]},{value:"7. Frequent Questions",id:"7-frequent-questions",children:[]},{value:"8. Support and Suggestions",id:"8-support-and-suggestions",children:[]}],b={rightToc:l};function s(e){var t=e.components,a=Object(r.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},b,a,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h1",{className:"titulo"},"OpenCart - Boleto and credit card"),Object(o.b)("div",{className:"subtitulo"},Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"Gerencianet Integration Module for OpenCart 3.x - Version 3.1.1 (BETA)")),Object(o.b)("p",null,"The Gerencianet module for OpenCart allows you to receive payments through the transparent checkout of our API. This module is the Official Module of Gerencianet for OpenCart, ",Object(o.b)("strong",{parentName:"p"},"only compatible with versions of OpenCart greater than 3.0.2.0"),"."),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"If you have a lower version of Opencart"),", check the correct version of the module to be downloaded in the table below, paying attention to your OpenCart version."),Object(o.b)("div",{className:"admonition admonition-important alert alert--info"},Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-heading"}),Object(o.b)("h5",{parentName:"div"},Object(o.b)("span",Object(n.a)({parentName:"h5"},{className:"admonition-icon"}),Object(o.b)("svg",Object(n.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"14",height:"16",viewBox:"0 0 14 16"}),Object(o.b)("path",Object(n.a)({parentName:"svg"},{fillRule:"evenodd",d:"M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"})))),"Bolix")),Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-content"}),Object(o.b)("p",{parentName:"div"},"If you have activated Bolix in your Gerencianet account, the charges generated by our module/plugin will already come with the pix on the boleto.\nMore details about Bolix and how to activate it, click ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"../Bolix/bolix"}),"here"),"."))),Object(o.b)("h2",{id:"1-system-requirements"},"1. System requirements"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"PHP version: ",Object(o.b)("inlineCode",{parentName:"li"},"5.4.0")," \xe0 ",Object(o.b)("inlineCode",{parentName:"li"},"7.0.3"))),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"OpenCart needs the following PHP extensions enabled:",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},Object(o.b)("code",null,"curl")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("code",null,"dom")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("code",null,"gd")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("code",null,"xml")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("code",null,"zip"))))),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"It is necessary that the ",Object(o.b)("inlineCode",{parentName:"li"},"Real Brasileiro")," is set as the default currency in Opencart."),Object(o.b)("li",{parentName:"ul"},"OpenCart version: ",Object(o.b)("em",{parentName:"li"},"See table below"))),Object(o.b)("br",null),Object(o.b)("h2",{id:"11-gerencianet-module-versions-for-opencart"},"1.1. Gerencianet module versions for OpenCart"),Object(o.b)("table",null,Object(o.b)("thead",{parentName:"table"},Object(o.b)("tr",{parentName:"thead"},Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Gerencianet module version"),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:"center"}),"Status"),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:"right"}),"Repository (branch)"),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:"right"}),"Compatible OpenCart Version(*)"))),Object(o.b)("tbody",{parentName:"table"},Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"0.4.1"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),"Sustained"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"})),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("a",{href:"https://github.com/gerencianet/gn-api-opencart/archive/1.x.zip",target:"_blank"},"Download v1")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),Object(o.b)("inlineCode",{parentName:"td"},"2.0.0.0")," \xe0 ",Object(o.b)("inlineCode",{parentName:"td"},"2.2.0.0")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"})),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"2.1.1"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),"Sustained"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"})),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("a",{href:"https://github.com/gerencianet/gn-api-opencart/archive/2.x.zip",target:"_blank"},"Download v2")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),Object(o.b)("inlineCode",{parentName:"td"},"2.x")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"})),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"3.1.1 (beta)"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),"Sustained"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"})),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("a",{href:"https://github.com/gerencianet/gn-api-opencart/archive/master.zip",target:"_blank"},"Download v3")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),Object(o.b)("inlineCode",{parentName:"td"},"3.0.2.0")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"})),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}))))),Object(o.b)("br",null),Object(o.b)("div",{className:"admonition admonition-important alert alert--info"},Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-heading"}),Object(o.b)("h5",{parentName:"div"},Object(o.b)("span",Object(n.a)({parentName:"h5"},{className:"admonition-icon"}),Object(o.b)("svg",Object(n.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"14",height:"16",viewBox:"0 0 14 16"}),Object(o.b)("path",Object(n.a)({parentName:"svg"},{fillRule:"evenodd",d:"M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"})))),"IMPORTANT")),Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-content"}),Object(o.b)("p",{parentName:"div"},"(*) The system requirements were defined according to our tests. If your system doesn't fit the requirements, it doesn't mean that any of the three modules available won't work in your OpenCart, but that we don't test in the same environment."),Object(o.b)("p",{parentName:"div"},Object(o.b)("strong",{parentName:"p"},"Therefore, we do not guarantee the operation of this module in environments other than those mentioned above.")))),Object(o.b)("br",null),Object(o.b)("h2",{id:"2-pre-installation"},"2. Pre-Installation"),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"This step should only be followed if you have the old version of the Gerencianet/Opencart module and Opencart 3.0.x.")),Object(o.b)("ol",null,Object(o.b)("li",{parentName:"ol"},Object(o.b)("p",{parentName:"li"},"Uninstall the old Gerencianet module;")),Object(o.b)("li",{parentName:"ol"},Object(o.b)("p",{parentName:"li"},"Delete the following files on the server where OpenCart is installed:"))),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{}),"loja/admin/controller/payment/gerencianet.php\n\nloja/admin/language/en-gb/payment/gerencianet.php\n\nloja/admin/view/template/payment/gerencianet.tpl\n\nloja/catalog/controller/payment/gerencianet.php\n\nloja/catalog/language/en-gb/payment/gerencianet.php\n\nloja/catalog/model/payment/gerencianet.php\n\nloja/catalog/view/theme/default/template/payment/gerencianet.tpl\n\nloja/catalog/view/theme/default/template/payment/gerencianet_payment.tpl\n\nloja/catalog/view/theme/default/template/payment/gerencianet_success.tpl\n")),Object(o.b)("div",{className:"admonition admonition-caution alert alert--warning"},Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-heading"}),Object(o.b)("h5",{parentName:"div"},Object(o.b)("span",Object(n.a)({parentName:"h5"},{className:"admonition-icon"}),Object(o.b)("svg",Object(n.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"16",height:"16",viewBox:"0 0 16 16"}),Object(o.b)("path",Object(n.a)({parentName:"svg"},{fillRule:"evenodd",d:"M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"})))),"CAUTION")),Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-content"}),Object(o.b)("p",{parentName:"div"},"No directory should be deleted, only the files mentioned above."))),Object(o.b)("br",null),Object(o.b)("hr",null),Object(o.b)("h2",{id:"3-installation"},"3. Installation"),Object(o.b)("p",null,"The Gerencianet module for OpenCart can be installed in two ways:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("em",{parentName:"p"},Object(o.b)("a",Object(n.a)({parentName:"em"},{href:"#31-instala%C3%A7%C3%A3o-autom%C3%A1tica"}),"Automatic installation"),":")," using the module installation file compressed through the OpenCart's add new extension tool;")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("em",{parentName:"p"},Object(o.b)("a",Object(n.a)({parentName:"em"},{href:"#32-instala%C3%A7%C3%A3o-manual"}),"Manual Installation"),":")," module files must be manually uploaded to the hosting server via FTP."))),Object(o.b)("br",null),Object(o.b)("h3",{id:"31-automatic-installation"},"3.1. Automatic Installation"),Object(o.b)("ol",null,Object(o.b)("li",{parentName:"ol"},Object(o.b)("p",{parentName:"li"},"Download the ",Object(o.b)("a",{href:"https://github.com/gerencianet/gn-api-opencart/blob/master/auto",target:"_blank"},"module auto installer"),";")),Object(o.b)("li",{parentName:"ol"},Object(o.b)("p",{parentName:"li"},"In the administration of the OpenCart store, access the menu ",Object(o.b)("code",null,"System > Settings")," (or ",Object(o.b)("code",null,"Configura\xe7\xf5es > Lojas"),") and click in the button ",Object(o.b)("code",null,"Edit")," (or ",Object(o.b)("code",null,"Editar"),"). In the FTP tab, fill in your hosting's FTP access information. Pay special attention to the field ",Object(o.b)("code",null,"FTP Root")," (or ",Object(o.b)("code",null,"Diret\xf3rio FTP"),"), which is the full path to the root directory where your OpenCart is installed. Then click on the button ",Object(o.b)("code",null,"Save")," (or ",Object(o.b)("code",null,"Salvar"),");")),Object(o.b)("li",{parentName:"ol"},Object(o.b)("p",{parentName:"li"},"Access the menu ",Object(o.b)("code",null,"Extensions > Extension Installer")," (or ",Object(o.b)("code",null,"Extens\xf5es > Instalador"),"), click on the button ",Object(o.b)("code",null,"Upload"),", select the file ",Object(o.b)("code",null,"gerencianet.ocmod.zip")," (quoted in the first instruction) and wait for the automatic installation to complete."),Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"If you have previously installed the Gerencianet module, OpenCart may inform you that some files will be overwritten. Don't worry, because the installation will not affect any file other than the Gerencianet module already existing in your store.")))),Object(o.b)("div",{className:"admonition admonition-caution alert alert--warning"},Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-heading"}),Object(o.b)("h5",{parentName:"div"},Object(o.b)("span",Object(n.a)({parentName:"h5"},{className:"admonition-icon"}),Object(o.b)("svg",Object(n.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"16",height:"16",viewBox:"0 0 16 16"}),Object(o.b)("path",Object(n.a)({parentName:"svg"},{fillRule:"evenodd",d:"M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"})))),"CAUTION")),Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-content"}),Object(o.b)("p",{parentName:"div"},"Due to the size of the module installation file, you may need to change the parameter ",Object(o.b)("inlineCode",{parentName:"p"},"php_max_upload")," of ",Object(o.b)("inlineCode",{parentName:"p"},"php.ini")," to at least 3 mb."))),Object(o.b)("br",null),Object(o.b)("h3",{id:"32-manual-installation"},"3.2. Manual Installation"),Object(o.b)("ol",null,Object(o.b)("li",{parentName:"ol"},Object(o.b)("p",{parentName:"li"},"Donwload the ",Object(o.b)("a",{href:"https://github.com/gerencianet/gn-api-opencart/blob/master/manual",target:"_blank"},"arquivos da \xfaltima vers\xe3o do m\xf3dulo"),";")),Object(o.b)("li",{parentName:"ol"},Object(o.b)("p",{parentName:"li"},"Unzip the downloaded files and upload the folders ",Object(o.b)("code",null,"admin"),", ",Object(o.b)("code",null,"catalog")," and ",Object(o.b)("code",null,"lib")," into the main OpenCart* directory."),Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},Object(o.b)("em",null,"*If you have previously installed the Gerencianet module, OpenCart may inform you that some files will be overwritten. Don't worry, because the installation will not affect any file other than the Gerencianet module already existing in your store."))))),Object(o.b)("br",null),Object(o.b)("hr",null),Object(o.b)("h2",{id:"4-settings"},"4. Settings"),Object(o.b)("p",null,"When accessing ",Object(o.b)("code",null,"Extensions > Payments")," (or ",Object(o.b)("code",null,"Extens\xf5es > Pagamentos"),"), you will already see the Gerencianet module available in the list. Click in ",Object(o.b)("code",null,"Install")," to install the module and then in ",Object(o.b)("code",null,"edit")," to start the configuration."),Object(o.b)("p",null,"Three tabs will be available to configure the module:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"General Settings"),Object(o.b)("li",{parentName:"ul"},"Credentials"),Object(o.b)("li",{parentName:"ul"},"Purchase Status")),Object(o.b)("br",null),Object(o.b)("h3",{id:"tab-general-settings"},'Tab "General Settings"'),Object(o.b)("p",null,Object(o.b)("img",Object(n.a)({parentName:"p"},{src:"../../img/opencart.png",alt:"alt text"}))),Object(o.b)("p",null,"On this tab, the following properties can be configured:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("em",{parentName:"p"},"Modo:")," Determines if the module is in testing mode. In test mode you can generate dummy charges to test the flow;")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("em",{parentName:"p"},"Pagamentos permitidos:")," Determines which types of payments will be accepted by the module;")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("em",{parentName:"p"},"Dias para vencimento do Boleto:")," Determines how many days the ticket will expire after the date of generation;")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("em",{parentName:"p"},"Desconto para pagamento no Boleto:")," You can provide a discount to customers who pay by Boleto Banc\xe1rio;")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("em",{parentName:"p"},"Instru\xe7\xf5es no Boleto Banc\xe1rio:")," You can define four lines of up to 90 characters of instructions in Boleto Bancario. If the lines are not completed, the standard instructions will be displayed on the boleto;")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("em",{parentName:"p"},"Atualizar status dos pedidos do OpenCart automaticamente:")," Determines whether the module will be able to automatically update the status of an order according to the update notifications sent by Gerencianet;")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("em",{parentName:"p"},"Envio de e-mail autom\xe1tico da sua loja para notificar o cliente:")," Notifies the customer via email from your store when an automatic status update is performed. Regardless of the option, Gerencianet will send an email to the customer informing them of the charge;")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("em",{parentName:"p"},"Status:")," Determines whether the Gerencianet payments module is Active or Inactive."))),Object(o.b)("br",null),Object(o.b)("h3",{id:"credentials"},"Credentials"),Object(o.b)("p",null,Object(o.b)("img",Object(n.a)({parentName:"p"},{src:"../../img/opencart2.png",alt:"alt text"}))),Object(o.b)("p",null,'NIn this tab it is necessary to inform the credentials of your application, that is, the "Client_Id" and "Client_Secret" (see where to find it, according to the environment: ',Object(o.b)("a",{href:"https://s3.amazonaws.com/gerencianet-pub-prod-1/printscreen/2020/07/30/matheus.rodrigues/3d4208-de7a4092-1d7e-4526-9e20-dd7ed0329500.png",target:"_blank"},"desenvolvimento")," and ",Object(o.b)("a",{href:"https://s3.amazonaws.com/gerencianet-pub-prod-1/printscreen/2020/07/30/matheus.rodrigues/335826-79f10f33-9878-4898-8795-a49b798b7185.png",target:"_blank"},"produ\xe7\xe3o"),") of your application and the ",Object(o.b)("a",{href:"https://s3.amazonaws.com/gerencianet-pub-prod-1/printscreen/2020/07/24/matheus.rodrigues/b66b15-d2201967-d646-4988-8e39-cffae37df203.png",target:"_blank"},"account identifier")," obtained in the application created in Gerencianet."),Object(o.b)("br",null),Object(o.b)("h3",{id:"tab-purchase-status"},'Tab "Purchase Status"'),Object(o.b)("p",null,Object(o.b)("img",Object(n.a)({parentName:"p"},{src:"../../img/opencart3.png",alt:"alt text"}))),Object(o.b)("p",null,"In this tab is performed the configuration of the Gerencianet Payment Status with the Payment Status of your store. Thus, when there is a change in the payment status in Gerencianet, the order status in your store will be automatically updated according to the defined settings."),Object(o.b)("div",{className:"admonition admonition-caution alert alert--warning"},Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-heading"}),Object(o.b)("h5",{parentName:"div"},Object(o.b)("span",Object(n.a)({parentName:"h5"},{className:"admonition-icon"}),Object(o.b)("svg",Object(n.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"16",height:"16",viewBox:"0 0 16 16"}),Object(o.b)("path",Object(n.a)({parentName:"svg"},{fillRule:"evenodd",d:"M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"})))),"CAUTIONS")),Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-content"}),Object(o.b)("p",{parentName:"div"},"It is important to note that ",Object(o.b)("strong",{parentName:"p"},"boletos generated in sandbox are not valid and cannot be paid"),', they have the typeable line "zero" and a watermark at the bottom stating that it is a test ticket.'),Object(o.b)("p",{parentName:"div"},Object(o.b)("strong",{parentName:"p"},'Payments for sandbox charges using credit card are dummy even if using a "real" card.'),' All card payments in this environment will have the payment confirmed automatically, but this is just a status change to "Paid" . This feature allows you to test the ',Object(o.b)("code",null,"paid")," status notification."),Object(o.b)("p",{parentName:"div"},Object(o.b)("strong",{parentName:"p"},"This means that all payments made in the sandbox are not real and, therefore, there is no financial charge.")),Object(o.b)("p",{parentName:"div"},"It is important to know that the words ",Object(o.b)("strong",{parentName:"p"},"Playground, Sandbox and Development Environment"),", in the Gerencianet context, are synonymous in the sense that they refer to the test site we offer where you can freely test your API integration."))),Object(o.b)("br",null),Object(o.b)("h2",{id:"5-module-operation"},"5. Module Operation"),Object(o.b)("p",null,"After being enabled, the module will already be available as a payment option. Depending on your setting of whether or not to enable the ",Object(o.b)("code",null,"Checkout em um passo"),",  option, the page where the customer will enter their payment details will be different. If the ",Object(o.b)("code",null,"Checkout em um passo")," option is active, your customer will fill in the payment details on the same ",Object(o.b)("code",null,"Checkout")," screen, as shown in the figures below:"),Object(o.b)("p",null,Object(o.b)("img",Object(n.a)({parentName:"p"},{src:"../../img/opencart4.png",alt:"alt text",title:"Boleto"}))),Object(o.b)("p",null,Object(o.b)("img",Object(n.a)({parentName:"p"},{src:"../../img/opencart5.png",alt:"alt text",title:"Cart\xe3o"}))),Object(o.b)("p",null,"In this way, when clicking on ",Object(o.b)("code",null,"Checkout"),", the customer's data will be validated and, if everything is correct, the charge will be generated and the purchase completed. The customer is then redirected to the finalized purchase page."),Object(o.b)("p",null,"If the ",Object(o.b)("code",null,"One-step checkout")," option is not active, your customer will fill in the personal and delivery details on the ",Object(o.b)("code",null,"Checkout")," page and by clicking on ",Object(o.b)("code",null,"Confirm Order ")," will be redirected to another page to proceed with the payment, where you will choose the Gerencianet payment options, as shown below:"),Object(o.b)("p",null,Object(o.b)("img",Object(n.a)({parentName:"p"},{src:"../../img/opencart6.png",alt:"alt text",title:"Selecione a forma de pagamento"}))),Object(o.b)("br",null),Object(o.b)("p",null,"Both payment screens may change according to the theme used in the store."),Object(o.b)("br",null),Object(o.b)("div",{className:"admonition admonition-note alert alert--secondary"},Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-heading"}),Object(o.b)("h5",{parentName:"div"},Object(o.b)("span",Object(n.a)({parentName:"h5"},{className:"admonition-icon"}),Object(o.b)("svg",Object(n.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"14",height:"16",viewBox:"0 0 14 16"}),Object(o.b)("path",Object(n.a)({parentName:"svg"},{fillRule:"evenodd",d:"M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"})))),"NOTE")),Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-content"}),Object(o.b)("p",{parentName:"div"},"Sand any of the mandatory fields for making the payment is not filled in correctly, it will be charged again in the payment form. For ",Object(o.b)("strong",{parentName:"p"},"Boleto Banc\xe1rio"),", the mandatory fields are: ",Object(o.b)("strong",{parentName:"p"},"Nome, E-mail, CPF")," and ",Object(o.b)("strong",{parentName:"p"},"Telefone"),". For ",Object(o.b)("strong",{parentName:"p"},"Credit card"),", the mandatory fields are: ",Object(o.b)("strong",{parentName:"p"},"Nome, E-mail, CPF, data de nascimento, Telefone, Endere\xe7o, N\xfamero, Bairro, CEP, Cidade")," and ",Object(o.b)("strong",{parentName:"p"},"Estado"),"."))),Object(o.b)("br",null),Object(o.b)("h2",{id:"6-gerencianet-module-versions-for-opencart"},"6. Gerencianet Module Versions for OpenCart"),Object(o.b)("br",null),Object(o.b)("div",{className:"admonition admonition-note alert alert--secondary"},Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-heading"}),Object(o.b)("h5",{parentName:"div"},Object(o.b)("span",Object(n.a)({parentName:"h5"},{className:"admonition-icon"}),Object(o.b)("svg",Object(n.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"14",height:"16",viewBox:"0 0 14 16"}),Object(o.b)("path",Object(n.a)({parentName:"svg"},{fillRule:"evenodd",d:"M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"})))),"NOTE")),Object(o.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-content"}),Object(o.b)("p",{parentName:"div"},"During some tests carried out in Opencart 2.3.0.2 regarding the exchange of languages for Portuguese/Brazil, we observed a malfunction in the store, causing, for example, the exclusion of some products from the store, among other problems that were identified. We emphasize that these problems have nothing to do with the module provided by Gerencianet."),Object(o.b)("p",{parentName:"div"},"To resolve this, go to ",Object(o.b)("a",{href:"https://github.com/opencartbrasil/traducao/issues/27",target:"_blank"},"This issue")," on OpenCart Brasil github and check how to proceed."))),Object(o.b)("br",null),Object(o.b)("h2",{id:"7-frequent-questions"},"7. Frequent Questions"),Object(o.b)("br",null),Object(o.b)("h4",{id:"71is-it-mandatory-to-have-ssl-in-my-store-to-accept-payments-with-the-module"},"7.1.Is it mandatory to have SSL in my store to accept payments with the module?"),Object(o.b)("p",null,"For the Gerencianet module for OpenCart to work, it is not necessary for the store to have an SSL certificate. However, Gerencianet strongly recommends that shopkeepers use it. Regardless of its use, all payment data is encrypted and transmitted securely for payment validation. The presence of an SSL certificate installed in your store guarantees greater security for the merchant and for customers who make purchases. The absence of the SSL certificate on the payment screen can cause the merchant to lose sales, as the customer may feel insecure to enter payment data on a page that does not have a certificate."),Object(o.b)("br",null),Object(o.b)("h4",{id:"72-i-want-to-use-transparent-checkout-so-that-the-customer-does-not-leave-my-store-to-make-the-payment-its-possible"},"7.2. I want to use Transparent Checkout so that the customer does not leave my store to make the payment. It's possible?"),Object(o.b)("p",null,"Yes. The Gerencianet module for OpenCart uses the transparent checkout to pay customers, that is, at no time will the customer leave your virtual store to complete the payment. Thus, in the last step of the purchase, the customer will be asked for the mandatory data to make the payment."),Object(o.b)("br",null),Object(o.b)("h4",{id:"73-is-it-possible-to-use-the-marketplace-or-subscriptions-features-with-the-module"},"7.3. Is it possible to use the MarketPlace or Subscriptions features with the module?"),Object(o.b)("p",null,"Not yet. Follow our ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"../UltimasNovidades/changelog"}),"changelog")," para visualizar todas as novidades."),Object(o.b)("br",null),Object(o.b)("h4",{id:"74-payment-option-installments-are-not-loading-how-to-fix"},"7.4. Payment option installments are not loading. How to fix?"),Object(o.b)("p",null,'If, after installing and configuring the module, the credit card installments do not load when clicking on the card brands, the merchant must verify the credentials informed in the module configuration (Client_Id, Client_Secret keys and also the "identificador da conta" ("account identifier")). If they are correct, contact Gerencianet so that the problem can be analyzed.'),Object(o.b)("br",null),Object(o.b)("h4",{id:"75--im-getting-the-message-unauthorized-when-trying-to-complete-a-purchase-what-to-do"},"7.5.  I'm getting the message ",Object(o.b)("em",{parentName:"h4"},'"Unauthorized"')," when trying to complete a purchase. What to do?"),Object(o.b)("p",null,"This error message may be related to incorrectly entered credentials. Check that your credentials are correctly entered in the respective PRODU\xc7\xc3O and DESENVOLVIMENTO fields. Check it out in ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://gerencianet.com.br/artigo/estou-deparando-com-mensagem-de-unauthorized-sem-autorizacao-por-que/"}),"our FAQ")," informa\xe7\xf5es detalhadas."),Object(o.b)("br",null),Object(o.b)("h4",{id:"76-the-message-gerencianet-desabilitada-sandbox-mode-test-environment-is-active-your-charges-will-not-be-validated-how-to-fix"},"7.6. The message ",Object(o.b)("em",{parentName:"h4"},"\u201cGerencianet Desabilitada: Sandbox mode (Test Environment) is active. Your charges will not be validated\u201d"),". How to fix?"),Object(o.b)("p",null,"This message will be displayed when your module is configured in a test environment (sandbox). To remove this message and start receiving with Gerencianet, access the module settings in ",Object(o.b)("code",null,"Extensions > Payments > Gerencianet > Editar")," (or in ",Object(o.b)("code",null,"Extens\xf5es > Pagamentos > Gerencianet > Editar"),") and uncheck  ",Object(o.b)("code",null,"SandBox > Habilitar Sandbox Gerencianet (Ambiente de testes).")),Object(o.b)("br",null),Object(o.b)("h4",{id:"77-where-can-i-track-the-transactions-generated-by-the-module"},"7.7. Where can I track the transactions generated by the module?"),Object(o.b)("p",null,"Transactions generated through the module can be tracked in your Gestornet account at the link ",Object(o.b)("code",null,"API > Minhas Aplica\xe7\xf5es > Sua Aplica\xe7\xe3o"),". In this environment you will be able to follow all the transactions and their respective situations."),Object(o.b)("br",null),Object(o.b)("h4",{id:"78-qwhen-i-try-to-make-a-payment-i-get-the-message-there-was-an-error-trying-to-make-your-request-please-contact-the-store-owner"},"7.8. QWhen I try to make a payment I get the message *\u201cThere was an error trying to make your request. Please contact the store owner.\u201d"),Object(o.b)("p",null,'This error message can be displayed at checkout for a number of reasons. In this case, the first step is to verify your application\'s credentials and also check the "request history" subtab in your API ',Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"../../docs/VisaoGeral/InterpretandoErros"}),"see how to use this feature"),"."),Object(o.b)("br",null),Object(o.b)("hr",null),Object(o.b)("h2",{id:"8-support-and-suggestions"},"8. Support and Suggestions"),Object(o.b)("p",null,"Your suggestion of new ideas and implementations for the Gerencianet module for OpenCart is very important. So, if you have any ideas, please contact our team. We will analyze your suggestion and evaluate the possibility of implementation.."),Object(o.b)("p",null,"If you have any questions, please contact us via the website. ",Object(o.b)("a",{href:"https://gerencianet.com.br/",target:"_blank"},"Gerencianet"),".")))}s.isMDXComponent=!0},250:function(e,t,a){"use strict";a.d(t,"a",(function(){return d})),a.d(t,"b",(function(){return u}));var n=a(0),r=a.n(n);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function i(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function c(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?i(Object(a),!0).forEach((function(t){o(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):i(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function l(e,t){if(null==e)return{};var a,n,r=function(e,t){if(null==e)return{};var a,n,r={},o=Object.keys(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var b=r.a.createContext({}),s=function(e){var t=r.a.useContext(b),a=t;return e&&(a="function"==typeof e?e(t):c(c({},t),e)),a},d=function(e){var t=s(e.components);return r.a.createElement(b.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return r.a.createElement(r.a.Fragment,{},t)}},m=r.a.forwardRef((function(e,t){var a=e.components,n=e.mdxType,o=e.originalType,i=e.parentName,b=l(e,["components","mdxType","originalType","parentName"]),d=s(a),m=n,u=d["".concat(i,".").concat(m)]||d[m]||p[m]||o;return a?r.a.createElement(u,c(c({ref:t},b),{},{components:a})):r.a.createElement(u,c({ref:t},b))}));function u(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=a.length,i=new Array(o);i[0]=m;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:n,i[1]=c;for(var b=2;b<o;b++)i[b]=a[b];return r.a.createElement.apply(null,i)}return r.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"},251:function(e,t,a){"use strict";var n=a(0),r=a(35);t.a=function(){return Object(n.useContext)(r.a)}},252:function(e,t,a){"use strict";a.d(t,"a",(function(){return o}));var n=a(251),r=a(253);function o(e,{forcePrependBaseUrl:t=!1,absolute:a=!1}={}){const{siteConfig:{baseUrl:o="/",url:i}={}}=Object(n.a)();if(!e)return e;if(t)return o+e;if(!Object(r.a)(e))return e;const c=o+e.replace(/^\//,"");return a?i+c:c}},253:function(e,t,a){"use strict";function n(e){return!1===/^(https?:|\/\/|mailto:|tel:)/.test(e)}a.d(t,"a",(function(){return n}))}}]);