Status de transação

Use esta página como a referência canônica de estado de pagamento no seu sistema.

Status canônicos

Status	Significado	Ação típica
`pending`	aguardando a próxima mudança de estado	mantenha o pedido em aberto
`processing`	processamento do provedor em andamento	espere e monitore
`paid`	pagamento concluído	faça fulfillment uma única vez
`captured`	captura do cartão concluída	faça fulfillment uma única vez
`authorized`	cartão autorizado, mas ainda não final	mantenha pendente até sua regra de negócio permitir fulfillment
`three_ds_required`	o fluxo do cartão precisa de autenticação do cliente	continue `next_action` em vez de tratar como falha
`partially_paid`	apenas parte do valor foi liquidada	aplique sua política de liquidação parcial
`refunded`	reembolso total	reverta fulfillment e estado financeiro
`partially_refunded`	reembolso parcial	atualize estado do pedido e da contabilidade
`canceled`	transação cancelada	encerre a tentativa
`expired`	pagamento expirou	permita nova tentativa do cliente
`refused`	o provedor recusou o pagamento	mostre uma falha recuperável
`chargedback`	estado de disputa ou chargeback	escale para risco e financeiro
`processed`	o provedor concluiu uma etapa interna	monitore até um estado final
`in_protest`	bloqueio bancário ou disputa	encaminhe para operação

Dirija mudanças de estado primeiro pelos webhooks.
Trate paid, captured, refunded, partially_refunded, canceled, expired e refused como terminais na maioria dos sistemas de merchant.
Reconcilie com GET /v2/transactions/{id} sempre que uma transição estiver incerta.

{
  "id": "tr_1001",
  "status": "paid",
  "method": "pix",
  "amount": 1500,
  "currency": "BRL",
  "paid_at": "2026-03-16T14:03:10.000Z"
}