游戏商功能映射表
下表展示各游戏商对统一接口的支持情况：
图例：✅ 完整支持 | ⚠️ 部分支持/特殊模式 | ❌ 不支持
主动调用接口
| 统一接口 | BG | GSC | SA | WM |
|---|---|---|---|---|
| 玩家注册 | ✅ open.user.create | ✅ launchGame（自动创建） | ✅ regUserInfo | ✅ memberRegister |
| 余额查询 | ✅ open.operator.user.balance | ✅ seamless/balance | ✅ 回调 GetUserBalance | ✅ 回调 CallBalance |
| 资金转账 | ✅ open.operator.user.transfer | ✅ withdraw/deposit | ⚠️ Seamless 模式 | ⚠️ Seamless 模式 |
| 游戏启动 | ✅ 多个 URL 接口 | ✅ launchGame | ✅ loginRequest | ✅ loginGame |
| 游戏试玩 | ✅ 多个 trial 接口 | ✅ launchGame | ✅ loginRequestForFun | ✅ loginGame(isTest) |
| 踢线/登出 | ❌ | ❌ | ✅ kickUser | ✅ logoutGame |
| 投注记录 | ✅ open.order.query | ✅ wagerList | ✅ 多个查询接口 | ✅ getDateTimeReport |
| 注单详情 | ✅ open.operator.order.status | ✅ wager/gameHistory | ✅ getUserBetItemDV | ✅ getReportDetail |
| 游戏列表 | ❌ | ✅ gameList/productList | ⚠️ getActiveHostList | ❌ |
| 订单状态 | ✅ open.operator.order.status | ✅ wager | ✅ getTransactionDetails | ✅ getDealidStatus |
| 健康检查 | ✅ open.operator.ping | ❌ | ❌ | ✅ testGateway |
回调接口
| 统一接口 | BG | GSC | SA | WM |
|---|---|---|---|---|
| 下注扣款回调 | ✅ open.operator.order.transfer | ✅ seamless/withdraw | ✅ PlaceBet | ✅ PointInout |
| 结算派彩回调 | ✅ open.operator.calc.transfer | ✅ seamless/deposit | ✅ PlayerWin/PlayerLost | ✅ PointInout |
| 取消回滚回调 | ❌ | ❌ | ✅ PlaceBetCancel | ✅ TimeoutBetReturn |
| 注单推送回调 | ❌ | ✅ pushBetData | ❌ | ✅ SendMemberReport |
动作与回调对照
下表用于说明 Hub 收到不同 action 后，默认会通过哪个统一回调通知包网（Agent）：
| 动作 | 默认回调接口 | 是否影响钱包余额 | 是否影响报表/对账 | 是否建议携带 original_transaction_id | 说明 |
|---|---|---|---|---|---|
BET | POST /api/v1/callback/bet | 是 | 否 | 否 | 表示下注扣款；默认不通过 bet-push 推送未结算 active 注单 |
SETTLED | POST /api/v1/callback/settle + POST /api/v1/callback/bet-push | 是 | 是 | 否 | 正常结算，既影响钱包，也会进入注单报表 |
BONUS | POST /api/v1/callback/settle + POST /api/v1/callback/bet-push | 是 | 是 | 是 | 表示额外奖金或游戏赢分；会计入玩家赢分结果 |
CANCEL | POST /api/v1/callback/cancel | 是 | 视包网实现而定 | 是 | 用于撤销原下注或修正原记录 |
ROLLBACK | POST /api/v1/callback/cancel | 是 | 视包网实现而定 | 是 | 用于回滚原资金或原结算结果 |
REFUND | POST /api/v1/callback/cancel | 是 | 视包网实现而定 | 是 | 用于退款或返还原交易金额 |
VOID | POST /api/v1/callback/cancel | 可能否 | 是 | 是 | 用于将原结算或原注单标记无效；仅标记时 amount 可为 0 |
补充说明：
bet/settle/cancel属于资金类回调，重点是同步钱包余额与交易状态bet-push属于注单结果推送，重点是同步最终报表、对账、查单与代理输赢统计- 若包网只处理钱包账务，至少需要接入
bet/settle/cancel - 若包网还需要报表或注单查询能力，建议同时接入
bet-push
各游戏商特有功能
以下功能仅部分游戏商支持，未纳入统一接口，可通过扩展接口调用：
| 游戏商 | 特有功能 | 说明 |
|---|---|---|
| GSC | 免费旋转管理 | createFreeRound / cancelFreeRound / getPlayerFreeRoundBonus |
| GSC | 投注比例查询 | getGamesBetScales |
| GSC | 超级大厅 | launchSuperLobby |
| SA | 投注限额管理 | queryBetLimit / setAllBetLimit / setUserMaxWinning / queryUserBetLimit |
| SA | 活动/赛事管理 | getEventPointTransactionDetail / getEventWinningDetail / creditEventPoint / getLeaderboardRankingDetail |
| SA | 用户验证 | verifyUsername / getUserStatusDV |
| SA | 取消注单查询 | getCancelledBetDetails / getUnsuccessfulBetDetails |
| SA | 游戏错误查询 | getGameErrorDetail |
| SA | 交易重发 | resendTransaction |
| SA | 礼物交易查询 | getGiftTransactionDetails |
| WM | 会员启停管理 | enableorDisablemem（登录/下注启停） |
| WM | 限红编辑 | editLimit（maxwin/maxlose/limitType） |
| WM | 密码修改 | changePassword |
| WM | 小费报表 | getTipReport |
| WM | 未结算报表 | getUnsettleReport |
| BG | 代理创建 | open.agent.create |