Pular para o conteúdo principal
Use reconciliação como contingência quando processamento de webhook ou ação operacional deixar o estado da transferência incerto.

​
APIs de leitura

  • GET /v2/transfers
  • GET /v2/transfers/{id}

​
Exemplo de requisição

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

​
Exemplo de resposta

{
  "success": true,
  "requestId": "req_2003",
  "data": {
    "id": "po_1001",
    "status": "paid",
    "amount": 1200,
    "external_ref": "payout_1001",
    "transferred_at": "2026-03-16T14:05:00.000Z"
  }
}

​
Erro comum

Status 404 
{
  "type": "https://api.pagou.ai/problems/not-found",
  "title": "Resource Not Found",
  "status": 404,
  "detail": "The requested transfer does not exist."
}
Como corrigir: valide o ID da transferência e o seu mapeamento interno de payout antes de repetir a consulta.

​
Fluxo de reconciliação

  1. Carregue o ID da transferência na Pagou a partir do seu registro de payout ou armazenamento de webhook.
  2. Busque o estado mais recente da transferência.
  3. Aplique localmente apenas transições seguras para frente.
  4. Escale estados repetidos error, rejected ou unknown para operação.