文档版本历史
当前版本
版本号：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 | 单一钱包、转账钱包 |