{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Playground: Notificações","type":"basic","slug":"playground-notificacoes","excerpt":"Você está em: *\"Ambiente de Testes > Playground: Notificações\"*","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 homologação/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\">/v1/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 /v1/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/caeb460-get-notification.png\",\n \"get-notification.png\",\n 1386,\n 121,\n \"#f1f1f1\"\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.","updates":[],"order":3,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"57866e8db2f4060e00fa39cb","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Ambiente de Testes","slug":"ambiente-de-testes","order":4,"from_sync":false,"reference":true,"_id":"57866e72b2f4060e00fa39ca","project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","createdAt":"2016-07-13T16:38:10.846Z","__v":0},"createdAt":"2016-07-13T16:38:37.663Z","user":"57601a13af3e090e00108059","version":{"version":"1","version_clean":"1.0.0","codename":"2016","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"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","5a7c4127490e52002a7f643c","5ce43ecb9e6a78002aae5c66","5ce7de70923530005cbe627a","5f9c614b7352f400665cd7f6"],"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":34},"githubsync":"","parentDoc":null,"project":"575aeffae12cf20e002f306c","__v":13}
Playground: Notificações
Você está em: *"Ambiente de Testes > Playground: Notificações"*