Reconciliação de transferências - Pagou Developer Docs

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/018f1f2e-7b45-7c9a-8d3e-1a2b3c4d5e72 \
  --header "Authorization: Bearer SEU_TOKEN"

Exemplo de resposta

{
  "success": true,
  "requestId": "0190a2b4-18a7-7de0-9a43-69b7cf261201",
  "data": {
    "id": "018f1f2e-7b45-7c9a-8d3e-1a2b3c4d5e72",
    "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 mapeamento do payout antes de repetir a consulta.

Fluxo de reconciliação

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

​APIs de leitura

​Exemplo de requisição

​Exemplo de resposta

​Erro comum

​Fluxo de reconciliação

APIs de leitura

Exemplo de requisição

Exemplo de resposta

Erro comum

Fluxo de reconciliação