文檔版本歷史
當前版本
版本號：1.11.0 | 發布日期：2026/10/22
版本歷史記錄
1.11
- 影響錢包：單一錢包、轉帳錢包
- 正式環境上線時間：2026/10/27
單一錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 發送平台卡、發送 FreeSpin 平台卡、發送 FeatureGame 平台卡、批次發送 FreeSpin 平台卡、批次發送 FeatureGame 平台卡、附錄 | 移除錯誤碼 88「道具同時間無法同時觸發」說明 |
| 更新 API | 取消平台卡 | 新增 FreeSpin／FeatureGame 卡片使用中的取消差異說明；錯誤碼 4 新增情境「無法取消(FeatureGame 卡使用中)」 |
| 更新 API | 查詢平台卡狀態 | 常見 QA 補充：查詢結果不區分「未使用」與「使用中」，兩者皆回傳 isFinished:false |
| 更新 API | 文件網站語系選單 | 右上角語系下拉選單標籤由「中文（台灣）／中文（中國）」更新為「繁體中文／簡體中文」 |
| 新增幣別 | 附錄 | 新增幣別代碼 AED、KES、SAR、XOF（皆為 1:1 比值） |
轉帳錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 發送平台卡、發送 FreeSpin 平台卡、發送 FeatureGame 平台卡、批次發送 FreeSpin 平台卡、批次發送 FeatureGame 平台卡、附錄 | 移除錯誤碼 88「道具同時間無法同時觸發」說明 |
| 更新 API | 取消平台卡 | 新增 FreeSpin／FeatureGame 卡片使用中的取消差異說明；錯誤碼 4 新增情境「無法取消(FeatureGame 卡使用中)」 |
| 更新 API | 查詢平台卡狀態 | 常見 QA 補充：查詢結果不區分「未使用」與「使用中」，兩者皆回傳 isFinished:false |
| 更新 API | 文件網站語系選單 | 右上角語系下拉選單標籤由「中文（台灣）／中文（中國）」更新為「繁體中文／簡體中文」 |
| 新增幣別 | 附錄 | 新增幣別代碼 AED、KES、SAR、XOF（皆為 1:1 比值） |
1.10
- 影響錢包：單一錢包、轉帳錢包
- 正式環境上線時間：2026/10/06
單一錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 查詢遊戲列表 | 請求新增參數 sortMod，可指定排序模式（1=VP 推薦（預設），2=上個月熱門程度） |
| 更新 API | 附錄 | 「遊戲類型對應表」新增代碼 6（FISH）；「交易來源代碼」新增代碼 13（魚機特殊交易 (彩金跟卡片)） |
| 更新 API | 查詢投注記錄、查詢投注記錄(分頁)、查詢每日報表、查詢玩家報表、查詢玩家報表(分頁)、BetNSettle - 下注並結算、RetryBet - 下注重試 | 更新 jackpotWin 說明，目前僅 FISH 遊戲 VP_400001_1 會使用此參數，SLOT 遊戲不會使用 |
| 更新 API | 平台端 API 實作說明 | 因應魚機上線，新增「遊戲類型差異」章節，分別說明魚機 FISH 與老虎機 SLOT 的交易頻率、交易特性、API 限制與注意事項 |
| 新增幣別 | 附錄 | 新增幣別代碼 TRY、UZS、PGK（皆為 1:1 比值） |
轉帳錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 查詢遊戲列表 | 請求新增參數 sortMod，可指定排序模式（1=VP 推薦（預設），2=上個月熱門程度） |
| 更新 API | 附錄 | 「遊戲類型對應表」新增代碼 6（FISH）；「交易來源代碼」新增代碼 13（魚機特殊交易 (彩金跟卡片)） |
| 更新 API | 查詢投注記錄、查詢投注記錄(分頁)、查詢每日報表、查詢玩家報表、查詢玩家報表(分頁) | 更新 jackpotWin 說明，目前僅 FISH 遊戲 VP_400001_1 會使用此參數，SLOT 遊戲不會使用 |
| 新增幣別 | 附錄 | 新增幣別代碼 TRY、UZS、PGK（皆為 1:1 比值） |
1.9
- 影響錢包：單一錢包、轉帳錢包
- 正式環境上線時間：2026/09/08
單一錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 附錄 | 補充 MYR1、THB1 的「遊戲內顯示 100:1」僅影響遊戲內顯示，API 傳值以 1:1 傳送即可 |
| 更新 API | 附錄 | 新增「特色模式」代碼表 |
| 更新 API | 查詢投注記錄、查詢投注記錄(分頁) | 請求與回應新增參數 featureMode、gameKind，可用於過濾與紀錄 |
| 更新 API | 查詢投注詳情 | 回應的 detailJsonInfo 新增 featureMode、gameKind |
| 更新 API | 查詢每日報表、查詢玩家報表、查詢玩家報表(分頁) | 請求新增參數 featureMode、gameKind，用於過濾 |
| 更新 API | 查詢遊戲列表 | 回應新增參數 gameKind，標示遊戲類型 |
| 更新 API | 查詢熱門遊戲排行 | 回應參數 gameType 更名為 gameKind，全站統一使用 gameKind |
| 更新 API | BetNSettle - 下注並結算、RetryBet - 下注重試 | 請求新增參數 featureMode，標示該筆交易的特色模式 |
| 更新 API | BetNSettle - 下注並結算、RetryBet - 下注重試 | 請求 gameInfo 移除 isFeatureGame 欄位，後續不再傳送此值 |
| 更新 API | 附錄 | 「特色模式」代碼表補充各模式的中英文名稱 |
| 更新 API | 查詢投注詳情、查詢投注回放 | 截圖與回放保留天數由 30 天延長為 60 天 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡、發送 FeatureGame 平台卡、批次發送 FeatureGame 平台卡 | expiredTime（過期時間）參數改為必填，並更新自動結算／失效相關常見 QA 說明 |
| 更新 API | 簡介 | 移除「版本資訊」中的版本號 |
轉帳錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 附錄 | 補充 MYR1、THB1 的「遊戲內顯示 100:1」僅影響遊戲內顯示，API 傳值以 1:1 傳送即可 |
| 更新 API | 附錄 | 新增「特色模式」代碼表 |
| 更新 API | 查詢投注記錄、查詢投注記錄(分頁) | 請求與回應新增參數 featureMode、gameKind，可用於過濾與紀錄 |
| 更新 API | 查詢投注詳情 | 回應的 detailJsonInfo 新增 featureMode、gameKind |
| 更新 API | 查詢每日報表、查詢玩家報表、查詢玩家報表(分頁) | 請求新增參數 featureMode、gameKind，用於過濾 |
| 更新 API | 查詢遊戲列表 | 回應新增參數 gameKind，標示遊戲類型 |
| 更新 API | 查詢熱門遊戲排行 | 回應參數 gameType 更名為 gameKind，全站統一使用 gameKind |
| 更新 API | 附錄 | 「特色模式」代碼表補充各模式的中英文名稱 |
| 更新 API | 查詢投注詳情、查詢投注回放 | 截圖與回放保留天數由 30 天延長為 60 天 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡、發送 FeatureGame 平台卡、批次發送 FeatureGame 平台卡 | expiredTime（過期時間）參數改為必填，並更新自動結算／失效相關常見 QA 說明 |
| 更新 API | 簡介 | 移除「版本資訊」中的版本號 |
1.8
- 影響錢包：單一錢包、轉帳錢包
- 正式環境上線時間：2026/08/25
單一錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 新增幣別 | 附錄 | 新增幣別代碼 COP、NGN、SGD |
| 更新 API | 創建玩家 | 玩家帳號長度上限由 25 個字符調整為 50 個字符 |
| 更新 API | 查詢投注回放 | 補充 betSourceId 2~7 的交易無法回放 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡 | 回合數新增整數與下限 1 的限制 |
| 更新 API | 平台卡說明 | 補充平台卡發送後立即顯示於背包、單一玩家背包道具上限 200 張，並新增 itemBet 金額計算方式說明 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡、發送 FeatureGame 平台卡、批次發送 FeatureGame 平台卡 | 修正過期與失效時間說明，計算與玩家是否登入、使用卡片無關 |
轉帳錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 新增幣別 | 附錄 | 新增幣別代碼 COP、NGN、SGD |
| 更新 API | 創建玩家 | 玩家帳號長度上限由 25 個字符調整為 50 個字符 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡 | 回合數新增整數與下限 1 的限制 |
| 更新 API | 平台卡說明 | 補充平台卡發送後立即顯示於背包、單一玩家背包道具上限 200 張，並新增 itemBet 金額計算方式說明 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡、發送 FeatureGame 平台卡、批次發送 FeatureGame 平台卡 | 修正過期與失效時間說明，計算與玩家是否登入、使用卡片無關 |
| 更新 API | 轉帳 | 補充 amount 帶入 0 為不合法格式 |
1.7
- 影響錢包：單一錢包、轉帳錢包
- 正式環境上線時間：2026/08/18
單一錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | API 文檔簡介 | JWT Token 有效期由 24 小時調整為 1 小時 |
| 更新 API | API 文檔簡介 | 新增交易時間基準說明，投注記錄查詢與報表皆以 txTime（結算時間）為主 |
| 更新 API | API 文檔簡介 | 新增玩家 IP 說明，遊戲過程中變更 IP 不影響遊玩 |
| 更新 API | 創建玩家 | 站點 ID 新增最短 3 個字符限制 |
| 更新 API | 附錄 | 修正簽章字串組合順序說明，移除 secret |
| 更新 API | Balance - 查詢餘額 | 新增重試策略說明，機制與 BetNSettle 相同 |
| 更新 API | 平台端 API 實作說明 | 新增 errorCode 1006（無效 session）觸發情境說明 |
轉帳錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | API 文檔簡介 | JWT Token 有效期由 24 小時調整為 1 小時 |
| 更新 API | API 文檔簡介 | 新增交易時間基準說明，投注記錄查詢與報表皆以 txTime（結算時間）為主 |
| 更新 API | API 文檔簡介 | 新增玩家 IP 說明，遊戲過程中變更 IP 不影響遊玩 |
| 更新 API | 創建玩家 | 站點 ID 新增最短 3 個字符限制 |
| 更新 API | 附錄 | 修正簽章字串組合順序說明，移除 secret |
1.6
- 影響錢包：單一錢包、轉帳錢包
- 正式環境上線時間：2026/07/14
單一錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 創建玩家 | 新增參數「站點 ID」格式檢查 |
| 更新 API | 平台卡說明 | 更新卡片類型說明 |
| 更新 API | 發送 FeatureGame 平台卡、批次發送 FeatureGame 平台卡 | 更新卡片類型說明 |
| 更新 API | 查詢每日報表、查詢玩家報表、查詢玩家報表(分頁) | 調整時間格式檢查，僅支援整點格式 |
轉帳錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 創建玩家 | 新增參數「站點 ID」格式檢查 |
| 更新 API | 平台卡說明 | 更新卡片類型說明 |
| 更新 API | 發送 FeatureGame 平台卡、批次發送 FeatureGame 平台卡 | 更新卡片類型說明 |
| 更新 API | 查詢每日報表、查詢玩家報表、查詢玩家報表(分頁) | 調整時間格式檢查，僅支援整點格式 |
1.5
- 影響錢包：單一錢包、轉帳錢包
- 正式環境上線時間：2026/06/09
單一錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 平台卡說明 | 新增背包模式說明 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡、發送 FeatureGame 平台卡、批次發送 FeatureGame 平台卡 | 更新過期日期限制，更貼近實際使用體感 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡、發送 FeatureGame 平台卡、批次發送 FeatureGame 平台卡 | 更新下注金額判斷，使實際使用和後台紀錄顯示相同 |
轉帳錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 平台卡說明 | 新增背包模式說明 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡、發送 FeatureGame 平台卡、批次發送 FeatureGame 平台卡 | 更新過期日期限制，更貼近實際使用體感 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡、發送 FeatureGame 平台卡、批次發送 FeatureGame 平台卡 | 更新下注金額判斷，使實際使用和後台紀錄顯示相同 |
1.4 (2026/05/20)
- 影響錢包：單一錢包、轉帳錢包
單一錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 查詢投注詳情、查詢投注回放 | 更新支援語系說明 |
| 更新 API | 發送 FreeSpin 平台卡、批次發送 FreeSpin 平台卡 | 新增 round 上限 100 說明 |
| 更新 API | 平台卡說明 | 更新常見問題 |
| 更新 API | 開啟遊戲 | 新增參數「backButton」與對應參數檢驗 |
| 更新 API | 查詢每日報表、查詢玩家報表、查詢玩家報表(分頁) | 參數「betSource」新增查詢全部注單代碼：3 |
| 移除 API | 發送平台卡、查詢平台卡資訊 | 移除指定 API 頁面，簡化平台卡資訊 |
轉帳錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 更新 API | 查詢投注詳情、查詢投注回放 | 更新支援語系 |
| 更新 API | 發送簡易 FreeSpin 平台卡、批次發送簡易 FreeSpin 平台卡 | 新增 round 上限 100 說明 |
| 更新 API | 平台卡說明 | 更新常見問題 |
| 更新 API | 開啟遊戲 | 新增參數「backButton」與對應參數檢驗 |
| 更新 API | 查詢每日報表、查詢玩家報表、查詢玩家報表(分頁) | 參數「betSource」新增查詢全部注單代碼：3 |
| 移除 API | 發送平台卡、查詢平台卡資訊 | 移除指定 API 頁面，簡化平台卡資訊 |
1.3.0 (2026/04/30)
- 影響錢包：單一錢包、轉帳錢包
單一錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 新增 API | 批次發送簡易 FeatureGame 平台卡 | 可批次簡易發送 FeatureGame 的 API |
| 新增 API | 批次發送簡易 FreeSpin 平台卡 | 可批次易發送 FreeSpin 的 API |
| 更新 API | 查詢平台卡狀態 | 新增 isFinished 與 gameCode 於回應中 |
| 新增錯誤碼 | 附錄 | 新增錯誤代碼 37，表達特定注單無法支援查詢細單或回放功能 |
| 新增錯誤碼 | 附錄 | 新增錯誤代碼 100，表達服務繁忙，暫時無法容納更多玩家上線 |
| 新增幣別 | 附錄 | 新增幣別代碼 PKR |
轉帳錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 新增 API | 批次發送簡易 FeatureGame 平台卡 | 可批次簡易發送 FeatureGame 的 API |
| 新增 API | 批次發送簡易 FreeSpin 平台卡 | 可批次易發送 FreeSpin 的 API |
| 更新 API | 查詢平台卡狀態 | 新增 isFinished 與 gameCode 於回應中 |
| 新增錯誤碼 | 附錄 | 新增錯誤代碼 37，表達特定注單無法支援查詢細單或回放功能 |
| 新增錯誤碼 | 附錄 | 新增錯誤代碼 100，表達服務繁忙，暫時無法容納更多玩家上線 |
| 新增幣別 | 附錄 | 新增幣別代碼 PKR |
1.1.0 (2026/03/25)
- 影響錢包：單一錢包、轉帳錢包
單一錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 新增 API | 發送簡易 FreeSpin 平台卡 | 可簡易發送 FreeSpin 的 API |
| 新增錯誤碼 | 附錄 | 表達執行遊戲相關 API 時因限制被拒絕情境 |
| 補充 API 說明 | 開啟遊戲、獲取 Access Token、身份驗證概述 | 新增「常見 QA」與部分名詞說明 |
轉帳錢包
| 項目 | 主要影響頁面 | 說明 |
|---|---|---|
| 新增 API | 發送簡易 FreeSpin 平台卡 | 可簡易發送 FreeSpin 的 API |
| 新增錯誤碼 | 附錄 | 表達執行遊戲相關 API 時因限制被拒絕情境 |
| 補充 API 說明 | 開啟遊戲、獲取 Access Token、身份驗證概述 | 新增「常見 QA」與部分名詞說明 |
1.0.0 (2026/01/30)
- 影響錢包：單一錢包、轉帳錢包
單一錢包
| 項目 | 說明 |
|---|---|
| 所有 | API 文件功能初版 |
轉帳錢包
| 項目 | 說明 |
|---|---|
| 所有 | API 文件功能初版 |
未來預期調整
| 版本 | 預計時間 | 影響功能 | 影響錢包 |
|---|---|---|---|
| 2.0.0 | 2026/04/30 | 於投注紀錄中移除 transferId | 單一錢包、轉帳錢包 |