Skip to content

查询单个子商户余额

此API用于查询子商户在指定国家中的余额。

温馨提示

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

HTTP 请求

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

GET /open-api/sub-merchant/balance

Request Headers
{
    "Authorization": "Bearer {{access_token}}"
}
Request Example
curl "https://open.merchant.liquido.com/open-api/sub-merchant/balance?countryCode=BR&subMerchantId=234567"
Content-Type: application/json
{
    "code": 200,
    "msg": "success",
    "data": {
        "totalBalance": 9999,
        "availableBalance": 0,
        "currency": "BRL"
    }
}

HTTP Headers 字段说明

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

Request Params 字段说明

参数 必填 类型 描述
countryCode String 国家代码, 枚举: BR,MX,US,CO,CL
subMerchantId String 子商户的ID

Response Body 字段说明

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

对象字段说明

Data

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