{"__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":false,"order":2,"body":"O fluxo de **Transações ** da Gerencianet funciona da seguinte forma:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/dxlrRwwDQve1kjszHxJ7_d096c05c6e2d490089ee7ee052435a53.png\",\n        \"d096c05c6e2d490089ee7ee052435a53.png\",\n        \"809\",\n        \"455\",\n        \"#068c85\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n## Tabela de status das transações\n<hr>\n\nTodas as transações possuem \"status\", que nada mais é do que a *situação* dessa transação. Confira a seguir 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 consumir o endpoint <code>POST /charge/:id/link</code>, ou 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, 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<hr>\n\nCaso queira, acesse a [tabela completa](https://dev.gerencianet.com.br/docs/assinaturas-como-funcionam) de status das assinaturas.\n\n\n## Tabela de status dos carnês\n<hr>\n\nCaso queira, acesse a [tabela completa](https://dev.gerencianet.com.br/docs/carnes-como-funcionam) de 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: [block:image] { "images": [ { "image": [ "https://files.readme.io/dxlrRwwDQve1kjszHxJ7_d096c05c6e2d490089ee7ee052435a53.png", "d096c05c6e2d490089ee7ee052435a53.png", "809", "455", "#068c85", "" ] } ] } [/block] ## Tabela de status das transações <hr> Todas as transações possuem "status", que nada mais é do que a *situação* dessa transação. Confira a seguir 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 consumir o endpoint <code>POST /charge/:id/link</code>, ou 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, 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 <hr> Caso queira, acesse a [tabela completa](https://dev.gerencianet.com.br/docs/assinaturas-como-funcionam) de status das assinaturas. ## Tabela de status dos carnês <hr> Caso queira, acesse a [tabela completa](https://dev.gerencianet.com.br/docs/carnes-como-funcionam) de status dos carnês.