获取用户余额

MINI.GAME调用该接口获取玩家当前余额

GetBalance

该API接口由 接入方 提供 MINI.GAME平台 进行调用

POST {ACCESS_URL}/api/balance/get_balance?trace_id=minigame_trace_id

{ACCESS_URL}为接入方后台填写的回调地址

Headers

Name	Value
Content-Type	"application/json; charset=utf-8"
sign	"minigame_sign_string"

签名算法请查阅 签名算法及示例 页面描述

Body

Name	Type	Description
app_id	string	商户的唯一标识 可通过商户后台获得
game_id	integer 非必填	游戏id
player_login_token	string非必填	接入方上传的用户token，登录凭证，/api/user/verify_session接口验证成功的token
uname	string	接入方提供的用户id
currency	string	货币名称，详情查看货币列表支持的货币的name字段
timestamp	integer	时间戳(秒)

MINI.GAME请求参数示例

{
    "app_id": "13",
    "player_login_token": "50f15a92-ee8d-11ee-9a61-00ff3fae08f7",
    "uname": "1003803",
    "game_id": 9,
    "currency":"usdt",
    "timestamp": 1711954264
}

接入方响应参数示例

success

{
    "data": {
        "balance": "4299.1"
    },
    "code": 1,
    "msg": "ok"
    }
}

fail

{
    "code": 10002,
    "msg": "sign invalid"
}

成功返回示例的参数说明

平台方只记录余额的数值，具体货币单位根据接入方后台选择为准

参数名	必选	类型	说明
data	是	object	返回数据
balance	是	string (decimal)	余额 (最多支持4位小数)
code	是	integer	状态码
msg	是	string	提示信息

错误码

更多返回错误代码请查阅 通用错误码 页面描述