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

# Retentativas e reconciliação

> Recupere com segurança sua integração quando houver redelivery, falha do worker ou incerteza no estado do pagamento ou payout.

Use esta página quando seu pipeline de webhook funciona bem na maior parte do tempo, mas ainda precisa de um caminho seguro de recuperação.

## Regras de recuperação

* Faça deduplicação por ID do evento de webhook.
* Torne idempotentes os efeitos colaterais em sistemas downstream.
* Reconcilie com `GET` quando o resultado do processamento estiver incerto.
* Reprocesse a etapa a partir do payload salvo e do estado atualizado da API em vez de repetir efeitos colaterais às cegas.

## Exemplo de requisição de reconciliaçã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",
    "status": "paid",
    "updated_at": "2026-03-16T14:03:10.000Z"
  }
}
```

## Erro comum

```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 mapeamento do recurso salvo a partir da resposta original de criação ou do payload de webhook antes de repetir a recuperação.

## Fluxo prático

1. Persista o payload bruto do webhook.
2. Responda rapidamente.
3. Processe de forma assíncrona.
4. Se o processamento falhar depois do ack, consulte o estado mais recente do recurso.
5. Recalcule a próxima transição segura de negócio a partir desse estado novo.