{"_id":"57866e8db2f4060e00fa39cb","category":{"_id":"57866e72b2f4060e00fa39ca","project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-07-13T16:38:10.846Z","from_sync":false,"order":1,"slug":"ambiente-de-testes","title":"Ambiente de Testes"},"user":"57601a13af3e090e00108059","version":{"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","__v":30,"createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","categories":["575aeffae12cf20e002f3070","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","57602fe5b82256240055c657","57602ff6c811102000cef302","576030909b1a9a220067ca40","57604518b82256240055c722","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","577680bf3cee3a0e00a000bc","577ff3b1ff48990e000c6806","5783f78c5cbce30e0074e2b7","5783f86292edb92200e6101c","5783f86dbfbba719003f0d8b","5783f8755cbce30e0074e2b8","5783f8b65cbce30e0074e2b9","5783f8bf5cbce30e0074e2ba","5783f8d8ce802f0e0087d574","578529f887c9280e0090394b","57852aeb87c9280e0090394d","57866e72b2f4060e00fa39ca","57ab6d5c39c2fd1900191879","57f39451ab0ee12000bef915","582499a0d90fa027009b259e","58c29df1258e5a1900b60478"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"2016","version_clean":"1.0.0","version":"1"},"parentDoc":null,"project":"575aeffae12cf20e002f306c","__v":13,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-13T16:38:37.663Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":3,"body":"Para acessar o ambiente de testes você precisa de uma conta Gerencianet. <a href=\"https://gerencianet.com.br/#abrirconta\" title=\"Cadastro ao nosso sistema, seja nosso cliente\" target=\"_blank\">Crie sua conta</a>.\n\nO Playground (também chamado de \"sandbox\") é um ambiente de desenvolvimento/testes no qual o integrador, independente da operação a ser realizada, pode utilizar para conhecer o mecanismo e o fluxo de pagamento em um ambiente 100% de teste e descomplicado. [Conheça mais](https://dev.gerencianet.com.br/docs/playground) sobre o Playground oferecido pela Gerencianet.\n\nUma transação gerada por meio da API pode passar por diversas alterações de status conforme interações do pagador, do integrador ou das operadoras e instituições bancárias envolvidas. Para acompanhar essas mudanças, é necessário preparar seu sistema para receber as notificações enviadas pela Gerencianet.\n\nPara definir uma URL que receberá as notificações de uma transação, é necessário cadastrá-la no momento da geração da cobrança ou, posteriormente, utilizando o método de alteração de URL de notificação.\n\nOutros detalhes sobre como receber as notificações, acesse o link \"<a href=\"https://dev.gerencianet.com.br/docs/notificacoes-recebendo\" target=\"_blank\">Recebendo as notificações</a>\".\n\nA seguir, confira o endpoint presente em nosso Playground, dentro da modalidade de \"Notificações\":\n\n<hr>\n\n<div class=\"distancia_top\"><a name=\"notification_token\"><span class=\"get\">GET</span></a><strong class=\"text-endpoint\">/notification/:token</strong></div>\n\nRetorna o histórico de notificações enviados a uma determinada transação.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>GET /notification/:token</code> que estão disponíveis para utilização:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/GC7HIEnQKSrXZUivpeFL_3de1635075d248e7be5793e583daeb38.png\",\n        \"3de1635075d248e7be5793e583daeb38.png\",\n        \"1431\",\n        \"127\",\n        \"#1aa4b8\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nA seguir, um JSON simples que pode ser utilizado para retornar o histórico de notificações enviadas a uma determinada transação. Além disso, é possível observar a saída prevista. Lembrando que também é preciso informar o parâmetro de entrada \"token\" da notificação desejada:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Parâmetro de entrada: informe o \\\"token\\\" da notificação desejada\",\n      \"language\": \"text\",\n      \"name\": \"Dados de Entrada\"\n    },\n    {\n      \"code\": \"{\\n  \\\"code\\\": 200,\\n  \\\"data\\\": [\\n    {\\n      \\\"id\\\": 1,\\n      \\\"type\\\": \\\"carnet\\\",\\n      \\\"custom_id\\\": \\\"25452545\\\",\\n      \\\"status\\\": {\\n        \\\"current\\\": \\\"active\\\",\\n        \\\"previous\\\": null\\n      },\\n      \\\"identifiers\\\": {\\n        \\\"carnet_id\\\": 8647\\n      },\\n      \\\"created_at\\\": \\\"2016-06-28 13:28:21\\\"\\n    },\\n    {\\n      \\\"id\\\": 2,\\n      \\\"type\\\": \\\"carnet_charge\\\",\\n      \\\"custom_id\\\": \\\"25452545\\\",\\n      \\\"status\\\": {\\n        \\\"current\\\": \\\"canceled\\\",\\n        \\\"previous\\\": \\\"waiting\\\"\\n      },\\n      \\\"identifiers\\\": {\\n        \\\"carnet_id\\\": 8647,\\n        \\\"charge_id\\\": 70712\\n      },\\n      \\\"created_at\\\": \\\"2016-06-28 14:21:37\\\"\\n    }\\n  ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Dados de Saída\"\n    }\n  ]\n}\n[/block]\nEsse JSON retorna o histórico de notificações enviadas a uma determinada transação, por meio do token de notificação informado.","excerpt":"Você está em: *\"Ambiente de Testes > Playground: Notificações\"*","slug":"playground-notificacoes","type":"basic","title":"Playground: Notificações"}

Playground: Notificações

Você está em: *"Ambiente de Testes > Playground: Notificações"*

Para acessar o ambiente de testes você precisa de uma conta Gerencianet. <a href="https://gerencianet.com.br/#abrirconta" title="Cadastro ao nosso sistema, seja nosso cliente" target="_blank">Crie sua conta</a>. O Playground (também chamado de "sandbox") é um ambiente de desenvolvimento/testes no qual o integrador, independente da operação a ser realizada, pode utilizar para conhecer o mecanismo e o fluxo de pagamento em um ambiente 100% de teste e descomplicado. [Conheça mais](https://dev.gerencianet.com.br/docs/playground) sobre o Playground oferecido pela Gerencianet. Uma transação gerada por meio da API pode passar por diversas alterações de status conforme interações do pagador, do integrador ou das operadoras e instituições bancárias envolvidas. Para acompanhar essas mudanças, é necessário preparar seu sistema para receber as notificações enviadas pela Gerencianet. Para definir uma URL que receberá as notificações de uma transação, é necessário cadastrá-la no momento da geração da cobrança ou, posteriormente, utilizando o método de alteração de URL de notificação. Outros detalhes sobre como receber as notificações, acesse o link "<a href="https://dev.gerencianet.com.br/docs/notificacoes-recebendo" target="_blank">Recebendo as notificações</a>". A seguir, confira o endpoint presente em nosso Playground, dentro da modalidade de "Notificações": <hr> <div class="distancia_top"><a name="notification_token"><span class="get">GET</span></a><strong class="text-endpoint">/notification/:token</strong></div> Retorna o histórico de notificações enviados a uma determinada transação. Na imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>GET /notification/:token</code> que estão disponíveis para utilização: [block:image] { "images": [ { "image": [ "https://files.readme.io/GC7HIEnQKSrXZUivpeFL_3de1635075d248e7be5793e583daeb38.png", "3de1635075d248e7be5793e583daeb38.png", "1431", "127", "#1aa4b8", "" ] } ] } [/block] A seguir, um JSON simples que pode ser utilizado para retornar o histórico de notificações enviadas a uma determinada transação. Além disso, é possível observar a saída prevista. Lembrando que também é preciso informar o parâmetro de entrada "token" da notificação desejada: [block:code] { "codes": [ { "code": "Parâmetro de entrada: informe o \"token\" da notificação desejada", "language": "text", "name": "Dados de Entrada" }, { "code": "{\n \"code\": 200,\n \"data\": [\n {\n \"id\": 1,\n \"type\": \"carnet\",\n \"custom_id\": \"25452545\",\n \"status\": {\n \"current\": \"active\",\n \"previous\": null\n },\n \"identifiers\": {\n \"carnet_id\": 8647\n },\n \"created_at\": \"2016-06-28 13:28:21\"\n },\n {\n \"id\": 2,\n \"type\": \"carnet_charge\",\n \"custom_id\": \"25452545\",\n \"status\": {\n \"current\": \"canceled\",\n \"previous\": \"waiting\"\n },\n \"identifiers\": {\n \"carnet_id\": 8647,\n \"charge_id\": 70712\n },\n \"created_at\": \"2016-06-28 14:21:37\"\n }\n ]\n}", "language": "json", "name": "Dados de Saída" } ] } [/block] Esse JSON retorna o histórico de notificações enviadas a uma determinada transação, por meio do token de notificação informado.