跳到主要内容

查询会员余额

查询指定会员的当前余额。

API 信息​

  • 端点：POST /v2/members/balance
  • 认证：Bearer Token
  • 加密：请求使用 AES-256-GCM 加密，响应为明文 JSON

请求​

请求标头​

POST /v2/members/balance HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 56ffd5ecd8a3a4457863a0bd7c298fb2
x-signature: 904e97bee2589b93e9747eed0346c68b23d8ff8b568dabaf4b94a5e89093df67

请求参数​

加密前的参数​

{
  "username": "player001"
}

加密后的请求体​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
欄位类型必填说明
usernamestring是会员账号

响应​

成功响应​

{
  "code": 0,
  "message": "No Error.",
  "data": {
    "agentId": "AGENTTHB01",
    "username": "gameTest1",
    "currency": "THB",
    "balance": 993.92,
  },
}

响应欄位说明​

欄位类型说明
data.agentIdstring代理商 ID
data.usernamestring会员账号
data.currencystring币别代码
data.balancenumber当前余额

错误响应​

{
  "code": 8,
  "message": "The User is not exist.",
  "logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}

常見错误码​

状态码说明
8会员不存在
11参数错误
19账号无效
81分支配置未找到
83认证失敗
84解密失敗

更多错误码说明请参考：附录 - 错误码总览

注意事项​

  1. 即时性：返回的是当前实时余额
  2. Currency一致：余额以会员創建时设定的Currency显示
  3. 精度：余额保留至多小数后 6 位

相关 API​