{
  "id": "banking/swift-gpi-tracking-fail",
  "signature": "AI tells a corporate treasurer that SWIFT GPI tracking works for all cross-border payments, ignoring correspondent bank limitations",
  "signature_zh": "AI告诉企业财务主管SWIFT GPI追踪适用于所有跨境支付，忽略代理行限制",
  "regex": "GPI.*track.*fail|SWIFT.*confirmation.*timeout",
  "domain": "banking",
  "category": "network_error",
  "subcategory": null,
  "root_cause": "SWIFT GPI (Global Payments Innovation) tracking requires both sender and receiver banks to be GPI members; many smaller correspondent banks in emerging markets are not GPI-enabled, causing tracking failures and delayed confirmations.",
  "root_cause_type": "generic",
  "root_cause_zh": "SWIFT GPI（全球支付创新）追踪要求发送方和接收方银行均为GPI成员；许多新兴市场的小型代理行未启用GPI，导致追踪失败和确认延迟。",
  "versions": [
    {
      "version": "SWIFT GPI v1.4",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "SWIFT MT103 standard 2024",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Assuming all banks in SWIFT network support GPI by default",
      "why_fails": "GPI is an opt-in service; only ~4,000 of 11,000 SWIFT members are GPI-enabled as of 2024",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "Relying on MT103 status codes without checking GPI UETR",
      "why_fails": "Non-GPI banks use legacy MT103 without UETR (Unique End-to-End Transaction Reference), so tracking is impossible",
      "fail_rate": 0.85,
      "condition": "",
      "sources": []
    },
    {
      "action": "Using SWIFT GPI API without fallback for non-GPI corridors",
      "why_fails": "API returns 'GPI_NOT_AVAILABLE' error; payment still processes but without tracking data",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Pre-validate GPI capability using SWIFT GPI directory API: curl -X GET https://api.swift.com/gpi/directory?bic=BANKUS33 -H 'Authorization: Bearer token' - check 'gpiMember' field before initiating payment",
      "success_rate": 0.78,
      "how": "Pre-validate GPI capability using SWIFT GPI directory API: curl -X GET https://api.swift.com/gpi/directory?bic=BANKUS33 -H 'Authorization: Bearer token' - check 'gpiMember' field before initiating payment",
      "condition": "",
      "sources": []
    },
    {
      "action": "Use alternative tracking via correspondent bank's proprietary platform (e.g., J.P. Morgan Access) for non-GPI corridors",
      "success_rate": 0.75,
      "how": "Use alternative tracking via correspondent bank's proprietary platform (e.g., J.P. Morgan Access) for non-GPI corridors",
      "condition": "",
      "sources": []
    },
    {
      "action": "Implement manual reconciliation using SWIFT FIN Copy service for non-GPI payments, requesting status via MT199 query",
      "success_rate": 0.7,
      "how": "Implement manual reconciliation using SWIFT FIN Copy service for non-GPI payments, requesting status via MT199 query",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Pre-validate GPI capability using SWIFT GPI directory API: curl -X GET https://api.swift.com/gpi/directory?bic=BANKUS33 -H 'Authorization: Bearer token' - check 'gpiMember' field before initiating payment",
    "Use alternative tracking via correspondent bank's proprietary platform (e.g., J.P. Morgan Access) for non-GPI corridors",
    "Implement manual reconciliation using SWIFT FIN Copy service for non-GPI payments, requesting status via MT199 query"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://www.swift.com/our-solutions/payments/gpi",
  "official_doc_section": null,
  "error_code": "SWIFT_GPI_TRACK_TIMEOUT",
  "verification_tier": "ai_generated",
  "confidence": 0.83,
  "fix_success_rate": 0.78,
  "resolvable": "partial",
  "first_seen": "2024-04-05",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}