圈款（預繳）申請

reserveCash

版本資訊

v2.2.9 起新增功能

使用限制

• 限交割銀行為台北富邦銀行的帳戶。
• 申請服務時段為交易日 08:00 ～ 14:30，時段外送出會被後端拒絕。
• 送出後無法透過 API 取消；受理結果以本方法回傳的 status（10 成功、90 失敗）為準。
• 預收金額會先扣除申請金額千分之四作為預收手續費（不足新台幣 50 元以 50 元計），實際可動用金額以 圈款（預繳）查詢 的 reservedAmount 為準。
• 完整作業特性見 圈存與匯撥。

輸入參數

參數	類別	說明
account	Account	帳號
amount	number	預繳金額（新台幣元），須大於 0

Result 回傳

參數	類別	說明
isSuccess	bool	是否成功
data	ReserveCashRecord	回傳圈款申請資訊
message	string ? (optional)	當 isSuccess = false 回傳錯誤訊息

圈款紀錄 ReserveCashRecord 欄位

Return type : Object

參數	類別	說明
seqNo	string	委託單流水序號
date	string	申請日期
time	string	申請時間
branchNo	string	分公司代號
account	string	帳號
currency	string	幣別 : TWD 新台幣
amount	number	預繳金額（元）
status	number	狀態碼 : 10 成功 、 90 失敗

請求範例

sdk.stock.reserveCash(account, 10000)

回傳範例

{
  isSuccess: true,
  data: {
        date: "2026/07/28",               // 申請日期 (string)
        time: "10:53:23.000",             // 申請時間 (string)
        seqNo: "118036",                  // 委託單流水序號 (string)
        branchNo: "20207",                // 分公司代號 (string)
        account: "9801163",               // 帳號 (string)
        currency: "TWD",                  // 幣別 (string)
        amount: 10000,                   // 預繳金額 (int)
        status: 10,                       // 狀態碼 (int)
  }
}