Retentativas e reconciliaçã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

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

​

Exemplo de resposta

{
  "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

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

​

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.