09749345.7a704456.js

(window.webpackJsonp=window.webpackJsonp||[]).push([[12],{108:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return i})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return u}));var a=n(2),o=n(6),r=(n(0),n(250)),i={id:"fluxo",title:"Fluxo de integra\xe7\xe3o",hide_title:!0,sidebar_label:"Integration Flow"},c={id:"VisaoGeral/fluxo",isDocsHomePage:!1,title:"Fluxo de integra\xe7\xe3o",description:"Integration Flow",source:"@site/docs\\VisaoGeral\\fluxo.md",permalink:"/documentation/docs/VisaoGeral/fluxo",sidebar_label:"Integration Flow",sidebar:"someSidebar",previous:{title:"Introdu\xe7\xe3o",permalink:"/documentation/docs/VisaoGeral/introducao"},next:{title:"Status das transa\xe7\xf5es",permalink:"/documentation/docs/VisaoGeral/statusTransacoes"}},l=[{value:"1. Create your digital account on Gerencianet",id:"1-create-your-digital-account-on-gerencianet",children:[]},{value:"2. Configure your preferences",id:"2-configure-your-preferences",children:[]},{value:"3. Choose the type of integration",id:"3-choose-the-type-of-integration",children:[]},{value:"4. Explore our testing environment",id:"4-explore-our-testing-environment",children:[]},{value:"5. Check out our API responses during your Playground tests",id:"5-check-out-our-api-responses-during-your-playground-tests",children:[]},{value:"6. Check out our available SDKs and choose your language",id:"6-check-out-our-available-sdks-and-choose-your-language",children:[]},{value:"7. What is your need?",id:"7-what-is-your-need",children:[]},{value:"8. Finished the tests and want to put it in the real production environment?",id:"8-finished-the-tests-and-want-to-put-it-in-the-real-production-environment",children:[]},{value:"9. Ready",id:"9-ready",children:[]}],s={rightToc:l};function u(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(r.b)("wrapper",Object(a.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(r.b)("h1",{className:"titulo"},"Integration Flow"),Object(r.b)("div",{className:"subtitulo"},Object(r.b)("p",null,"Ready to start using Gerencianet? This is a short list to help you get started with our payment solutions:"),Object(r.b)("h3",{id:"1-create-your-digital-account-on-gerencianet"},"1. Create your digital account on Gerencianet"),Object(r.b)("p",null,"If you do not yet have a Gerencianet Digital Account, ",Object(r.b)("a",{href:"https://gerencianet.com.br/abrir-conta",target:"_blank",title:"Link Externo"},"make your registration")," right now! It will be your identification, as well as the space to issue charges and carry out the financial management of your business."),Object(r.b)("br",null),Object(r.b)("h3",{id:"2-configure-your-preferences"},"2. Configure your preferences"),Object(r.b)("p",null,"After creating your Gerencianet account, you will be able to configure the following elements:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"Insert your logo;"),Object(r.b)("li",{parentName:"ul"},"Set the text for the card invoice;"),Object(r.b)("li",{parentName:"ul"},"Configure fine/interest rate;"),Object(r.b)("li",{parentName:"ul"},"Configure fancy name;"),Object(r.b)("li",{parentName:"ul"},"Among other options.")),Object(r.b)("br",null),Object(r.b)("h3",{id:"3-choose-the-type-of-integration"},"3. Choose the type of integration"),Object(r.b)("p",null,"Do you already know which integration you are going to use? We prepare a ",Object(r.b)("a",{href:"../VisaoGeral/tiposIntegracao",target:"_blank",title:"Link Interno"},"table summarizing the integrations")," and available forms of use, access and choose the one that best meets your needs."),Object(r.b)("p",null,"If you are going to use a payment button or subscription button, you can finish reading this step and follow the information that is in your Gestoret account as soon as you generate the desired button."),Object(r.b)("br",null),Object(r.b)("h3",{id:"4-explore-our-testing-environment"},"4. Explore our testing environment"),Object(r.b)("p",null,"Gerencianet offers two ways to use the test environment (sandbox): (a) within your Gerencianet account through the Playground or (b) using your ",Object(r.b)("em",{parentName:"p"},"Client_Id")," and ",Object(r.b)("em",{parentName:"p"},"Client_Secret")," development keys:"),Object(r.b)("p",null,"(a) The Playground is an isolated environment, similar to the production environment - it's the place within your Gestornet account where you can test API features online, without having to program. It's simple, see:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("p",{parentName:"li"},"Di ",Object(r.b)("a",{href:"https://gerencianet.com.br/#login",target:"_blank",title:"Link Externo"},"login")," in your Gerencianet account, access the menu ",Object(r.b)("em",{parentName:"p"},'"API"'),", after ",Object(r.b)("em",{parentName:"p"},'"Minhas Aplica\xe7\xf5es > Nova aplica\xe7\xe3o"')," (?), defining a name for your application; and")),Object(r.b)("li",{parentName:"ul"},Object(r.b)("p",{parentName:"li"},"From now on, see how to use our Playground and copy the codes provided in the Test Environment section of the documentation and explore the Playground."))),Object(r.b)("p",null,"(b) You can also perform integration tests directly on your application/system before going to the production environment. For this, use your ",Object(r.b)("em",{parentName:"p"},"Client_Id")," and ",Object(r.b)("em",{parentName:"p"},"Client_Secret"),' keys from the "Development" tab (?).'),Object(r.b)("p",null,"Para complementar, oferecemos v\xeddeos ensinando mais sobre a API e o Playground:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("p",{parentName:"li"},"V\xeddeo: ",Object(r.b)("a",{href:"https://www.youtube.com/watch?v=oy4aydoLUZA&index=5&list=PLRqvcUTH2VsWKL03a0dUMaPobAKUSXyxt",target:"_blank",title:"Link Externo"},"Gerencianet API"))),Object(r.b)("li",{parentName:"ul"},Object(r.b)("p",{parentName:"li"},"V\xeddeo: ",Object(r.b)("a",{href:"https://www.youtube.com/watch?v=nKPb0rU8j4Q&index=6&list=PLRqvcUTH2VsWKL03a0dUMaPobAKUSXyxt",target:"_blank",title:"Link Externo"},"Playground Methods (Management test environment/sandbox)"))),Object(r.b)("li",{parentName:"ul"},Object(r.b)("p",{parentName:"li"},"V\xeddeo: ",Object(r.b)("a",{href:"https://www.youtube.com/watch?v=ylqJUpHqwfY&index=7&list=PLRqvcUTH2VsWKL03a0dUMaPobAKUSXyxt",target:"_blank",title:"Link Externo"},"Creating a transaction via Playground (Management test environment/sandbox)")))),Object(r.b)("br",null),Object(r.b)("h3",{id:"5-check-out-our-api-responses-during-your-playground-tests"},"5. Check out our API responses during your Playground tests"),Object(r.b)("p",null,"Explore the Request History sub-tab to view all requests made by your management system or integration with the Gerencianet API. Thus, you will learn to interpret the Gerencianet API returns and correct possible data validation errors or similar ones."),Object(r.b)("p",null,"Also be sure to check the Notification History sub-tab, which allows you to view the POSTs that Gestoranet fires to the notification URL defined by the integrator."),Object(r.b)("p",null,'All procedures performed in the Playground (sandbox) will be listed in the "Homologation" sub-tab.'),Object(r.b)("a",{href:"https://www.youtube.com/watch?v=ad0SYoeGAZs",target:"_blank",title:"Link Externo"},"Watch the video"),' where we teach you how to use the "Request History".',Object(r.b)("br",null),Object(r.b)("br",null),Object(r.b)("h3",{id:"6-check-out-our-available-sdks-and-choose-your-language"},"6. Check out our available SDKs and choose your language"),Object(r.b)("p",null,"We currently provide SDKs in the following languages: ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"../Instalacao/php"}),"PHP"),", ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"../Instalacao/node"}),"NodeJS"),", ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"../Instalacao/ruby"}),"Ruby"),", ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"../Instalacao/python"}),"Python"),", ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"../Instalacao/c"}),".NET"),", ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"../Instalacao/java"}),"Java"),", ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"../Instalacao/delphi"}),"Delphi"),", ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"../Instalacao/go"}),"GO"),", ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"../Instalacao/android"}),"Android")," e ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"../Instalacao/flutter"}),"Flutter")),Object(r.b)("p",null,"Be sure to check out our API documentation to see the available resources (endpoints). Choose the ones you want and include them in your system integration."),Object(r.b)("h3",{id:"7-what-is-your-need"},"7. What is your need?"),Object(r.b)("p",null,"To help direct you if your need is:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"Learn more about the Gerencianet test environment;"),Object(r.b)("li",{parentName:"ul"},"Generate boleto banc\xe1rio;"),Object(r.b)("li",{parentName:"ul"},"Generate a balance sheet;"),Object(r.b)("li",{parentName:"ul"},"Generate payment via credit card;"),Object(r.b)("li",{parentName:"ul"},"Create recurring billing (subscriptions);"),Object(r.b)("li",{parentName:"ul"},"Issue carnets;"),Object(r.b)("li",{parentName:"ul"},"Use marketplace;"),Object(r.b)("li",{parentName:"ul"},"Create payment link;"),Object(r.b)("li",{parentName:"ul"},"Use Gerencianet on WooCommerce (WordPress), Magento, PrestaShop, OpenCart, WHMCS, Box Billing or Joomla (VirtueMart) platforms;"),Object(r.b)("li",{parentName:"ul"},"Use Gerencianet in another system.")),Object(r.b)("br",null),Object(r.b)("h3",{id:"8-finished-the-tests-and-want-to-put-it-in-the-real-production-environment"},"8. Finished the tests and want to put it in the real production environment?"),Object(r.b)("p",null,'After making sure your implementation is correct and your integrations are communicating the way they should, it\'s time to move to the production environment (which is the "real environment", with "real" transactions).'),Object(r.b)("p",null,'In your application/system, provide the Client_Id and Client_Secret key pair from the "Production" tab and change the value of the ',Object(r.b)("inlineCode",{parentName:"p"},"'sandbox'")," attribute from ",Object(r.b)("em",{parentName:"p"},"true")," to ",Object(r.b)("em",{parentName:"p"},"false"),". Only that."),Object(r.b)("div",{className:"admonition admonition-important alert alert--info"},Object(r.b)("div",Object(a.a)({parentName:"div"},{className:"admonition-heading"}),Object(r.b)("h5",{parentName:"div"},Object(r.b)("span",Object(a.a)({parentName:"h5"},{className:"admonition-icon"}),Object(r.b)("svg",Object(a.a)({parentName:"span"},{xmlns:"http://www.w3.org/2000/svg",width:"14",height:"16",viewBox:"0 0 14 16"}),Object(r.b)("path",Object(a.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(r.b)("div",Object(a.a)({parentName:"div"},{className:"admonition-content"}),Object(r.b)("p",{parentName:"div"},'Don\'t forget to include the "Notification URL" feature in your integration, as this feature allows your system to receive transaction callbacks (eg when a boleto is paid, canceled, defaulted, etc). For more details, see the notifications documentation.'))),Object(r.b)("br",null),Object(r.b)("h3",{id:"9-ready"},"9. Ready"),Object(r.b)("p",null,"At this point, you can proceed with your activities as normal. If you want to know more about the Gerencianet API, browse the ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"Introducao.md"}),"other sections of our documentation")," to know and explore the features and possibilities of integrations offered.")))}u.isMDXComponent=!0},250:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return h}));var a=n(0),o=n.n(a);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?i(Object(n),!0).forEach((function(t){r(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):i(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,o=function(e,t){if(null==e)return{};var n,a,o={},r=Object.keys(e);for(a=0;a<r.length;a++)n=r[a],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a<r.length;a++)n=r[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var s=o.a.createContext({}),u=function(e){var t=o.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):c(c({},t),e)),n},b=function(e){var t=u(e.components);return o.a.createElement(s.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},d=o.a.forwardRef((function(e,t){var n=e.components,a=e.mdxType,r=e.originalType,i=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),b=u(n),d=a,h=b["".concat(i,".").concat(d)]||b[d]||p[d]||r;return n?o.a.createElement(h,c(c({ref:t},s),{},{components:n})):o.a.createElement(h,c({ref:t},s))}));function h(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var r=n.length,i=new Array(r);i[0]=d;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:a,i[1]=c;for(var s=2;s<r;s++)i[s]=n[s];return o.a.createElement.apply(null,i)}return o.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);