Skip to main content
當商戶發起付款、退款或撤銷後,建議透過本查詢 API 確認交易最終狀態。 此接口適用於:
  • 交易處於處理中(如 1143 / 1145)
  • 避免重複請求
  • 對帳與補償流程
  • 系統異常後的狀態確認

查詢方式

支援以下查詢條件:
  • 使用 QFPay 訂單號 syssn
  • 使用商戶訂單號 out_trade_no
  • 使用時間區間 start_time + end_time
若為退款交易,回應中將包含 origssn,對應原始付款交易的 syssn

HTTP 請求

Endpoint

TEXT

Headers

HTTP

請求參數

完整格式請參考: 通用 API 請求格式 以下為交易查詢主要參數:

查詢規則說明

至少需提供以下其中一種條件:
  • syssn
  • out_trade_no
  • 或完整時間區間(start_time + end_time
跨月份查詢必須提供時間區間。

程式碼範例

Python

回應欄位

詳細欄位請參考: 通用 API 回應格式 以下為交易查詢常見欄位:

回應範例

JSON

整合建議

  1. 在收到 1143 / 1145 等處理中狀態時,請使用本查詢 API 確認最終結果。
  2. 避免在未知狀態下重複發送支付請求。
  3. 對帳流程應以 syssn 作為唯一交易識別。
  4. 建議實作延遲查詢機制(例如 3–5 秒後再查詢)。