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

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

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

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

上線前檢查清單

  1. 用範例憑證算出的簽章與文件相同。
  2. 所有欄位值都以字串送出,金額不是數字型別。
  3. 代收建單 url 與 json 兩種模式(如有使用)、fps 與 bank_transfer 兩種通道都測過。
  4. 付款畫面顯示的是 payable_amount,不是原始金額。
  5. 代付建單 FPS 的三種帳號格式(如有使用)與銀行轉帳都測過。
  6. Callback 端點:驗章正確、簽章不符會丟棄、重複通知能冪等處理、10 秒內回應 ok。
  7. Callback 以 order_no 對應訂單,能區分代收與代付。
  8. 有定期查單的機制,處理沒收到 Callback 與 late_credited 的情況。
  9. 建單逾時與 internal_error 會以商戶單號查單確認,不會直接判定失敗。
  10. 程式以 code 判斷結果,不依賴 message 文字。
  11. 正式環境的憑證、網域與 IP 白名單已另外申請,且金鑰只存在伺服器端。
  12. 伺服器時間已校準(建議開啟 NTP 時間同步),每個請求的 timestamp 都是送出當下的時間。
  13. 每個建單請求都帶 callback_url;網址是合法的 http 或 https 網址(兩者都接受),網域可從公網解析且只指向公網 IP,不會轉址(3xx),伺服器回 HTTP 2xx。
  14. 代收成功以 received_amount(或 settlement_amount)入帳;與預期金額不同時轉人工,不自動入帳。
  15. 已是終態的訂單不會因後到、狀態不同的 Callback 被回退;有疑義以查單結果為準。
Prev
銀行代碼