Pular para o conteúdo principal
Use reconciliação quando o estado do pagamento estiver incerto após timeout, queda de worker ou atraso de webhook.

​
APIs de leitura

  • GET /v2/transactions
  • GET /v2/transactions/{id}

​
Exemplo de requisiçã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_1203",
  "data": {
    "id": "tr_1001",
    "external_ref": "order_1001",
    "status": "paid",
    "method": "pix",
    "amount": 1500,
    "currency": "BRL",
    "paid_at": "2026-03-16T14:03:10.000Z",
    "updated_at": "2026-03-16T14:03:10.000Z"
  }
}

​
Erro comum

Status 404 
{
  "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 ID da transação e o seu mapeamento interno pedido-transação antes de repetir a consulta.

​
Fluxo de reconciliação

  1. Carregue o ID da transação na Pagou a partir do seu registro de pagamento ou armazenamento de webhook.
  2. Busque o estado mais recente da transação.
  3. Aplique no seu sistema apenas transições seguras para frente.
  4. Depois da recuperação, mantenha webhooks como caminho normal de atualização.

​
Próximos passos