Pular para o conteúdo principal

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.

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.