{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Android","type":"basic","slug":"android","excerpt":"Saiba como instalar e configurar nossa SDK  Android para API Pix e API Boletos (Bolix)","body":"[block:html]\n{\n  \"html\": \"<p>Nossa API é <a href=\\\"https://en.wikipedia.org/wiki/Representational_state_transfer\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">RESTful</a> e responde em <a href=\\\"http://www.json.org/\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">JSON</a>. A Gerencianet utiliza <a href=\\\"http://oauth.net/\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">OAuth</a> para fornecer acesso autorizado à <abbr title=\\\"Application Programming Interface\\\">API</abbr>. Nossa SDK para Android já está preparada para realizar essa autenticação automaticamente.</p>\"\n}\n[/block]\nA seguir, confira os procedimentos para instalação da <a href=\"https://github.com/gerencianet/gn-api-sdk-android\" target=\"_blank\" title=\"Link Externo\">SDK para Android</a>:\n\n# 1. Pré-requisitos\n\n* Android <code>7.0+</code>\n\n#Instalação via gradle\n\n<pre>implementation 'br.com.gerencianet.mobile:gn-api-sdk-android:1.0.0'</pre>\n\n<hr>\n\n# Testado com\n\n- Android <code>7.0</code> e <code>11.0</code>\n\n<hr>\n\n# Uso Básico\n\nRequer o módulo e os pacotes:\n\n`import br.com.gerencianet.mobile.Gerencianet;`\n\nEmbora as respostas dos serviços da Web estejam no formato *json*, a SDK converterá qualquer resposta do servidor para um *Map <String, Object>*. O código deve estar dentro de um *try-catch* e as exceções podem ser tratadas da seguinte forma:\n\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"try {\\n\\n/* code */\\n\\n} catch(GerencianetException e) {\\n\\n/* Gerencianet's api errors will come here */\\n\\n} catch(Exception ex) {\\n\\n/* Other errors will come here */\\n\\n}\",\n      \"language\": \"java\",\n      \"name\": \"Android\"\n    }\n  ]\n}\n[/block]\n## Para ambiente de homologação\n\nInstanciar o módulo passando seu *Client_Id*, *Client_Secret* e *sandbox* sendo igual a *true*:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"HashMap<String, Object> options = new HashMap<String Object>();\\n\\noptions.put(\\\"client_id\\\", \\\"client_id \\\");\\n\\noptions.put(\\\"client_secret\\\", \\\"client_secret\\\");\\n\\noptions.put(\\\"sandbox\\\", true);\\n\\nGerencianet gn = new Gerencianet(options);\",\n      \"language\": \"java\",\n      \"name\": \"Homologação\"\n    }\n  ]\n}\n[/block]\n## Para ambiente de produção\n\nPara alterar o ambiente para produção, basta definir o terceiro *sandbox* como *false*, e seu *Client_Id* e *Client_Secret* de produção:\n\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"HashMap<String, Object> options = new HashMap<String Object>();\\n\\noptions.put(\\\"client_id\\\", \\\"client_id \\\");\\n\\noptions.put(\\\"client_secret\\\", \\\"client_secret\\\");\\n\\noptions.put(\\\"sandbox\\\", false);\\n\\nGerencianet gn = new Gerencianet(options);\",\n      \"language\": \"java\",\n      \"name\": \"Produção\"\n    }\n  ]\n}\n[/block]\n<br>\n# API PIX\n\nPara utilizar a API PIX, é necessário informar o caminho do certificado dentro da pasta *assets* e passar como parâmetro o *assets* do contexto.\n\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"HashMap<String, Object> options = new HashMap<String Object>();\\n\\noptions.put(\\\"client_id\\\", \\\"client_id \\\");\\n\\noptions.put(\\\"client_secret\\\", \\\"client_secret\\\");\\n\\noptions.put(\\\"pix_cert\\\", \\\"./cert.p12\\\");\\n\\noptions.put(\\\"sandbox\\\", false);\\n\\nGerencianet gn = new Gerencianet(options, context.getAssets());\",\n      \"language\": \"java\",\n      \"name\": \"API Pix\"\n    }\n  ]\n}\n[/block]","updates":[],"order":12,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"6138f098f485be00160dbeff","createdAt":"2021-09-08T17:19:20.673Z","user":"5e8b36bc27ee9b00181b36bf","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Instalação da API (SDK's)","slug":"instalação-da-api-sdks","order":6,"from_sync":false,"reference":false,"_id":"606f2ca6c5ba91007878343d","createdAt":"2017-03-10T12:37:05.075Z","project":"575aeffae12cf20e002f306c","version":"606f2ca7c5ba9100787834c6","__v":0},"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}

Android

Saiba como instalar e configurar nossa SDK Android para API Pix e API Boletos (Bolix)

[block:html] { "html": "<p>Nossa API é <a href=\"https://en.wikipedia.org/wiki/Representational_state_transfer\" target=\"_blank\" title=\"Link Externo\">RESTful</a> e responde em <a href=\"http://www.json.org/\" target=\"_blank\" title=\"Link Externo\">JSON</a>. A Gerencianet utiliza <a href=\"http://oauth.net/\" target=\"_blank\" title=\"Link Externo\">OAuth</a> para fornecer acesso autorizado à <abbr title=\"Application Programming Interface\">API</abbr>. Nossa SDK para Android já está preparada para realizar essa autenticação automaticamente.</p>" } [/block] A seguir, confira os procedimentos para instalação da <a href="https://github.com/gerencianet/gn-api-sdk-android" target="_blank" title="Link Externo">SDK para Android</a>: # 1. Pré-requisitos * Android <code>7.0+</code> #Instalação via gradle <pre>implementation 'br.com.gerencianet.mobile:gn-api-sdk-android:1.0.0'</pre> <hr> # Testado com - Android <code>7.0</code> e <code>11.0</code> <hr> # Uso Básico Requer o módulo e os pacotes: `import br.com.gerencianet.mobile.Gerencianet;` Embora as respostas dos serviços da Web estejam no formato *json*, a SDK converterá qualquer resposta do servidor para um *Map <String, Object>*. O código deve estar dentro de um *try-catch* e as exceções podem ser tratadas da seguinte forma: [block:code] { "codes": [ { "code": "try {\n\n/* code */\n\n} catch(GerencianetException e) {\n\n/* Gerencianet's api errors will come here */\n\n} catch(Exception ex) {\n\n/* Other errors will come here */\n\n}", "language": "java", "name": "Android" } ] } [/block] ## Para ambiente de homologação Instanciar o módulo passando seu *Client_Id*, *Client_Secret* e *sandbox* sendo igual a *true*: [block:code] { "codes": [ { "code": "HashMap<String, Object> options = new HashMap<String Object>();\n\noptions.put(\"client_id\", \"client_id \");\n\noptions.put(\"client_secret\", \"client_secret\");\n\noptions.put(\"sandbox\", true);\n\nGerencianet gn = new Gerencianet(options);", "language": "java", "name": "Homologação" } ] } [/block] ## Para ambiente de produção Para alterar o ambiente para produção, basta definir o terceiro *sandbox* como *false*, e seu *Client_Id* e *Client_Secret* de produção: [block:code] { "codes": [ { "code": "HashMap<String, Object> options = new HashMap<String Object>();\n\noptions.put(\"client_id\", \"client_id \");\n\noptions.put(\"client_secret\", \"client_secret\");\n\noptions.put(\"sandbox\", false);\n\nGerencianet gn = new Gerencianet(options);", "language": "java", "name": "Produção" } ] } [/block] <br> # API PIX Para utilizar a API PIX, é necessário informar o caminho do certificado dentro da pasta *assets* e passar como parâmetro o *assets* do contexto. [block:code] { "codes": [ { "code": "HashMap<String, Object> options = new HashMap<String Object>();\n\noptions.put(\"client_id\", \"client_id \");\n\noptions.put(\"client_secret\", \"client_secret\");\n\noptions.put(\"pix_cert\", \"./cert.p12\");\n\noptions.put(\"sandbox\", false);\n\nGerencianet gn = new Gerencianet(options, context.getAssets());", "language": "java", "name": "API Pix" } ] } [/block]