余额查询回调

游戏商查询玩家在 VCT 平台的余额。

说明

此接口由游戏商调用 VCT 平台，用于 Seamless（无缝钱包）模式下的余额查询。Agent 需实现此接口供游戏商回调。

接口信息

属性	值
路径	POST /api/v1/callback/balance
调用方	游戏商 → VCT 平台

请求参数（游戏商发送）

参数名	类型	必填	说明
provider	string	是	游戏商标识（由请求来源自动识别）
username	string	是	玩家用户名
currency	string	否	货币代码
sign	string	是	请求签名
timestamp	long	是	请求时间戳

响应字段

字段	类型	说明
balance	decimal	玩家当前余额
currency	string	货币代码
username	string	玩家用户名

游戏商来源映射

游戏商	回调路径	请求格式
BG	open.operator.user.balance	JSON-RPC 2.0（sn/sign/random）
GSC	seamless/balance	JSON（operator_code/sign/request_time）
SA	GetUserBalance	加密 URL-encoded body
WM	webhook（cmd=CallBalance）	form-data（cmd/signature/user）