改变用户余额
MINI.GAME调用该接口改变玩家余额
ChangeBalance
该API接口由 接入方 提供 MINI.GAME平台 进行调用
POST {ACCESS_URL}/api/balance/change_balance?trace_id=minigame_trace_id
Headers
Content-Type
"application/json; charset=utf-8"
sign
"minigame_sign_string"
Body
app_id
string
商户的唯一标识
可通过商户后台获得
player_login_token
string 非必填
接入方上传的用户token,登录凭证，/api/user/verify_session接口验证成功的token
uname
string
接入方提供的用户id
money
decimal
余额变动（正、负）
game_id
integer
游戏id
session_id
string
游戏局号 每局游戏会产生的唯一识别
order_id
string
订单号,每次有金额改变会产生的唯一编号(长度最长64位)
timestamp
integer
时间戳(秒)
bet
decimal
下注金额,该值始终为正数,只有在玩家下注时才会有值
end_round
bool
当前局是否结束
cancel_order_id
string
仅当type=2时有值，表示取消的是哪一笔订单
MINI.GAME请求参数示例
{
"app_id": "10013",
"bet": 3,
"game_id": 74,
"currency":"usdt",
"money": -3,
"order_id": "20240716195311drxaoz1mxx6g",
"player_login_token": "66de94a2-4368-11ef-a0be-581122c6f6d4",
"session_id": "1813180074526625845",
"timestamp": 1721130791,
"uname": "1006417",
"end_round": false,
"type": 1,
"cancel_order_id": "",
"award_order_ids": null
}接入方响应参数示例
{
"data": {
"balance": "4289.1"
},
"code": 1,
"msg": "ok"
}成功返回示例的参数说明
data
是
object
返回数据
balance
是
decimal
余额(最多支持4位小数)
code
是
integer
状态码
msg
是
string
提示信息
错误码
更多返回错误代码请查阅 通用错误码 页面描述
*award_order_ids 字段说明
order_id
是
string
注单id
money
是
string(decimal)
派奖金额
*type 字段说明
流程举例说明：
游戏下注→游戏返奖并通知游戏对局结束；对应type1→4；玩家在游戏投注，没有多次奖励，返奖后，进行牌局技术验证。此情况适用大部分游戏流程（单次返奖流程）；
游戏下注→取消下注；对应type1→2；玩家在游戏内进行投注，对局开始前自主取消下注 （mini类的游戏无法自主取消下注，spribe平台切换游戏时，会自动取消下注）
游戏下注→有中奖→对局中返奖→对局中返奖→对局中返奖········→游戏返奖并游戏通知对局结束；对应type1→3→3→········→4；
特殊说明： ①②一般为百人场、miniGame类游戏；取消下注的session_id与下注的session_id一致； ③玩家在游戏内进行投注，此局中奖1次或多次直到对局结束；此种情况一般为连消类slot、slot游戏进入特殊玩法、彩票类游戏；
minigame请求ChangeBalance接口示例参数举例
type=1 用户下注
{
"app_id": "10013",
"bet": "3",
"game_id": 74,
"money": "-3",
"order_id": "20240716195311drxaoz1mxx6g",
"player_login_token": "66de94a2-4368-11ef-a0be-581122c6f6d4",
"session_id": "1813180074526625845",
"timestamp": 1721130791,
"uname": "1006417",
"end_round": false,
"type": 1,
"cancel_order_id": "",
"award_order_ids": null
}type=2 用户取消下注
{
"app_id": "13",
"player_login_token": "4533126b-f5af-11ee-9a0f-000c2901d9cc",
"uname": "1033201",
"money": "10000",
"game_id": 100001,
"session_id": "1777333924821798912",
"order_id": "10920408215323di4cal9or8ji",
"timestamp": 1712584403,
"bet": "0",
"type": 2,
"end_round": false,
"cancel_order_id":"20240408215323di4cal9or8jk",
"award_order_ids":null
}type=3 游戏对局中返奖
{
"app_id": "10013",
"bet": "0",
"game_id": 100001,
"money": "33.66",
"order_id": "20240715204114drtuiv8r7ny8",
"player_login_token": "6049348c-42a7-11ef-a0bd-581122c6f6d4",
"session_id": "24713",
"timestamp": 1721047274,
"uname": "1006415",
"end_round": false,
"type": 3,
"cancel_order_id": "",
"award_order_ids": [
{
"order_id": "20240715204030drtugi3tau4g",
"money": "5.1"
},
{
"order_id": "20240715204053drtuhqp0jthc",
"money": "10.2"
},
{
"order_id": "20240715204104drtuibx5hlhc",
"money": "18.36"
}
]
}type=4 中奖并通知接入方对局结束
{
"app_id": "10013",
"bet": "0",
"game_id": 100001,
"money": "33.66",
"order_id": "20240715204114drtuiv8r7ny8",
"player_login_token": "6049348c-42a7-11ef-a0bd-581122c6f6d4",
"session_id": "24713",
"timestamp": 1721047274,
"uname": "1006415",
"end_round": false,
"type": 4,
"cancel_order_id": "",
"award_order_ids": [
{
"order_id": "20240715204030drtugi3tau4g",
"money": "5.1"
},
{
"order_id": "20240715204053drtuhqp0jthc",
"money": "10.2"
},
{
"order_id": "20240715204104drtuibx5hlhc",
"money": "18.36"
}
]
}Last updated