Skip to content

查询指定区域内的商户余额

此API用于列出指定国家中的所有子商户的余额。

温馨提示

此API仅在子商户账号被单独记录时有效，不满足以上条件时，会出现：Feature is not supported的异常提示。

HTTP 请求

BaseURL https://open.merchant.liquido.com

GET /open-api/all/sub-merchant/balance

Request Headers
{
    "Authorization": "Bearer {{access_token}}"
}
Request Example
curl "https://open.merchant.liquido.com/open-api/all/sub-merchant/balance?countryCode=BR"
Content-Type: application/json
{
    "code": 200,
    "msg": "success",
    "data": [
      {
        "subMerchantId": "1fe62922-dd3b-44ae-a51f-c45b62b15555" ,
        "subMerchantName": "ABC",
        "totalBalance": 0,
        "availableBalance": 0,
        "currency": "USD"
      },
      {
        "subMerchantId": "1fe62922-dd3b-44ae-a51f-c45b62b16666" ,
        "subMerchantName": "DEF",
        "totalBalance": 0,
        "availableBalance": 0,
        "currency": "USD"
      }
    ]
}

HTTP Headers 字段说明

Key Value
Authorization "Bearer" + " " + {{access_token}}

Request Params 字段说明

参数 必填 类型 描述
countryCode String 国家代码, 枚举: BR,MX,US,CO,CL

Response Body 字段说明

参数 类型 描述
code Int 状态码，如 200
msg String 状态信息，如 "success"
data JSON 返回数据

对象字段说明

Data (List)

参数 类型 描述
subMerchantId String 子商户ID
subMerchantName String 子商户名字
totalBalance Int 子商户的余额(单位：分)
availableBalance Int 子商户的可提现余额(单位：分)
currency String 货币种类, 如 BRL、MXN
Back to top