You need to enable JavaScript to run this app.
导航
费用中心
  • 文档首页
    • /
  • 费用中心

QueryBalanceAcct - 资金账户余额查询

最近更新时间：2024.03.19 18:30:56

首次发布时间：2024.03.19 18:30:56

我的收藏

查询资金账户余额

调试

API Explorer
您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

无请求参数

返回参数

名称
类型
示例值
描述
Result
BalanceInfoResult

{
"AccountID": 2100057992,
"ArrearsBalance": "",
"AvailableBalance": "",
"CashBalance": "",
"CreditLimit": "0",
"FreezeAmount": "5",
"SubjectNo": "3423"
}

余额信息的结构体

ResponseMetadata
ResponseMetadata

成功结果：
{
"RequestId": "20230911191620E0E1EB0DD549F73076D9",
"Action": "QueryBalanceAcct",
"Version": "2022-01-01",
"Service": "billing"
}
失败结果：
{
"RequestId": "202308231151363C400BE8545DED89C174",
"Action": "QueryBalanceAcct",
"Version": "2022-01-01",
"Service": "bill_volcano_engine",
"Error": {
"Code": "InvalidParam",
"Message": "The parameter [AccountID] is invalid."
}
}

返回头信息

请求示例

curl --location --request GET 'https://trade-api.byted.org/open-apis/trade_balance?Version=2022-01-01&Action=QueryBalanceAcct' \
--header 'Authorization: Basic QUtUQWIwQTRhaxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'X-Top-Service: billing' \
--header 'X-Top-Account-Id: 21000xxxxx'

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202308231151163C400BE8545DED89B87D",
        "Action": "QueryBalanceAcct",
        "Version": "2022-01-01",
        "Service": "billing"
    },
    "Result": {
        "AccountID": 2100057992,
        "ArrearsBalance": "1",
        "AvailableBalance": "77.01",
        "CashBalance": "83.01",
        "CreditLimit": "0",
        "FreezeAmount": "5",
    }
}

错误码

下表提供了该接口业务逻辑相关的错误码。公共错误码请参见公共错误码。

HttpCode
错误码
错误信息
描述
500
InternalError
The request has failed due to an unknown error

系统未知异常，请重试

400
RecordNoFound
The Record No Found.

查询无记录

400
InvalidParam
The parameter is invalid

请求参数非法