> ## 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 de transferências

> Use as APIs de leitura da Pagou para recuperar estado após atraso de eventos, falha do worker ou incerteza no payout.

Use reconciliação como contingência quando processamento de webhook ou ação operacional deixar o estado da transferência incerto.

## APIs de leitura

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

## Exemplo de requisição

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

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "requestId": "0190a2b4-18a7-7de0-9a43-69b7cf261201",
  "data": {
    "id": "018f1f2e-7b45-7c9a-8d3e-1a2b3c4d5e72",
    "status": "paid",
    "amount": "1200",
    "external_ref": "payout_1001",
    "transferred_at": "2026-03-16T14:05:00.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 transfer does not exist."
}
```

Como corrigir: valide o ID da transferência e o mapeamento do payout antes de repetir a consulta.

## Fluxo de reconciliação

1. Carregue o ID da transferência na Pagou a partir do seu registro de payout ou armazenamento de webhook.
2. Busque o estado mais recente da transferência.
3. Aplique localmente apenas transições seguras para frente.
4. Escale estados repetidos `error`, `rejected` ou `unknown` para operação.