# 查询伙伴账户余额（旧） #### 功能介绍 合作伙伴可以查询伙伴的账户余额或者查询关联伙伴的某个客户账户余额。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 该接口即将下线，"查询伙伴账户余额"新接口请参考[查询伙伴账户余额-ListPartnerBalances](https://support.huaweicloud.com/api-bpconsole/mt_060003.html)。 #### Web UI 伙伴可以登录伙伴中心查询伙伴的账户余额或者查询关联伙伴的某个客户账户余额。 1. 伙伴可以在伙伴中心总览页面的"账户余额"区域查询伙伴自身的账户余额。 2. 伙伴查询关联伙伴的某个客户账户余额的操作步骤如下： 1. 在伙伴中心顶部导航栏中选择"销售 \> 客户业务 \> 我的客户"。 2. 在客户列表中，选择一条客户记录，在"可用额度"列即可查询客户的账户余额。 #### REST API 伙伴在伙伴销售平台查询伙伴的账户余额或者查询关联伙伴的某个代售类客户账户余额。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。 1. URI GET /v1.0/{partner_id}/partner/account-mgr/balances 参数说明请参见下表。 表1路径参数 | 参数 | 是否必选 | 取值范围 | 描述 | |:---|:---|:---|:---| | partner_id | 是 | 最大长度：64 | 合作伙伴ID（华为分配）。 获取方法请参见如何获取合作伙伴ID（partner_id）。 此参数暂不校验。 | 表2查询参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | customer_id | 否 | String | 最大长度：64 | 客户ID。 - 空：查询合作伙伴账户余额（不携带或携带值为空时，查询合作伙伴账户余额）。 - 非空：查询代售类客户的账户余额（携带值为空串时，作为筛选条件；不能查询非代售类客户的账户余额）。 | 2. 请求消息 请求参数 无。 请求示例 ``` GET https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/account-mgr/balances?customer_id=9*****b40 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ ``` 3. 响应消息 响应参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | error_code | 是 | String | 状态码。 具体请参见[4]。 | | error_msg | 是 | String | 错误描述信息。 | | customer_id | 否 | String | 客户账号ID。 - 查询伙伴的客户账户余额时，填写客户账号ID。 - 查询合作伙伴账户时，为空或空串。 | | account_balances | 否 | List\ | 账户余额列表。 具体请参见[表3] | 表3AccountBalance | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | account_id | 是 | String | 账户标识。 | | account_type | 是 | Integer | 账户类型： - 1：余额 - 2：信用 - 5：奖励 - 7：保证金 - 8：可拨款 | | amount | 是 | Double | 余额。 | | currency | 是 | String | 币种。 CNY：人民币 | | designated_amount | 否 | Double | 专款专用余额。 | | credit_amount | 否 | Double | 总信用额度。 | | measure_unit | 是 | Integer | 度量单位。 1：元。 | | memo | 否 | String | 备注。 | 响应示例 ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_code": "CBC.0000", "error_msg": "success", "customer_id": "92c*****b40", "account_balances": [ { "amount": 57.5, "currency": "CNY", "memo": null, "account_id": "AT0*****117", "account_type": 1, "designated_amount": 5, "credit_amount": 0, "measure_unit": 1 }, { "amount": 26, "currency": "CNY", "memo": null, "account_id": "AT0*****3A0", "account_type": 5, "designated_amount": 5, "credit_amount": 0, "measure_unit": 1 }, { "amount": 0, "currency": "CNY", "memo": null, "account_id": "AT0*****693", "account_type": 7, "designated_amount": 0, "credit_amount": 0, "measure_unit": 1 }, { "amount": 0, "currency": "CNY", "memo": null, "account_id": "AT0*****931", "account_type": 2, "designated_amount": null, "credit_amount": 0, "measure_unit": 1 } ] } ``` 4. 状态码 | HTTP状态码 | 错误码 | 描述 | |:---|:---|:---| | 200 | CBC.0000 | 成功。 | | 500 | CBC.0999 | 其他错误。 | | 400 | CBC.0100 | 参数错误。 | | 403 | CBC.0151 | 访问拒绝。 | | 200 | CBC.5002 | 合作伙伴的客户不存在。 |