{"__v":45,"_id":"575eaab48be8aa0e00f59cdf","category":{"__v":0,"_id":"575aeffae12cf20e002f3070","project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-06-10T16:51:06.098Z","from_sync":false,"order":0,"slug":"documentation","title":"Visão Geral da API"},"parentDoc":null,"project":"575aeffae12cf20e002f306c","user":"575b077ae12cf20e002f30a3","version":{"__v":30,"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-13T12:44:36.702Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":2,"body":"O fluxo de **Transações ** da Gerencianet funciona da seguinte forma:\n\n<img src=\"https://files.readme.io/dxlrRwwDQve1kjszHxJ7_d096c05c6e2d490089ee7ee052435a53.png\" alt=\"Fluxo de transações Gerencianet - API\">\n\n## Tabela de status das transações\n\nTodas as transações possuem *status*, que representa a *situação* dessa transação. Confira alguns exemplos:\n\n- Ao gerar uma cobrança (também chamada de transação), esta possui o status inicial de <code>new</code>, ou seja, a cobrança foi gerada e está aguardando a definição da forma de pagamento;\n\n- Assim que essa transação tem sua forma de pagamento definida, seu status é alterado de <code>new</code> para <code>waiting</code>, ou seja, a forma de pagamento foi selecionada e está aguardando a confirmação do pagamento;\n\n- Quando a transação tem o pagamento confirmado, o status é alterado de <code>waiting</code> para <code>paid</code>, ou seja, o pagamento da transação foi confirmado;\n\n- Caso o boleto não seja pago, ou seja, não tenha seu pagamento confirmado, em 3 (três) dias após sua data de vencimento, seu status será alterado de <code>waiting</code> para <code>unpaid</code>;\n\n- Ao enviar uma requisição <code>POST</code> para a rota <code>/charge/:id/link</code>, ou consumir a função <code>linkCharge</code> em nossas SDKs, a cobrança vai alterar o status de <code>new</code> para <code>link</code>, e quando o pagador finalizar a compra na tela de pagamento da Gerencianet, o status passa a ser <code>waiting</code>.\n\nA seguir, confira a tabela contendo a relação de todos os possíveis status de uma transação:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Status da Transação\",\n    \"h-1\": \"Descrição\",\n    \"0-0\": \"new *(\\\"novo\\\")*\",\n    \"0-1\": \"Cobrança gerada, aguardando definição da forma de pagamento.\",\n    \"1-0\": \"waiting *(\\\"aguardando\\\")*\",\n    \"2-0\": \"paid *(\\\"pago\\\")*\",\n    \"1-1\": \"Forma de pagamento selecionada, aguardando a confirmação do pagamento.\",\n    \"2-1\": \"Pagamento confirmado.\",\n    \"3-0\": \"unpaid *(\\\"não pago\\\")*\",\n    \"3-1\": \"Não foi possível confirmar o pagamento da cobrança.\",\n    \"4-0\": \"refunded *(\\\"devolvido\\\")*\",\n    \"4-1\": \"Pagamento devolvido pelo lojista ou pelo intermediador Gerencianet.\",\n    \"5-0\": \"contested *(\\\"contestado\\\")*\",\n    \"5-1\": \"Pagamento em processo de contestação.\",\n    \"6-0\": \"canceled *(\\\"cancelado\\\")*\",\n    \"6-1\": \"Cobrança cancelada pelo vendedor ou pelo pagador.\",\n    \"7-0\": \"link *(\\\"link\\\")*\",\n    \"7-1\": \"Cobrança associada a um [link de pagamento](https://dev.gerencianet.com.br/docs/link-pagamento-introducao).\"\n  },\n  \"cols\": 2,\n  \"rows\": 8\n}\n[/block]\n## Tabela de status das assinaturas\n\nCaso queira, acesse a [tabela completa](https://dev.gerencianet.com.br/docs/assinaturas-como-funcionam) com os possíveis status das assinaturas.\n\n\n## Tabela de status dos carnês\n\nCaso queira, acesse a [tabela completa](https://dev.gerencianet.com.br/docs/carnes-como-funcionam) com os possíveis status dos carnês.","excerpt":"Você está em: *\"Visão Geral da API > Transações\"*","slug":"transacoes","type":"basic","title":"Transações"}

Transações

Você está em: *"Visão Geral da API > Transações"*

O fluxo de **Transações ** da Gerencianet funciona da seguinte forma: <img src="https://files.readme.io/dxlrRwwDQve1kjszHxJ7_d096c05c6e2d490089ee7ee052435a53.png" alt="Fluxo de transações Gerencianet - API"> ## Tabela de status das transações Todas as transações possuem *status*, que representa a *situação* dessa transação. Confira alguns exemplos: - Ao gerar uma cobrança (também chamada de transação), esta possui o status inicial de <code>new</code>, ou seja, a cobrança foi gerada e está aguardando a definição da forma de pagamento; - Assim que essa transação tem sua forma de pagamento definida, seu status é alterado de <code>new</code> para <code>waiting</code>, ou seja, a forma de pagamento foi selecionada e está aguardando a confirmação do pagamento; - Quando a transação tem o pagamento confirmado, o status é alterado de <code>waiting</code> para <code>paid</code>, ou seja, o pagamento da transação foi confirmado; - Caso o boleto não seja pago, ou seja, não tenha seu pagamento confirmado, em 3 (três) dias após sua data de vencimento, seu status será alterado de <code>waiting</code> para <code>unpaid</code>; - Ao enviar uma requisição <code>POST</code> para a rota <code>/charge/:id/link</code>, ou consumir a função <code>linkCharge</code> em nossas SDKs, a cobrança vai alterar o status de <code>new</code> para <code>link</code>, e quando o pagador finalizar a compra na tela de pagamento da Gerencianet, o status passa a ser <code>waiting</code>. A seguir, confira a tabela contendo a relação de todos os possíveis status de uma transação: [block:parameters] { "data": { "h-0": "Status da Transação", "h-1": "Descrição", "0-0": "new *(\"novo\")*", "0-1": "Cobrança gerada, aguardando definição da forma de pagamento.", "1-0": "waiting *(\"aguardando\")*", "2-0": "paid *(\"pago\")*", "1-1": "Forma de pagamento selecionada, aguardando a confirmação do pagamento.", "2-1": "Pagamento confirmado.", "3-0": "unpaid *(\"não pago\")*", "3-1": "Não foi possível confirmar o pagamento da cobrança.", "4-0": "refunded *(\"devolvido\")*", "4-1": "Pagamento devolvido pelo lojista ou pelo intermediador Gerencianet.", "5-0": "contested *(\"contestado\")*", "5-1": "Pagamento em processo de contestação.", "6-0": "canceled *(\"cancelado\")*", "6-1": "Cobrança cancelada pelo vendedor ou pelo pagador.", "7-0": "link *(\"link\")*", "7-1": "Cobrança associada a um [link de pagamento](https://dev.gerencianet.com.br/docs/link-pagamento-introducao)." }, "cols": 2, "rows": 8 } [/block] ## Tabela de status das assinaturas Caso queira, acesse a [tabela completa](https://dev.gerencianet.com.br/docs/assinaturas-como-funcionam) com os possíveis status das assinaturas. ## Tabela de status dos carnês Caso queira, acesse a [tabela completa](https://dev.gerencianet.com.br/docs/carnes-como-funcionam) com os possíveis status dos carnês.