圈款（預繳）申請

ReserveCash

版本資訊

v2.2.9 起新增功能

使用限制

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

輸入參數

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

Result 回傳

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

圈款紀錄 ReserveCashRecord 欄位

Return type : Object

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

請求範例

auto reserve_cash_response = sdk->stock->reserve_cash(target_account, 10000);


// 搭配自定義 .cpp & hpp  Output
if (!reserve_cash_response.is_success) {
    std::cout << "reserve cash failed reason: "
        << (reserve_cash_response.message.has_value() ? reserve_cash_response.message.value() : "No message")
        << std::endl;
}
else {
    if (reserve_cash_response.data.has_value()) {
        std::cout << reserve_cash_response.data.value() << std::endl;
    }
    else {
        std::cout << "Reserve cash success but no data returned." << std::endl;
    }
}

回傳範例

// 搭配自定義 .cpp & hpp  Output
[ReserveCashRecord]
  seq_no: 118036                   // 委託單流水序號 (string)
  date: 2026/07/28                 // 申請日期 (string)
  time: 10:53:23.000               // 申請時間 (string)
  branch_no: 20207                 // 分公司代號 (string)
  account: 9801163                 // 帳號 (string)
  currency: TWD                    // 幣別 (string)
  amount: 10000                   // 預繳金額 (int)
  status: 10                       // 狀態碼 (int)