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

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

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

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

商戶後台

除了 API,ST Pay 也提供商戶後台,讓您查詢訂單、核對餘額與管理員工帳號。後台不能建單,也不能導出資料;建單一律透過 API。

登入

項目說明
網址由 ST Pay 對接窗口提供(與 API 的網域不同);測試環境與正式環境的網域不同,正式環境的網域在測試環境完成串接後另行提供。兩個環境的帳號各自獨立。
登入資料帳號、密碼、4 位數圖形驗證碼。看不清楚驗證碼時,點圖片換一張。
來源 IP只能從 ST Pay 為您設定的後台登入白名單 IP 登入(與 API 白名單是兩份不同的清單)。白名單是空的就無法登入。需要新增或變更時,請聯繫您的 ST Pay 對接窗口。
第一個帳號由 ST Pay 建立商戶主管帳號並交付初始密碼。
密碼至少 6 字元,須包含英文字母與數字,不得與帳號相同。初始密碼與被重設的密碼,第一次登入時必須先更改,不能略過,更改前無法使用其他功能;新密碼不得與目前的密碼相同。之後可從右上角的帳號選單「更改密碼」。
鎖定密碼連續錯誤 5 次,帳號會被鎖定(驗證碼錯誤不計次;更改密碼時舊密碼輸入錯誤也計入)。商戶員工由商戶主管解除,商戶主管請聯繫 ST Pay。
忘記密碼沒有自助重設。商戶員工由商戶主管重設,商戶主管請聯繫 ST Pay。
自動登出閒置 30 分鐘自動登出;登入滿 12 小時須重新登入;帳號被停用時立即登出;來源 IP 被移出後台登入白名單(或換到白名單外的 IP)時也立即登出。
語言右上角可切換繁體中文、简体中文、English。

商戶被 ST Pay 停用時,只是不能再建單;仍可登入後台,也可以用 API 查單。

角色與頁面

頁面商戶主管商戶員工內容
訂單查詢可用可用查詢自己商戶的代收單與代付單
餘額流水可用不可用目前可用餘額與每筆餘額異動
員工帳號可用不可用建立與管理商戶員工帳號

商戶主管可以再關閉個別員工的頁面或「顯示完整帳號」權限(見員工帳號)。

訂單查詢

  • 分「代收單」「代付單」兩個頁籤,最新的單在最前面,一次最多列出最新的 500 筆。
  • 可依狀態、建立時間、訂單號(完整)、商戶單號、通道類別篩選;建立時間預設為當日(00:00:00 至 23:59:59),可自行調整或清空,按「重設」回到當日。畫面不會自動刷新,請按「重新整理」或「查詢」。
  • 只列出保存期限(6 個月)內的單。
  • 狀態的顯示文字與 API 的 status 對應如下(另見訂單狀態):
status後台顯示
pending待審批
success成功
rejected已拒絕
late_credited逾時入帳
paid已代付
  • 欄位名稱與 API 相同:訂單金額 payable_amount、原始金額 amount、實收金額 received_amount、手續費 fee、結算金額 settlement_amount、代付金額 amount、實扣總額 total_deducted。
  • 付款人姓名只在後台顯示,查單 API 與 Callback 都不會回傳。
  • 帳號預設遮罩(只顯示末 4 碼)。代收單的收款帳號可以點兩下顯示完整帳號,一次只顯示一筆,且 ST Pay 會留下紀錄;代付收款人帳號在商戶後台只顯示遮罩。
  • 點「詳情」可看到拒絕原因與 回調發送紀錄:每次發送的時間、結果(成功或失敗)與觸發方式(自動或手動)。送達失敗不會自動重試,需要重發時請聯繫 ST Pay(見 Callback)。

餘額流水

頂部顯示目前的可用餘額,下方依時間由新到舊列出每筆異動,一次最多列出最新的 1000 筆;可依時間與異動類型篩選,時間預設為當日。流水不能修改或刪除。

異動類型何時產生方向
代收入帳代收單入帳成功(success),金額為結算金額增加
逾時入帳代收單轉為 late_credited,金額為結算金額。這種情況不發 Callback,請以此核對增加
代付出款代付單出款(paid),金額為實扣總額扣減
人工增加、人工扣減ST Pay 人工調整餘額;「原因/備註」欄是 ST Pay 填寫的說明增加或扣減

每筆都有調整前餘額、調整後餘額與關聯訂單號,可用來與您的帳務逐筆核對。

員工帳號

商戶主管可以管理自己商戶的商戶員工帳號:

操作說明
建立帳號輸入帳號與初始密碼(規則同上),員工第一次登入時必須更改密碼。帳號只能用英文字母、數字與 . _ -,以英數開頭,最多 64 字元。
停用停用後無法登入,已登入的連線立即中斷,不能再改回正常。
解除鎖定員工密碼連續錯誤 5 次被鎖定時使用。
重設密碼輸入新的初始密碼,原密碼立即失效,員工下次登入時必須更改。
權限可關閉該員工的「訂單查詢」頁面,或「顯示完整帳號」操作,儲存後立即生效。

商戶主管帳號由 ST Pay 建立、停用、解除鎖定與重設密碼。由 ST Pay 建立的帳號,清單的建立人顯示「ST Pay」。

Prev
簽章
Next
AI 協助對接