获取余额

获取玩家余额，该API接口由商户(运营商)提供，供游戏平台进行调用

请求地址

POST {API_URL_ROOT}/player/getBalance

注意：此地址，可在商户后台进行配置，但输入、输出参数需要满足下面要求

Request参数

`Header`内容

参数名	必填	类型	说明
sign	是	string	签名，使用签名算法计算得到
timestamp	是	int	UTC时间戳，单位秒，从1970年1月1日到现在所经过的秒数，如：1741837297
Accept-Language	是	string	接收的语言编码，参考语言列表，如：zh,en，以便在报错的时候，提供响应的语言错误信息。
Content-Type	是	string	"application/json; charset=utf-8"

`BODY`内容

参数名	类型	说明
tenantId	int	商户ID, 平台给你分配的唯一的整数
userId	string	商户的玩家ID, 能够区分每一个玩家的ID

注意：不管isSuccess为true还是false，都应该正确得返回当前账户余额，系统会根据balance值更新当前账户余额，如果当前账户状态异常，不能玩游戏，balance一定返回0

Response参数

参数名	必填	类型	说明
tenantId	是	int	商户ID, 平台给你分配的唯一的整数
userId	是	string	商户的玩家ID, 能够区分每一个玩家的ID
balance	是	double	玩家余额
currency	否	string	游戏币种

示例

{
  "isSuccess": true,
  "code": 0,
  "data": {
    "tenantId": 1,
    "userId": "t1_276682",
    "balance": 100000,
    "currency": "BRL"
  }
}
//玩家被禁用场景：
{
  "isSuccess": false,
  "code": xxx,//商户状态异常的错误代码，比如：2014
  "message":"玩家被禁用",
  "data": {
    "tenantId": 1,
    "userId": "t1_276682",
    "balance": 0.0,    //强制为0
    "currency": "BRL"
  }
}

results matching ""

No results matching ""