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

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

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

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

訂單狀態與金額

「後台顯示」是商戶後台顯示的狀態文字。

代收單

pending ──┬── 確認入帳 ───────────────→ success        (發 Callback)
          ├── ST Pay 人工拒絕 ─────────→ rejected       (發 Callback,終態)
          └── 30 分鐘到期,系統拒絕 ──→ rejected       (發 Callback)
                                          │
                                          └── 之後確認收到款項 ──→ late_credited (不發 Callback)
status後台顯示意義是否為最終結果
pending待審批等待付款人轉帳與 ST Pay 確認否
success成功入帳成功,結算金額已加入您的餘額是
rejected已拒絕不入帳、不收手續費人工拒絕是最終結果;系統逾時拒絕之後仍可能變成 late_credited
late_credited逾時入帳訂單已被系統逾時拒絕,但之後確認付款人確實有付款,結算金額已加入您的餘額是

逾時入帳不發 Callback

您會先收到一次 rejected 的 Callback,之後同一張單若轉為 late_credited,不會再收到通知,但餘額已經增加。

建議:付款人反映已付款但訂單顯示拒絕時,請用查單確認;並定期以查單或商戶後台的餘額流水(異動類型「逾時入帳」)對帳,比對 reject_reason 為「訂單已逾時」的單是否轉為 late_credited。

代付單

pending ──┬── ST Pay 出款 ──→ paid       (扣款並發 Callback)
          └── ST Pay 拒絕 ──→ rejected   (不扣款並發 Callback)
status後台顯示意義是否為最終結果
pending待審批等待 ST Pay 出款否
paid已代付已出款,已從餘額扣除代付金額加手續費是
rejected已拒絕不扣款、不收手續費是

代付單沒有自動逾時,會維持 pending 直到 ST Pay 處理。

金額與手續費

項目計算方式
代收訂單金額 payable_amount原始金額 + 辨識尾數(0.01–0.99)
代收手續費 fee實收金額 × 代收費率,小數第 3 位起無條件捨去
代收結算金額 settlement_amount實收金額 − 手續費
代付手續費 fee代付金額 × 代付費率,小數第 3 位起無條件捨去
代付實扣總額 total_deducted代付金額 + 手續費
  • 費率在建單當下鎖定,之後費率調整只影響新建立的單。
  • 實收金額 received_amount 是 ST Pay 實際確認入帳的金額,以它計算手續費與結算金額。若付款人轉帳金額與訂單金額不同,實收金額可能和 payable_amount 不一樣。
  • 被拒絕的單手續費為 0.00。
  • 每筆單的原始金額或代付金額須在 ST Pay 設定的單筆上下限內(含上下限本身)。上下限依「代收或代付」與「通道類別」分別設定,請向 ST Pay 確認目前的數值。

範例:代收費率 2.5%,實收 1000.37,手續費為 1000.37 × 2.5% = 25.00925,捨去後是 25.00,結算金額為 975.37。

Next
重複請求與結果確認