钱包接口
在你的后端实现 4 个 HTTPS 接口：用启动码换玩家、查余额、批量记账、查单笔交易。请求使用 Standard Webhooks HMAC 签名。
Star Game 接入
Star Game 提供在你 App 的 WebView 中运行的 H5 社交游戏（幸运转盘、卡牌回合、转轮、飞升游戏，以及免费的朋友局棋盘游戏）。玩家余额始终留在你的系统里：游戏采用单一钱包（seamless wallet），每一笔投注和派彩都由你的后端通过运营方钱包接口记账。
你需要完成三部分：
启动码
玩家每次打开游戏时由你的后端签发的一次性、短时效（≤ 5 分钟）凭据。它是唯一会到达游戏页面的凭据。
宿主桥
App WebView 中的一个小型 JSBridge（getConfig、gameLoaded、gameRecharge、destroy），与大多数语聊 App 已实现的桥接格式兼容。
-
注册。 在商户控制台注册账号、验证邮箱并创建商户。你会获得一个 Operator ID（运营方 ID，
m_加 20 位小写字符），与游戏入口 URL 一起显示在「商户控制台 → 接入」，沙盒与生产共用同一个 ID。沙盒即刻可用。 -
沙盒联调。 在「商户控制台 → 接入」的「沙盒」标签页填写钱包 URL（钱包基础地址，仅限 HTTPS）、币种、小数位、最大批量（1–500）和最大并发请求（1–16），然后点击「生成密钥」（
whsec_…，只显示一次）。实现钱包接口、校验签名、接好宿主桥、启用游戏并运行自测工具。 -
审核。 自测通过并在沙盒中玩过真实对局后，在「商户控制台 → 概览」点击「申请开通生产环境」。我们会审核你的接入并与你确定商务条款；条款设定之前生产环境保持锁定。
-
生产上线。 配置生产环境对接参数（使用单独的密钥），为预付余额充值，把入口地址切换到生产域名，并逐项完成上线检查清单。
| 沙盒 | 生产 | |
|---|---|---|
| 游戏入口地址 | https://sandbox.sentosatower.com/games/<gameId>/index.html?op=<operatorId> |
https://games.sentosatower.com/games/<gameId>/index.html?op=<operatorId> |
| 钱包请求发往 | 你配置的沙盒钱包地址 | 你配置的生产钱包地址 |
| 签名密钥 | 沙盒 whsec_… 密钥 |
生产 whsec_… 密钥（单独生成） |
| 开通 | 创建商户后立即可用 | 审核通过后 |
| 计费 | 从不计费 | 按日计费，见上线检查清单 |
| 游戏设置 | 在「商户控制台 → 游戏」按环境分别设置启用的游戏和每款游戏的目标利润率 |
公开的演示大厅 https://demo.sentosatower.com 使用模拟金币（不接钱包），你的产品团队可以在接入前试玩全部游戏。
一局游戏如何开始
Section titled “一局游戏如何开始” 玩家在你的 App 中点击游戏 │ ├─ App 打开 WebView：https://<host>/games/<gameId>/index.html?op=<operatorId> │ ├─ 游戏页面 → 宿主桥 getConfig App 向你的后端申请一次性启动码， │ 返回 { code, userId, roomId, language, gameMode, ... } │ ├─ 游戏页面 → Star Game 平台 （我们自己的游戏接口，你不需要调用） │ │ │ └─ POST {walletUrl}/players/authenticate { launch_code, game_id, client_ip } │ ← { player_id, session_id, currency, balance, ... } （你的后端） │ └─ 玩家开始游戏。投注与派彩以签名的 POST {walletUrl}/transactions 批量请求到达你的后端。游戏页面只与 Star Game 平台通信，平台再调用你的钱包。你的 App 永远不需要把自己的访问令牌交给游戏页面。