下注扣款回调
游戏商通知 VCT 平台扣减玩家余额(下注)。
说明
此接口由游戏商调用 VCT 平台,用于 Seamless(无缝钱包)模式下的下注扣款。
接口信息
| 属性 | 值 |
|---|---|
| 路径 | POST /api/v1/callback/bet |
| 调用方 | 游戏商 → VCT 平台 |
请求参数(游戏商发送)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
provider | string | 是 | 游戏商标识 |
username | string | 是 | 玩家用户名 |
amount | decimal | 是 | 扣款金额(正数) |
transaction_id | string | 是 | 交易唯一 ID(幂等性控制) |
round_id | string | 否 | 游戏回合 ID |
game_code | string | 否 | 游戏代码 |
game_type | string | 否 | 游戏类型 |
bet_detail | object | 否 | 下注详情 |
sign | string | 是 | 签名 |
timestamp | long | 是 | 时间戳 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
balance | decimal | 扣款后余额 |
transaction_id | string | 交易 ID |
status | string | 处理状态:success / insufficient_balance / player_not_found |
游戏商来源映射
| 游戏商 | 回调路径 | 请求格式 |
|---|---|---|
| BG | open.operator.order.transfer | JSON-RPC 2.0,包含 orders 数组 |
| GSC | seamless/withdraw | JSON,batch_requests 中含 transactions |
| SA | PlaceBet | 加密 body |
| WM | webhook(cmd=PointInout, code=2) | form-data |