Ciclo de Vida dos Status

Quick Reference

WhatReferência de status de cobrança

WhyAcompanhe cada estado no ciclo de vida do pagamento

As cobranças passam por um conjunto definido de status. A ordem canônica usada na documentação e integrações é:

issued → pending → confirmed → pre_captured → paid → (refunded | caminhos de disputa) → resultados terminais incluindo canceled e error.

Variações de fluxo

As transições exatas dependem do método de pagamento, modo de captura e regras do adquirente. Use webhooks e polling no GET de cobrança para se manter alinhado com o estado da plataforma.

Ordem dos status (lista de referência)

1. issued
2. pending
3. confirmed
4. pre_captured
5. paid
6. refunded
7. refund_error
8. pre_chargeback_resolution
9. chargeback
10. chargeback_requested
11. chargeback_reversed
12. chargeback_refunded
13. canceled
14. error

Diagrama de transição de estados

Referência de status

Status	Significado	Terminal
issued	Registro de cobrança criado; ainda não enviado para processamento.	Não
pending	Aguardando autorização, 3DS ou ação assíncrona do provedor.	Não
confirmed	Autorização ou compromisso recebido; pode ainda precisar de captura.	Não
pre_captured	Valor autorizado retido; captura pendente ou em andamento.	Não
paid	Fundos capturados ou caminho de liquidação confirmado como bem-sucedido.	Não
refunded	Estorno concluído com sucesso.	Sim
refund_error	Tentativa de estorno falhou; requer investigação ou retentativa.	Não
pre_chargeback_resolution	Disputa aberta; em revisão antes da classificação final.	Não
chargeback	Chargeback aceito ou perdido; ledger reflete o resultado da disputa.	Sim
chargeback_requested	Emissor ou portador do cartão iniciou chargeback; ainda não é final.	Não
chargeback_reversed	Chargeback revertido a favor do comerciante; pode retornar para paid.	Não
chargeback_refunded	Fundos ajustados devido ao fluxo de reembolso do chargeback.	Sim
canceled	Cobrança anulada ou expirada antes da conclusão.	Sim
error	Falha de processamento irrecuperável para esta tentativa de cobrança.	Sim

Códigos de resposta →Códigos da API e mapeamento de provedoresWebhook de cobrança →Atualizações de status nos payloads de eventoCriar cobrança →Referência do endpoint