> ## Documentation Index
> Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ciclo de vida da transação de cartão

> Modele autorização, 3DS, captura e estados terminais de pagamentos com cartão.

Use esta página para mapear estados de cartão para pedido e liberação.

## Ciclo de vida típico

1. `pending`: a transação foi criada.
2. `three_ds_required`: o cliente precisa concluir a autenticação.
3. `authorized` ou `processing`: o processamento do cartão ainda está em andamento.
4. `captured` ou `paid`: o pagamento está final o suficiente para liberar o pedido.
5. `refused`, `canceled`, `refunded` ou `partially_refunded`: interrompa ou reverta a liberação.

## Exemplo de resposta que exige ação do cliente

```json theme={null}
{
  "id": "018f1f2e-7b43-7c9a-8d3e-1a2b3c4d5e70",
  "status": "three_ds_required",
  "method": "credit_card",
  "amount": 2490,
  "currency": "BRL",
  "next_action": {
    "type": "three_ds_challenge"
  }
}
```

## Guia de tratamento de status

* Não libere o pedido em `pending` nem em `three_ds_required`.
* Libere o pedido apenas uma vez ao chegar em um estado liquidado como `captured` ou `paid`.
* Se o fluxo do navegador terminar de forma inesperada, reconcilie com `GET /v2/transactions/{id}`.
* Trate reembolso e chargeback como fluxos financeiros separados.

## Leia a seguir

* [Payment Element para pagamentos com cartão](/pt/payments/cards/payment-element)
* [3D Secure](/pt/frontend/payment-element/three-d-secure)
* [Status de transação](/pt/payments/transaction-statuses)