{"_id":"575eaab48be8aa0e00f59cdf","version":{"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","__v":30,"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"},"category":{"_id":"575aeffae12cf20e002f3070","version":"575aeffae12cf20e002f306f","__v":0,"project":"575aeffae12cf20e002f306c","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"},"user":"575b077ae12cf20e002f30a3","parentDoc":null,"__v":45,"project":"575aeffae12cf20e002f306c","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 1 (um) dia corrido 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\": \"<code>new</code> *(\\\"novo\\\")*\",\n    \"0-1\": \"Cobrança gerada, aguardando definição da forma de pagamento.\",\n    \"1-0\": \"<code>waiting</code> *(\\\"aguardando\\\")*\",\n    \"2-0\": \"<code>paid</code> *(\\\"pago\\\")*\",\n    \"1-1\": \"Forma de pagamento selecionada, aguardando a confirmação do pagamento.\",\n    \"2-1\": \"Pagamento confirmado.\",\n    \"3-0\": \"<code>unpaid</code> *(\\\"não pago\\\")*\",\n    \"3-1\": \"Não foi possível confirmar o pagamento da cobrança.\",\n    \"4-0\": \"<code>refunded</code> *(\\\"devolvido\\\")*\",\n    \"4-1\": \"Pagamento devolvido pelo lojista ou pelo intermediador Gerencianet.\",\n    \"5-0\": \"<code>contested</code> *(\\\"contestado\\\")*\",\n    \"5-1\": \"Pagamento em processo de contestação.\",\n    \"6-0\": \"<code>canceled</code> *(\\\"cancelado\\\")*\",\n    \"6-1\": \"Cobrança cancelada pelo vendedor ou pelo pagador.\",\n    \"7-0\": \"<code>link</code> *(\\\"link\\\")*\",\n    \"7-1\": \"Aplicável a <a href=\\\"https://dev.gerencianet.com.br/docs/link-pagamento-introducao\\\" title=\\\"Link Interno\\\">Link de Pagamento</a>. Este status indica que trata-se de uma cobrança que está associada a um link de pagamento.\",\n    \"8-1\": \"Aplicável a <a href=\\\"https://dev.gerencianet.com.br/docs/link-pagamento-introducao\\\" title=\\\"Link Interno\\\">Link de Pagamento</a>. Um link de pagamento receberá este status ao atingir a data de vencimento definida no campo <code>expire_at</code> ao consumir o endpoint <code>/charge/:id/link</code>. Se o pagamento não foi realizado até esta data, a Gerencianet enviará para sua URL de notificação a informação sobre o novo status da cobrança.\",\n    \"8-0\": \"<code>expired</code> *(\\\"expirado\\\")*\"\n  },\n  \"cols\": 2,\n  \"rows\": 9\n}\n[/block]\n# Tabela de status das assinaturas\n\nA seguir tabela contendo a relação de todos os possíveis status de uma assinatura:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Status das Assinaturas\",\n    \"h-1\": \"Descrição\",\n    \"0-0\": \"<code>new</code> *(\\\"nova\\\")*\",\n    \"1-0\": \"<code>active</code> *(\\\"ativa\\\")*\",\n    \"2-0\": \"<code>canceled</code> *(\\\"cancelada\\\")*\",\n    \"3-0\": \"<code>expired</code> *(\\\"expirada\\\")*\",\n    \"0-1\": \"Assinatura criada, porém nenhuma cobrança foi paga.\",\n    \"1-1\": \"Assinatura ativa. Todas as cobranças estão sendo geradas.\",\n    \"2-1\": \"Assinatura foi cancelada pelo vendedor ou pelo pagador.\",\n    \"3-1\": \"Assinatura expirada. Todas as cobranças configuradas para a assinatura já foram emitidas.\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\n# Tabela de status dos carnês\n\nA seguir tabela contendo a relação de todos os possíveis status de um carnê:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Status dos Carnês\",\n    \"h-1\": \"Descrição\",\n    \"0-0\": \"<code>up_to_date</code> <em>(\\\"em dia\\\")</em>\",\n    \"1-0\": \"<code>unpaid</code> <em>(\\\"não pago\\\")</em>\",\n    \"2-0\": \"<code>finished</code> <em>(\\\"finalizado\\\")</em>\",\n    \"0-1\": \"Carnê encontra-se em dia, não há nenhuma parcela inadimplente. Assim que o carnê é criado, ele também recebe este status <code>up_to_date</code>\",\n    \"1-1\": \"Carnê encontra-se inadimplente. Se identificarmos a inadimplência de pelo menos uma parcela, o status do carnê é alterado para <code>unpaid</code> imediatamente.\",\n    \"2-1\": \"Carnê está finalizado, ou seja, todas as parcelas foram resolvidas e possuem um status final. A partir desse momento, o status do carnê nunca mais muda.\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]","excerpt":"Você está em: *\"Visão Geral da API > Status das Transações\"*","slug":"transacoes","type":"basic","title":"Status das Transações"}

Status das Transações

Você está em: *"Visão Geral da API > Status das 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 1 (um) dia corrido 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": "<code>new</code> *(\"novo\")*", "0-1": "Cobrança gerada, aguardando definição da forma de pagamento.", "1-0": "<code>waiting</code> *(\"aguardando\")*", "2-0": "<code>paid</code> *(\"pago\")*", "1-1": "Forma de pagamento selecionada, aguardando a confirmação do pagamento.", "2-1": "Pagamento confirmado.", "3-0": "<code>unpaid</code> *(\"não pago\")*", "3-1": "Não foi possível confirmar o pagamento da cobrança.", "4-0": "<code>refunded</code> *(\"devolvido\")*", "4-1": "Pagamento devolvido pelo lojista ou pelo intermediador Gerencianet.", "5-0": "<code>contested</code> *(\"contestado\")*", "5-1": "Pagamento em processo de contestação.", "6-0": "<code>canceled</code> *(\"cancelado\")*", "6-1": "Cobrança cancelada pelo vendedor ou pelo pagador.", "7-0": "<code>link</code> *(\"link\")*", "7-1": "Aplicável a <a href=\"https://dev.gerencianet.com.br/docs/link-pagamento-introducao\" title=\"Link Interno\">Link de Pagamento</a>. Este status indica que trata-se de uma cobrança que está associada a um link de pagamento.", "8-1": "Aplicável a <a href=\"https://dev.gerencianet.com.br/docs/link-pagamento-introducao\" title=\"Link Interno\">Link de Pagamento</a>. Um link de pagamento receberá este status ao atingir a data de vencimento definida no campo <code>expire_at</code> ao consumir o endpoint <code>/charge/:id/link</code>. Se o pagamento não foi realizado até esta data, a Gerencianet enviará para sua URL de notificação a informação sobre o novo status da cobrança.", "8-0": "<code>expired</code> *(\"expirado\")*" }, "cols": 2, "rows": 9 } [/block] # Tabela de status das assinaturas A seguir tabela contendo a relação de todos os possíveis status de uma assinatura: [block:parameters] { "data": { "h-0": "Status das Assinaturas", "h-1": "Descrição", "0-0": "<code>new</code> *(\"nova\")*", "1-0": "<code>active</code> *(\"ativa\")*", "2-0": "<code>canceled</code> *(\"cancelada\")*", "3-0": "<code>expired</code> *(\"expirada\")*", "0-1": "Assinatura criada, porém nenhuma cobrança foi paga.", "1-1": "Assinatura ativa. Todas as cobranças estão sendo geradas.", "2-1": "Assinatura foi cancelada pelo vendedor ou pelo pagador.", "3-1": "Assinatura expirada. Todas as cobranças configuradas para a assinatura já foram emitidas." }, "cols": 2, "rows": 4 } [/block] # Tabela de status dos carnês A seguir tabela contendo a relação de todos os possíveis status de um carnê: [block:parameters] { "data": { "h-0": "Status dos Carnês", "h-1": "Descrição", "0-0": "<code>up_to_date</code> <em>(\"em dia\")</em>", "1-0": "<code>unpaid</code> <em>(\"não pago\")</em>", "2-0": "<code>finished</code> <em>(\"finalizado\")</em>", "0-1": "Carnê encontra-se em dia, não há nenhuma parcela inadimplente. Assim que o carnê é criado, ele também recebe este status <code>up_to_date</code>", "1-1": "Carnê encontra-se inadimplente. Se identificarmos a inadimplência de pelo menos uma parcela, o status do carnê é alterado para <code>unpaid</code> imediatamente.", "2-1": "Carnê está finalizado, ou seja, todas as parcelas foram resolvidas e possuem um status final. A partir desse momento, o status do carnê nunca mais muda." }, "cols": 2, "rows": 3 } [/block]