Pular para o conteúdo principal
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.
  • Prefira reprocessar seu job interno a partir do payload salvo e do estado novo da API em vez de repetir a lógica de negócio às cegas.

​
Exemplo de requisição de reconciliação

curl --request GET \
  --url https://api.pagou.ai/v2/transactions/tr_1001 \
  --header "Authorization: Bearer SEU_TOKEN"

​
Exemplo de resposta

{
  "success": true,
  "requestId": "req_2101",
  "data": {
    "id": "tr_1001",
    "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."
}
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.