游戏商功能映射表
下表展示各游戏商对统一接口的支持情况：
图例：✅ 完整支持 | ⚠️ 部分支持/特殊模式 | ❌ 不支持
主动调用接口
| 统一接口 | 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-push | 是 | 是 | 否 | 实时扣除 bet_amount |
SETTLED | POST /api/v1/callback/bet-push | 是 | 是 | 否 | 实时增加 prize_amount |
BONUS | POST /api/v1/callback/bet-push | 是 | 是 | 是 | 实时增加额外奖金或活动赢分 |
CANCEL | POST /api/v1/callback/bet-push | 是 | 是 | 是 | 通过 status=CANCEL 幂等冲正原交易 |
ROLLBACK | POST /api/v1/callback/bet-push | 是 | 是 | 是 | 通过 status=ROLLBACK 幂等冲正原交易 |
REFUND | POST /api/v1/callback/bet-push | 是 | 是 | 是 | 通过 status=REFUND 幂等冲正原交易 |
VOID | POST /api/v1/callback/bet-push | 是 | 是 | 是 | 通过 status=VOID 幂等冲正原交易 |
补充说明：
- 在 Seamless 模式下，资金变动由
/bet-push实时完成；/offline只负责会话关闭与最终对账 - 包网需实现
/balance、/offline和/bet-push，不需要实现独立的bet、settle或cancel回调
各游戏商特有功能
以下功能仅部分游戏商支持，未纳入统一接口，可通过扩展接口调用：
| 游戏商 | 特有功能 | 说明 |
|---|---|---|
| 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 |