Skip to main content

检查余额

步骤 1：获取访问令牌 ​

请参考 访问令牌 了解如何获取 访问令牌, 然后将其放入请求头 Authorization.

步骤 2：准备请求参数 ​

生成 nonceStr 和 timestamp, 它们将放入请求头并用于生成签名 签名.

参数 类型 必填 描述 示例
nonceStr 字符串 是 随机字符串 7a70f55482a5566c
timestamp 字符串 是 请求的 UNIX 时间戳 1667061151361

请求参数 ​

参数 类型 必填 描述 示例
- - 否 此请求不需要任何请求参数。发送空 JSON 对象即可。 {}

请求示例

{}

按字母顺序排序 JSON 键并压缩格式

信息

{}

将数据编码为 Base64 格式

信息

e30=

使用 CLIENT_SYMMETRIC_KEY 加密 Base64 数据

信息

e4e9ac1120ed867a7af108af8b1ab918b7c8e32e31f9f6d6ca5abf0ad4a882462067f58dbd76446b344f2f5849144ab9

步骤 3：生成签名 ​

请参考 签名算法 了解如何获取签名, 然后将其放入请求头 X-Signature.

步骤 4：POST 到 /gateway/v1/getBalance 端点

方法 : POST

端点: https://api.superpay.club/gateway/v1/getBalance

请求 ​

请求头 ​

参数 类型 描述
Authorization 数字 Token 步骤 1 获取
X-Nonce-Str String nonceStr 步骤 2 获取
X-Timestamp String timestamp 步骤 2 获取
X-Signature String signature 步骤 3 获取

请求体 ​

参数 类型 描述 示例
data String 使用 CLIENT_SYMMETRIC_KEY 加密的数据 e4e9ac1120ed...49144ab9

请求头与 Body 示例

{
  "headers": {
    "Authorization": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "X-Nonce-Str": "7a70f55482a5566c",
    "X-Timestamp": "1667061151361",
    "X-Signature": "sha256 zOzjz8QoGTbesuAO5CCFbPCF3EMDtohKtkQ..."
  },
  "body": {
    "data": "e4e9ac1120ed867a7af108af8b1ab918b7c8e32e31f9f6d6ca5abf0ad4a882462067f58dbd76446b344f2f5849144ab9"
  }
}

响应 ​

请求体 ​

参数 类型 描述 示例
code String API 状态码 1
encryptedData String 需使用 CLIENT_SYMMETRIC_KEY 解密的加密数据 a83cf72884cbbb....3ddf0744646e0cf0b482
message String 本次余额请求的明文信息 success

响应示例

{
  "code": "1",
  "encryptedData": "a83cf72884cbbb....3ddf0744646e0cf0b482",
  "message": "success"
}

步骤 5：使用 CLIENT_SYMMETRIC_KEY 解密 encryptedData ​

对称方式解密 encryptedData, a83cf72884cbbb....3ddf0744646e0cf0b482
使用 CLIENT_SYMMETRIC_KEY, PCd1dlEmFnBXaVce06Pzp7Vike0oHnVJ

明文结果如下

{
  "code": "1",
  "data": {
      "available_balance": 1250.25,
      "pending_balance": 50.00,
      "locked_balance": 20.00
  },
  "message": "success"
}