5e5eb21b.33a1acdd.js

(window.webpackJsonp=window.webpackJsonp||[]).push([[61],{162: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),o=a(6),r=(a(0),a(250)),i=(a(252),{id:"Joomla",title:"Joomla (VirtueMart)",hide_title:!0,sidebar_label:"Joomla (VirtueMart)"}),c={id:"Modulos/Joomla",isDocsHomePage:!1,title:"Joomla (VirtueMart)",description:"Joomla (VirtueMart)",source:"@site/docs\\Modulos\\Joomla.md",permalink:"/documentation/docs/Modulos/Joomla",sidebar_label:"Joomla (VirtueMart)",sidebar:"someSidebar",previous:{title:"Box Billing",permalink:"/documentation/docs/Modulos/BoxBilling"},next:{title:"Magento",permalink:"/documentation/docs/Modulos/Magento"}},l=[{value:"1. Requirements",id:"1-requirements",children:[]},{value:"2. Installation",id:"2-installation",children:[]},{value:"3. Settings",id:"3-settings",children:[{value:"Payment Plugin Settings",id:"payment-plugin-settings",children:[]},{value:"Campos Extras Obrigat\xf3rios",id:"campos-extras-obrigat\xf3rios",children:[]},{value:"Configura\xe7\xf5es do Boleto Banc\xe1rio",id:"configura\xe7\xf5es-do-boleto-banc\xe1rio",children:[]}]},{value:"4. Erros Comuns de Integra\xe7\xe3o:",id:"4-erros-comuns-de-integra\xe7\xe3o",children:[]}],b={rightToc:l};function s(e){var t=e.components,a=Object(o.a)(e,["components"]);return Object(r.b)("wrapper",Object(n.a)({},b,a,{components:t,mdxType:"MDXLayout"}),Object(r.b)("h1",{className:"titulo"},"Joomla (VirtueMart)"),Object(r.b)("div",{className:"subtitulo"},Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"Gerencianet Integration Module for Official VirtueMart- Version 0.2.1")),Object(r.b)("p",null,"The Gerencianet module for Joomla (VirtueMart) allows you to receive payments through the ",Object(r.b)("strong",null,"transparent checkout of our API"),". Compatible with Virtuemart 3 and Joomla! 2.5."),Object(r.b)("p",null,"This is the Official Integration Module provided by Gerencianet for VirtueMart. With it, the store owner can choose to receive payments by boleto and/or credit card. The entire process is carried out through the transparent checkout. With this, the buyer does not need to leave the store's website to make the payment."),Object(r.b)("p",null,'Some information such as "CPF", "address number", "neighborhood" and "date of birth" may be requested at the time of payment, if the fields are not configured as indicated.'),Object(r.b)("div",{className:"admonition admonition-important alert alert--info"},Object(r.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-heading"}),Object(r.b)("h5",{parentName:"div"},Object(r.b)("span",Object(n.a)({parentName:"h5"},{className:"admonition-icon"}),Object(r.b)("svg",Object(n.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"14",height:"16",viewBox:"0 0 14 16"}),Object(r.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(r.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-content"}),Object(r.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(r.b)("a",Object(n.a)({parentName:"p"},{href:"../Bolix/bolix"}),"here"),"."))),Object(r.b)("br",null),Object(r.b)("h2",{id:"1-requirements"},"1. Requirements"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"PHP version: ",Object(r.b)("inlineCode",{parentName:"li"},"5.4.0")," \xe0 ",Object(r.b)("inlineCode",{parentName:"li"},"7.0.3")),Object(r.b)("li",{parentName:"ul"},"Minimal version of VirtueMart: ",Object(r.b)("inlineCode",{parentName:"li"},"3.0")),Object(r.b)("li",{parentName:"ul"},"Minimal version of Joomla!: ",Object(r.b)("inlineCode",{parentName:"li"},"2.5"))),Object(r.b)("br",null),Object(r.b)("hr",null),Object(r.b)("h2",{id:"2-installation"},"2. Installation"),Object(r.b)("ol",null,Object(r.b)("li",{parentName:"ol"},Object(r.b)("p",{parentName:"li"},"Download the ",Object(r.b)("a",{href:"https://github.com/gerencianet/gn-api-virtuemart/archive/master.zip",target:"_blank"},"latest version of the plugin"),";")),Object(r.b)("li",{parentName:"ol"},Object(r.b)("p",{parentName:"li"},"In your store acess the link ",Object(r.b)("code",null,"Extensions > Manage > Install")," and send the file ",Object(r.b)("code",null,"gn-api-virtuemart.zip")," or extract the contents of the file inside the plugins directory of the store;")),Object(r.b)("li",{parentName:"ol"},Object(r.b)("p",{parentName:"li"},"Configure the plugin as instructed below and start receiving payments with Gerencianet."))),Object(r.b)("br",null),Object(r.b)("hr",null),Object(r.b)("h2",{id:"3-settings"},"3. Settings"),Object(r.b)("ol",null,Object(r.b)("li",{parentName:"ol"},"First, ",Object(r.b)("a",{href:"https://gerencianet.com.br/#abrirconta",target:"_blank",title:"Cadastro ao nosso sistema, seja nosso cliente"},"create your free Gerencianet account"),";")),Object(r.b)("p",null,"2.Create 3 extra fields in Virtuemart: ",Object(r.b)("code",null,"numero")," //number, ",Object(r.b)("code",null,"bairro")," //neighborhood and ",Object(r.b)("code",null,"data_nascimento")," //birth date. The house number, neighborhood and date of birth are mandatory data for payment by credit card. If it is not informed in the registration form or in the cart, it will be requested at the time of payment;"),Object(r.b)("ol",{start:3},Object(r.b)("li",{parentName:"ol"},Object(r.b)("p",{parentName:"li"},"Enable the plugin in ",Object(r.b)("code",null,"Administrar Plugins"),";")),Object(r.b)("li",{parentName:"ol"},Object(r.b)("p",{parentName:"li"},"Install our plugin through the screen ",Object(r.b)("code",null,"M\xe9todos de pagamento"),";")),Object(r.b)("li",{parentName:"ol"},Object(r.b)("p",{parentName:"li"},"Click in ",Object(r.b)("code",null,"Novo M\xe9todo de Pagamento")," and fill in the following information:"))),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("code",null,"Nome do Pagamento:")," Cart\xf5es de cr\xe9dito ou Boleto Banc\xe1rio ( Gerencianet );"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("code",null,"Publicado:")," Sim;"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("code",null,"Descri\xe7\xe3o do pagamento:")," Pague com Cart\xe3o de Cr\xe9dito ou Boleto Banc\xe1rio;"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("code",null,"M\xe9todo de pagamento:")," Gerencianet;"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("code",null,"Grupo de Compradores:")," -default-")),Object(r.b)("ol",{start:6},Object(r.b)("li",{parentName:"ol"},Object(r.b)("p",{parentName:"li"},"Click in ",Object(r.b)("inlineCode",{parentName:"p"},"Salvar"),";")),Object(r.b)("li",{parentName:"ol"},Object(r.b)("p",{parentName:"li"},"In the tab ",Object(r.b)("inlineCode",{parentName:"p"},"Configura\xe7\xf5es"),",  fill in the following information:"))),Object(r.b)("br",null),Object(r.b)("h3",{id:"payment-plugin-settings"},"Payment Plugin Settings"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("code",null,"Modo de teste:")," Sim ou N\xe3o;")),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("code",null,"Client ID Desenvolvimento"),": em sua conta Gerencianet, acesse ",Object(r.b)("code",null,"API > Minhas Aplica\xe7\xf5es"),", selecione sua aplica\xe7\xe3o e clique na aba ",Object(r.b)("code",null,"Desenvolvimento"),";")),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("code",null,"Client Secret Desenvolvimento")," Conta Gerencianet > API > Aplica\xe7\xf5es > Sua Aplica\xe7\xe3o > Client Secret Desenvolvimento")),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("code",null,"Client ID Produ\xe7\xe3o")," Conta Gerencianet > API > Aplica\xe7\xf5es > Sua Aplica\xe7\xe3o > Client ID Produ\xe7\xe3o")),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("code",null,"Client Secret Produ\xe7\xe3o"),' Conta Gerencianet > API > Aplica\xe7\xf5es > Sua Aplica\xe7\xe3o > Client Secret Produ\xe7\xe3o As credenciais devem ser da sua Aplica\xe7\xe3o na Gerencianet. Para criar uma nova Aplica\xe7\xe3o, entre em sua conta Gerencianet, acesse o menu "API" e clique em "Minhas Aplica\xe7\xf5es" -> "Nova aplica\xe7\xe3o".')),Object(r.b)("div",{className:"admonition admonition-note alert alert--secondary"},Object(r.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-heading"}),Object(r.b)("h5",{parentName:"div"},Object(r.b)("span",Object(n.a)({parentName:"h5"},{className:"admonition-icon"}),Object(r.b)("svg",Object(n.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"14",height:"16",viewBox:"0 0 14 16"}),Object(r.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"})))),"Observa\xe7\xe3o:")),Object(r.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-content"}),Object(r.b)("p",{parentName:"div"},'Para criar sua aplica\xe7\xe3o, logue em sua conta Gerencianet, acesse o menu superior "API", depois clique em "',Object(r.b)("em",{parentName:"p"},"Minhas Aplica\xe7\xf5es > Nova Aplica\xe7\xe3o"),'" e defina um nome para a sua aplica\xe7\xe3o.'))),Object(r.b)("br",null),Object(r.b)("h3",{id:"campos-extras-obrigat\xf3rios"},"Campos Extras Obrigat\xf3rios"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"Campo Logradouro (do endere\xe7o)"),Object(r.b)("li",{parentName:"ul"},"Campo Bairro"),Object(r.b)("li",{parentName:"ul"},"Campo N\xfamero (do endere\xe7o)"),Object(r.b)("li",{parentName:"ul"},"Campo Complemento (do endere\xe7o)"),Object(r.b)("li",{parentName:"ul"},"Campo Telefone (do cliente)"),Object(r.b)("li",{parentName:"ul"},"Campo CPF (do cliente)"),Object(r.b)("li",{parentName:"ul"},"Campo Data de Nascimento (do cliente)")),Object(r.b)("br",null),Object(r.b)("h3",{id:"configura\xe7\xf5es-do-boleto-banc\xe1rio"},"Configura\xe7\xf5es do Boleto Banc\xe1rio"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"Dias para vencimento"),Object(r.b)("li",{parentName:"ul"},"Desconto para pagamento no Boleto")),Object(r.b)("p",null,"Recomendamos que antes de disponibilizar pagamentos pela Gerencianet, o lojista realize testes de cobran\xe7a com o sandbox (ambiente de testes) ativado para verificar se o procedimento de pagamento est\xe1 acontecendo conforme esperado."),Object(r.b)("div",{className:"admonition admonition-caution alert alert--warning"},Object(r.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-heading"}),Object(r.b)("h5",{parentName:"div"},Object(r.b)("span",Object(n.a)({parentName:"h5"},{className:"admonition-icon"}),Object(r.b)("svg",Object(n.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"16",height:"16",viewBox:"0 0 16 16"}),Object(r.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"})))),"ATEN\xc7\xc3O")),Object(r.b)("div",Object(n.a)({parentName:"div"},{className:"admonition-content"}),Object(r.b)("p",{parentName:"div"},"Importante salientar que ",Object(r.b)("strong",{parentName:"p"},"os boletos gerados em sandbox n\xe3o s\xe3o v\xe1lidos e n\xe3o podem ser pagos"),', possuem a linha digit\xe1vel "zerada" e uma marca d\'\xe1gua ao fundo informando ser um boleto de teste.'),Object(r.b)("p",{parentName:"div"},Object(r.b)("strong",{parentName:"p"},'Os pagamentos de cobran\xe7as de sandbox utilizando cart\xe3o de cr\xe9dito s\xe3o fict\xedcios, mesmo se utilizar um cart\xe3o "real".'),' Todos os pagamentos de cart\xe3o neste ambiente ter\xe3o o pagamento confirmado automaticamente, mas \xe9 apenas uma altera\xe7\xe3o de status para "Pago". Este recurso permite que voc\xea teste a notifica\xe7\xe3o do status ',Object(r.b)("code",null,"paid"),"."),Object(r.b)("p",{parentName:"div"},Object(r.b)("strong",{parentName:"p"},"Isso significa que todos os pagamentos realizados em sandbox n\xe3o s\xe3o reais e, portanto, n\xe3o h\xe1 cobran\xe7a de nenhuma import\xe2ncia financeira.")," "),Object(r.b)("p",{parentName:"div"},"\xc9 importante saber que as palavras ",Object(r.b)("strong",{parentName:"p"},"Playground, Sandbox e Ambiente de Desenvolvimento"),", no contexto da Gerencianet, s\xe3o sin\xf4nimos no sentido de fazerem refer\xeancia ao local de testes que oferecemos em que voc\xea pode testar \xe0 vontade sua integra\xe7\xe3o com a API."))),Object(r.b)("br",null),Object(r.b)("br",null),Object(r.b)("hr",null),Object(r.b)("h2",{id:"4-erros-comuns-de-integra\xe7\xe3o"},"4. Erros Comuns de Integra\xe7\xe3o:"),Object(r.b)("p",null,'Ainda que nenhum destes erros de valida\xe7\xe3o sejam retornados, a API Gerencianet poder\xe1 retornar erros referentes \xe0 gera\xe7\xe3o da cobran\xe7a. Para interpretar os retornos da API e, claro, corrigir poss\xedveis erros de valida\xe7\xe3o de dados ou outros similares, acesse a "',Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"../../docs/VisaoGeral/InterpretandoErros"}),"p\xe1gina"),'".')))}s.isMDXComponent=!0},250:function(e,t,a){"use strict";a.d(t,"a",(function(){return u})),a.d(t,"b",(function(){return p}));var n=a(0),o=a.n(n);function r(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){r(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,o=function(e,t){if(null==e)return{};var a,n,o={},r=Object.keys(e);for(n=0;n<r.length;n++)a=r[n],t.indexOf(a)>=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(n=0;n<r.length;n++)a=r[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var b=o.a.createContext({}),s=function(e){var t=o.a.useContext(b),a=t;return e&&(a="function"==typeof e?e(t):c(c({},t),e)),a},u=function(e){var t=s(e.components);return o.a.createElement(b.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},m=o.a.forwardRef((function(e,t){var a=e.components,n=e.mdxType,r=e.originalType,i=e.parentName,b=l(e,["components","mdxType","originalType","parentName"]),u=s(a),m=n,p=u["".concat(i,".").concat(m)]||u[m]||d[m]||r;return a?o.a.createElement(p,c(c({ref:t},b),{},{components:a})):o.a.createElement(p,c({ref:t},b))}));function p(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=a.length,i=new Array(r);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<r;b++)i[b]=a[b];return o.a.createElement.apply(null,i)}return o.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"},251:function(e,t,a){"use strict";var n=a(0),o=a(35);t.a=function(){return Object(n.useContext)(o.a)}},252:function(e,t,a){"use strict";a.d(t,"a",(function(){return r}));var n=a(251),o=a(253);function r(e,{forcePrependBaseUrl:t=!1,absolute:a=!1}={}){const{siteConfig:{baseUrl:r="/",url:i}={}}=Object(n.a)();if(!e)return e;if(t)return r+e;if(!Object(o.a)(e))return e;const c=r+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}))}}]);