圈款（預繳）申請

ReserveCash

版本資訊

v2.2.9 起新增功能

使用限制

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

輸入參數

參數	類別	說明
account	Account	帳號
amount	int64	預繳金額（新台幣元），須大於 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	int64	預繳金額（元）
Status	int32	狀態碼 : 10 成功 、 90 失敗

請求範例

package main

import (
    "fmt"
    "fubon"
)

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

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

    // 圈款（預繳）申請
    reserveResult, err := sdk.Stock.ReserveCash(account, 10000)

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

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

    // 輸出圈款結果
    if reserveResult.Data != nil {
        record := *reserveResult.Data
        fmt.Printf("✅ Reserve cash accepted\n")
        fmt.Printf("SeqNo: %s\n", record.SeqNo)
        fmt.Printf("Date: %s\n", record.Date)
        fmt.Printf("Amount: %d\n", record.Amount)
        fmt.Printf("Status: %d\n", record.Status)
    } else {
        fmt.Println("Reserve cash success but no data returned.")
    }
}

回傳範例

// ReserveCash 回傳結構
Result{
    IsSuccess: true,
    Message:   nil,
    Data: &ReserveCashRecord{
        SeqNo:         "118036",         // 委託單流水序號
        Date:          "2026/07/28",     // 申請日期
        Time:          "10:53:23.000",   // 申請時間
        BranchNo:      "20207",          // 分公司代號
        Account:       "9801163",        // 帳號
        Currency:      "TWD",            // 幣別
        Amount:        10000,           // 預繳金額
        Status:        10,               // 狀態碼
    },
}