圈款（預繳）申請

ReserveCash

版本資訊

v2.2.9 起新增功能

使用限制

• 申請服務時段為交易日 08:00 ～ 14:30，時段外送出會被後端拒絕。
• 送出後無法透過 API 取消。
• 結果以本方法回傳的 status（10 成功、90 失敗）為準。
• 完整作業特性見圈存與匯撥。

輸入參數

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

Result 回傳

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

圈款紀錄 ReserveCashRecord 欄位

Return type : Object

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

請求範例

sdk.Stock.ReserveCash(account, 10000)

回傳範例

{
    isSuccess = True,
    message = ,
    data =  ReserveCashRecord{
        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)
            }
}