余额查询回调 (Balance)

概述

• 接口路径：/api/v1/balance
• 请求方法：POST
• 说明：在 Seamless（无缝模式）下，当玩家进入游戏或进行资金验证时，VCT Hub 发起此回调，实时查询玩家在 Client 侧主钱包的可用余额。

---

请求参数 (Body)

参数名	类型	必填	说明
username	string	是	玩家用户名（Client 侧玩家唯一标识）
currency	string	是	货币代码 (例如 MYR, USD, IDR, THB)
sign	string	是	请求签名（签名格式：HexEncode(HMAC-SHA256(username + "." + timestamp, apiSecret))）
timestamp	int64	是	秒级 Unix 时间戳

请求示例

{
  "username": "player001",
  "currency": "MYR",
  "sign": "9a2f64d0bcfa8298711ef8490a61829e",
  "timestamp": 1783324700
}

---

响应参数 (Response Body)

参数名	类型	说明
username	string	玩家用户名
currency	string	货币代码
balance	number (float)	玩家在该币种下的实时可用余额

响应示例

{
  "username": "player001",
  "currency": "MYR",
  "balance": 100.00
}

---

注意事项

1. Client 侧收到请求后应先进行 sign 签名校验，校验失败请返回错误状态。
2. 在 Seamless 模式下，余额需实时反映玩家主钱包当前可用于下注的真实资金数额。