余额查询

接口地址

POST /v1/api/balance

请求

请求参数

变量名	必填	类型	示例值	描述
`mcode`	是	string	`M10086`	商户 ID
`cur`	否	string	`PHP`	指定货币，不传递则会返回所有钱包.对应Key是List
`ts`	是	string	`1785138705251`	请求毫秒时间戳长度13位
`sign`	是	string	`c380be...`	签名值

请求示例

{
  "mcode": "M10086",
  "cur": "PHP",
  "ts": "1785138705251",
  "sign": "c8bbeab3ffb1f0f16f4...."
}

返回参数

字段名	变量名	类型	描述
状态码	`code`	number	响应码，`0` 表示成功
响应数据	`data`	object	响应数据对象
─ 商户号	`data.mcode`	string	商户 ID
─ 货币	`data.cur`	string	货币代码
─ 账户余额	`data.bal`	string	余额
─ 锁定金额	`data.lock`	string	锁定金额
─ 异常金额	`data.excpt`	string	异常金额
─ 结算金额	`data.stl`	string	结算金额
─ 签名	`data.sign`	string	返回签名

返回示例

传递cur的返回示例

{
  "code": 0,
  "data": {
    "mcode": "M10086",
    "cur": "PHP",
    "bal": "100.2000",
    "lock": "0.0000",
    "excpt": "0.0000",
    "stl": "100.2000",
    "sign": "xxxx"
  }
}

注意：不传递cur的返回示例

{
  "code": 0,
  "data": null,
  "list": [
    {
      "mcode": "B123123",
      "cur": "",
      "bal": "572.8000",
      "lock": "0.0000",
      "excpt": "0.0000",
      "stl": "",
      "sign": "8jPS6eaid00qyRtJoMt4kE0ZFIv8vL6xauAbQmY27HA="
    },
    {
      "mcode": "B123123",
      "cur": "",
      "bal": "0.0000",
      "lock": "0.0000",
      "excpt": "0.0000",
      "stl": "",
      "sign": "xWFBW9KPCCUcySDBuLKkJVLj9AYg9kEBY9LRIb8cSnE="
    },
    {
      "mcode": "B123123",
      "cur": "",
      "bal": "0.0000",
      "lock": "0.0000",
      "excpt": "0.0000",
      "stl": "",
      "sign": "xWFBW9KPCCUcySDBuLKkJVLj9AYg9kEBY9LRIb8cSnE="
    }
  ]
}

注意：传递cur但对应钱包没开通，cur不合法的返回示例 ```json { "code": 0, "data": null, "list": [] } ```