> ## 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.

# Reconciliação Pix

> Use as APIs de leitura para confirmar o estado da transação quando um webhook atrasar, falhar ou deixar dúvida operacional.

Use reconciliação quando o estado do pagamento estiver incerto após timeout, queda de worker ou atraso de webhook.

## APIs de leitura

* `GET /v2/transactions`
* `GET /v2/transactions/{id}`

## Exemplo de requisição

```bash theme={null}
curl --request GET \
  --url https://api.pagou.ai/v2/transactions/018f1f2e-7b42-7c9a-8d3e-1a2b3c4d5e6f \
  --header "Authorization: Bearer SEU_TOKEN"
```

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "requestId": "0190a2b4-18a7-7de0-9a43-69b7cf261201",
  "data": {
    "id": "018f1f2e-7b42-7c9a-8d3e-1a2b3c4d5e6f",
    "external_ref": "order_1001",
    "status": "paid",
    "method": "pix",
    "amount": 1500,
    "currency": "BRL",
    "paid_at": "2026-03-16T14:03:10.000Z",
    "updated_at": "2026-03-16T14:03:10.000Z"
  }
}
```

## Erro comum

Status `404`

```json theme={null}
{
  "type": "https://api.pagou.ai/problems/not-found",
  "title": "Resource Not Found",
  "status": 404,
  "detail": "The requested transaction does not exist."
}
```

Como corrigir: valide o ID da transação e o mapeamento pedido-transação antes de repetir a consulta.

## Fluxo de reconciliação

1. Carregue o ID da transação na Pagou a partir do seu registro de pagamento ou armazenamento de webhook.
2. Busque o estado mais recente da transação.
3. Aplique no seu sistema apenas transições seguras para frente.
4. Depois da recuperação, mantenha webhooks como caminho normal de atualização.

## Próximos passos

* [Eventos de pagamento](/pt/webhooks/payment-events)
* [Retentativas e reconciliação](/pt/webhooks/retries-and-reconciliation)