ST Pay 商戶 APIST Pay 商戶 API
指南
API
錯誤碼
商戶後台
AI 協助對接
  • 繁體中文
  • 简体中文
  • English
指南
API
錯誤碼
商戶後台
AI 協助對接
  • 繁體中文
  • 简体中文
  • English
  • 開始

    • 概覽
    • 請求與回應格式
    • 身分驗證與 IP 白名單
    • 簽章
    • 商戶後台
    • AI 協助對接
  • API

    • 代收建單
    • 代付建單
    • 查單
    • Callback 通知
  • 參考

    • 訂單狀態與金額
    • 重複請求與結果確認
    • 錯誤碼
    • 銀行代碼
    • 上線前檢查清單

重複請求與結果確認

情況結果與建議做法
用已經使用過的商戶單號再建單回 merchant_order_no_duplicate,不論原單狀態,也不比對內容(金額不同也一樣)。不會產生第二張單。回應不附原單資料,請用商戶單號查單。
建單請求逾時、連線中斷,或收到 internal_error不要直接當作失敗。用同一個商戶單號查單:查得到就以查單結果為準(待付款且還沒到失效時間的單,查單會附上付款網址或收款帳號,可以繼續讓付款人付這張單,見查單);回 order_not_found 表示 ST Pay 沒有建立這張單,可以用同一個商戶單號重新建單。
訂單被拒絕後要重新發起必須使用新的商戶單號。
商戶單號的唯一性範圍同一商戶內,代收單與代付單各自不能重複;訂單超過 6 個月被刪除後,該單號可以再次使用。
查單重複呼叫唯讀,每次回傳目前狀態,不會產生任何變動。
近乎同時送出多個相同商戶單號的建單依序處理,只有第一個成功,其餘回 merchant_order_no_duplicate。
同一張單收到多次 Callback以 order_no 加 status 判斷是否處理過,重複的直接回 ok。
Prev
訂單狀態與金額
Next
錯誤碼