{"_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":31,"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","5a7c4127490e52002a7f643c"],"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\">/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.","excerpt":"Você está em: *\"Ambiente de Testes > Playground: Notificações\"*","slug":"playground-notificacoes","type":"basic","title":"Playground: Notificações"}

Visão Geral da API

Ambiente de Testes

Instalação da API (SDK's)

Pagar com Boleto

Pagar com Cartão

Assinaturas (Recorrência)

Carnês

Link de Pagamento

Marketplace

Checkout via Lightbox

Notificações (callbacks)

Sistemas Integrados

Módulos e Plugins

Exemplos de Integrações

Vídeos sobre Integrações

Outros Recursos da API

Autenticação e Endpoints

Fluxos de Processos

Últimas Novidades

Dúvidas?

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">/v1/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 /v1/notification/:token</code> que estão disponíveis para utilização: [block:image] { "images": [ { "image": [ "https://files.readme.io/caeb460-get-notification.png", "get-notification.png", 1386, 121, "#f1f1f1" ] } ] } [/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.