更新时间：2024-01-18 GMT+08:00
查询账户余额
接口约束
- 客户查询自身的账户余额的时候，只允许使用客户自身的AK/SK或者Token调用。
- 此接口不适用于伙伴的转售类客户。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v2/accounts/customer-accounts/balances
请求消息
请求参数
无。
请求示例
GET https://bss-intl.myhuaweicloud.com/v2/accounts/customer-accounts/balances HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
响应消息
响应参数
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
error_code |
String |
最大长度：20 |
状态码。具体请参见状态码。 只有失败才会返回这个参数。 |
error_msg |
String |
最大长度：2000 |
错误描述信息。 只有失败才会返回这个参数。 |
account_balances |
List<AccountBalanceV2> |
- |
账户余额列表。 具体请参见表1。 |
debt_amount |
BigDecimal |
- |
欠款总金额。 |
measure_id |
Integer |
- |
金额的度量单位。
|
currency |
String |
最大长度：4 |
币种。 USD：美元。 |
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
account_id |
String |
最大长度：64 |
账户标识。 |
account_type |
Integer |
- |
账户类型。
|
amount |
Bigdecimal |
- |
账户余额。 当account_type=2时，信用账户余额为总信用额度，非剩余信用额度。 |
currency |
String |
- |
币种。 USD：美元。 |
designated_amount |
Bigdecimal |
- |
专款专用余额。 |
credit_amount |
Bigdecimal |
- |
总信用额度，仅信用账户存在该字段。 |
measure_id |
Integer |
- |
度量单位。
|
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
"account_balances": [
{
"account_id": "AT001017264D6E9FF7",
"account_type": 1,
"amount": 0,
"currency": "USD",
"designated_amount": 0,
"credit_amount": 0,
"measure_id": 1
},
{
"account_id": "AT001017264D6EA084",
"account_type": 5,
"amount": 0,
"currency": "USD",
"designated_amount": 0,
"credit_amount": 0,
"measure_id": 1
}
],
"debt_amount": 120.0,
"measure_id": 1,
"currency": "USD"
}
父主题： 管理账户
