股票匯撥申請

TransferStock

版本資訊

v2.2.9 起新增功能

使用限制

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

撥入分公司代號（target_branch_no）怎麼查？

請填入撥入證券分公司的集保代號，不是銀行分行代碼或自行編列的內部代號。

1. 先到 券商總覽查詢 確認券商資訊。
2. 撥入富邦證券分公司時，再以 富邦分公司代號明細 確認實際分公司代號。
3. 將查得的代號依原格式填入（例如 960C），包含英數字母。

輸入參數

參數	類別	說明
account	Account	帳號（撥出方）
target_branch_no	string	撥入證券分公司集保代號
target_account	string	撥入方帳號
stock_no	string	股票代號
quantity	int	匯撥股數，單位為股，須大於 0
market	Market (optional)	市場別 : TAIEX 上市 、 TAISDAQ 上櫃 、 TAIEMG 興櫃。未帶入時由 SDK 自動判別

Result 回傳

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

匯撥紀錄 TransferRecord 欄位

Return type : Object

參數	類別	說明
seq_no	string	委託單流水序號
date	string	申請日期
time	string	申請時間
stock_no	string	股票代號
market	Market	市場別 : TAIEX 上市 、 TAISDAQ 上櫃 、 TAIEMG 興櫃
quantity	int	匯撥股數（股）
target_branch_no	string	撥入證券分公司集保代號
target_account	string	撥入方帳號
status	int	狀態碼 : 10 成功 、 90 失敗

請求範例

auto transfer_response = sdk->stock->transfer_stock(target_account, "960C", "7654321", "006205", 1000, std::nullopt);


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

回傳範例

// 搭配自定義 .cpp & hpp  Output
[TransferRecord]
  seq_no: 418181                   // 委託單流水序號 (string)
  date: 2026/07/28                 // 申請日期 (string)
  time: 10:53:48.340               // 申請時間 (string)
  stock_no: 006205                   // 股票代號 (string)
  market: TAIEX                    // 市場別 (Market)
  quantity: 1000                   // 匯撥股數 (int)
  target_branch_no: 960C           // 撥入證券分公司集保代號 (string)
  target_account: 7654321          // 撥入方帳號 (string)
  status: 10                       // 狀態碼 (int)