Skip to main content

股票匯撥申請

TransferStock

版本資訊

v2.2.9 起新增功能

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

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

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

輸入參數​

參數類別說明
accountAccount帳號（撥出方）
targetBranchNostring撥入證券分公司集保代號
targetAccountstring撥入方帳號
stockNostring股票代號
quantityint64匯撥股數，單位為股，須大於 0
market*Market市場別 : MarketTaiex 上市 、 MarketTaisdaq 上櫃 、 MarketTaiemg 興櫃。帶入 nil 時由 SDK 自動判別

Result 回傳​

參數類別說明
IsSuccessbool是否成功
Data*TransferRecord回傳匯撥申請資訊
Message*string當 IsSuccess = false 回傳錯誤訊息

匯撥紀錄 TransferRecord 欄位​

Return type : Object

參數類別說明
SeqNostring委託單流水序號
Datestring申請日期
Timestring申請時間
StockNostring股票代號
MarketMarket市場別 : MarketTaiex 上市 、 MarketTaisdaq 上櫃 、 MarketTaiemg 興櫃
Quantityint64匯撥股數（股）
TargetBranchNostring撥入證券分公司集保代號
TargetAccountstring撥入方帳號
Statusint32狀態碼 : 10 成功 、 90 失敗

請求範例​

package main

import (
    "fmt"
    "fubon"
)

func main() {
    // 初始化 SDK 並登入
    sdk := fubon.NewFubonSDK()

    // ... 登入、連線等初始化步驟 ...

    // 股票匯撥申請（1,000 股；market 帶 nil 由 SDK 自動判別）
    transferResult, err := sdk.Stock.TransferStock(account, "960C", "7654321", "006205", 1000, nil)

    // 錯誤處理
    if err != nil {
        fmt.Printf("❌ Transfer Stock Error: %v (Type: %T)\n", err, err)
        return
    }

    // 檢查是否成功
    if !transferResult.IsSuccess {
        message := "No message"
        if transferResult.Message != nil {
            message = *transferResult.Message
        }
        fmt.Printf("Transfer stock failed. Message: %s\n", message)
        return
    }

    // 輸出匯撥結果
    if transferResult.Data != nil {
        record := *transferResult.Data
        fmt.Printf("✅ Transfer stock accepted\n")
        fmt.Printf("SeqNo: %s\n", record.SeqNo)
        fmt.Printf("StockNo: %s\n", record.StockNo)
        fmt.Printf("Quantity: %d\n", record.Quantity)
        fmt.Printf("TargetAccount: %s\n", record.TargetAccount)
        fmt.Printf("Status: %d\n", record.Status)
    } else {
        fmt.Println("Transfer stock success but no data returned.")
    }
}

回傳範例​

// TransferStock 回傳結構
Result{
    IsSuccess: true,
    Message:   nil,
    Data: &TransferRecord{
        SeqNo:          "418181",         // 委託單流水序號
        Date:           "2026/07/28",     // 申請日期
        Time:           "10:53:48.340",   // 申請時間
        StockNo:        "006205",           // 股票代號
        Market:         MarketTaiex,      // 市場別
        Quantity:       1000,             // 匯撥股數
        TargetBranchNo: "960C",           // 撥入證券分公司集保代號
        TargetAccount:  "7654321",        // 撥入方帳號
        Status:         10,               // 狀態碼
    },
}