查询用户余额

接入方查询用户在MINI.GAME平台的余额

GetPlayerWallet

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

POST {MINIGAME_APIURL}/api/cash/v1/getPlayerWallet?trace_id=your_trace_id

{MINIGAME_APIURL}为MINI.GAME接口域名,可通过后台获得

Headers

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

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

Body

Name	Type	Description
appid	string	商户的唯一标识 可通过商户后台获得
timestamp	integer	时间戳(秒)
token	string	用户在MINI.GAME平台的token,可以通过获取玩家鉴权token接口获得
currency	string	货币名称，详情查看货币列表支持的货币的name字段

接入方请求参数示例

{
    "appid": "13",
    "timestamp": 1711954264,
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjcmVhdGUiOjE3MTk2Mjk2NDQsInVzZXIiOiJ7XCJpZFwiOjM1NzE0MSxcIm9wZXJhdGVyX2lkXCI6MSxcImFnZW50X2lkXCI6MTAwMDIwLFwiYXBwX2lkXCI6MTAzMSxcImFjY291bnRfdHlwZVwiOjAsXCJ2YWx1ZVwiOlwiMVwiLFwibm93X2dhbWVfaWRcIjowfSJ9.tXfaavxZu7PIedpJ5Tp7oL0aBEnb5ujok4cbKWoNj0U",
    "currency": "usdt"
}

MINI.GAME平台响应参数示例

success

{
    "data": {
         "currency":"usdt",
         "balance":999.999,
    },
    "code": 0,
    "msg": "ok"
}

fail

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

成功返回示例的参数说明

参数名	下级	必选	类型	说明
data	—-	Yes	object	返回的数据
—-	balance	Yes	decimal	余额(最多支持4位小 数)
—-	currency	Yes	string	货币名称，详情查看货币列表支持的货币的name字段
code	—-	Yes	integer	状态码
msg	—-	Yes	string	提示信息

错误码

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