Skip to main content
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/po_1001 \
  --header "Authorization: Bearer YOUR_TOKEN"

​
Example response

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

​
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

  1. Load the Pagou transfer ID from your payout record or webhook store.
  2. Fetch the latest transfer state.
  3. Apply only forward-safe transitions locally.
  4. Escalate repeated error, rejected, or unknown states to operations.