请登录后查看
ListCustomersBalancesDetail
查询客户账户余额
POST
https://bss.myhuaweicloud.com/v2/accounts/customer-accounts/balances/batch-query
只看必填项
填写默认值
密文显示特定参数
接口说明
合作伙伴可以查询关联的代售类客户的账户余额。
伙伴登录伙伴中心查询客户余额请参见这里。
说明: 顾问销售类客户是客户在华为云充值,合作伙伴无法调用此接口查询其账户余额。代售类客户的账户由合作伙伴拨款,所以可以查询到。
约束说明
该接口只允许使用合作伙伴AK/SK或者Token调用。
URL
POST https://bss.myhuaweicloud.com/v2/accounts/customer-accounts/balances/batch-query
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
X-Auth-Token | string | header | 是 | 合作伙伴Token调用 |
Body参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
customer_infos | Array of CustomerInfoV2 objects | 是 | 客户信息列表。 具体请参见表1。 |
indirect_partner_id | string | 否 | 云经销商ID。获取方法请参见查询云经销商列表。 华为云总经销商(一级经销商)查询云经销商(二级经销商)子客户的账户余额时,需要携带该参数。除此之外,此参数不做处理。 |
参数：
customer_infos
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
customer_id | string | 是 | 客户账号ID。您可以调用查询客户列表接口获取customer_id。 |
返回参数
返回码: 200
查询客户账户余额响应
| 名称 | 类型 | 描述 |
|---|---|---|
customer_balances | Array of CustomerBalancesV2 objects | 账户余额列表。只有成功的时候才返回。 此列表不包含非代售类子客户的数据。批量查询客户余额时,若入参携带了非代售类子客户,会被过滤。 具体请参见表2。 |
200 customer_balances
| 名称 | 类型 | 描述 |
|---|---|---|
customer_id | string | 客户账号ID。 |
debt_amount | number | 客户欠款总额度。 |
amount | number | 客户可用总额度。 |
currency | string | 币种。 CNY:人民币。 |
measure_id | integer | 度量单位: 1:元 |
返回码: 400
参数错误
请求示例
示例 1
"POST https://bss.myhuaweicloud.com/v2/accounts/customer-accounts/balances/batch-query"
{
"customer_infos": [
{
"customer_id": "0bb43f81c000d3a10f19c014228fb580"
}
],
"indirect_partner_id": "0ba6fe16eb80d2390f54c01379e93740"
}返回示例
返回码：200
查询客户账户余额响应
示例 1
"customer_balances": [
{
"customer_id": "05377f723980d4330f06c01929ec37a0",
"debt_amount": 0,
"amount": 1000,
"currency": "CNY",
"measure_id": 1
}
]
}
SDK
点击 运营能力开放 (BSS) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明。
变更历史
2023-06-01
查询客户账户余额
POST
ListCustomersBalancesDetail
修改
变更参数
本文导读
接口说明
约束说明
URL
请求参数
返回参数
请求示例
返回示例
SDK
错误码
变更历史