Transfer Reconciliation - Pagou Developer Docs

Use reconciliation as a fallback when webhook processing or operator actions leave transfer state uncertain.

Read APIs

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

Example request

curl --request GET \
  --url https://api.pagou.ai/v2/transfers/018f1f2e-7b45-7c9a-8d3e-1a2b3c4d5e72 \
  --header "Authorization: Bearer YOUR_TOKEN"

Example response

{
  "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"
  }
}

Common error

Status 404

{
  "type": "https://api.pagou.ai/problems/not-found",
  "title": "Resource Not Found",
  "status": 404,
  "detail": "The requested transfer does not exist."
}

Fix: verify the transfer ID and your own payout mapping before retrying the lookup.

Reconciliation workflow

Load the Pagou transfer ID from your payout record or webhook store.
Fetch the latest transfer state.
Apply only forward-safe transitions locally.
Escalate repeated error, rejected, or unknown states to operations.
Treat rejected as a cancellation at the banking partner: the funds are not returned to your balance automatically, so escalate it and confirm the amount is back in your balance before re-sending.

​Read APIs

​Example request

​Example response

​Common error

​Reconciliation workflow

Read APIs

Example request

Example response

Common error

Reconciliation workflow