{"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":"Em nosso playground notificações você encontra as informações de cada endpoint e como utilizá-los em ambiente de testes","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":"606f2ca7c5ba91007878346a","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Ambiente de Testes","slug":"ambiente-de-testes","order":7,"from_sync":false,"reference":true,"_id":"606f2ca6c5ba910078783439","project":"575aeffae12cf20e002f306c","version":"606f2ca7c5ba9100787834c6","createdAt":"2016-07-13T16:38:10.846Z","__v":0},"createdAt":"2016-07-13T16:38:37.663Z","user":"57601a13af3e090e00108059","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","61473375119247002a9c14d7","6283a3819575c60045513ea2"],"_id":"606f2ca7c5ba9100787834c6","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":4,"forked_from":"575aeffae12cf20e002f306f"},"githubsync":"","parentDoc":null,"project":"575aeffae12cf20e002f306c","__v":13}