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

# Transfer Reconciliation

> Use Pagou transfer read APIs to recover from delayed events, worker failures, or uncertain payout state.

Use reconciliation as a fallback when webhook processing or operator actions leave transfer state uncertain.

## Read APIs

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

## Example request

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

## Example response

```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"
  }
}
```

## Common error

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."
}
```

Fix: verify the transfer ID and your own payout mapping before retrying the lookup.

## Reconciliation workflow

1. Load the Pagou transfer ID from your payout record or webhook store.
2. Fetch the latest transfer state.
3. Apply only forward-safe transitions locally.
4. Escalate repeated `error`, `rejected`, or `unknown` states to operations.