更新时间：2024-06-27 GMT+08:00
查询伙伴账户余额（旧）
Web UI
伙伴可以登录伙伴中心查询伙伴的账户余额或者查询关联伙伴的某个客户账户余额。
- 伙伴可以在伙伴中心总览页面的“账户余额”区域查询伙伴自身的账户余额。
- 伙伴查询关联伙伴的某个客户账户余额的操作步骤如下：
- 在伙伴中心顶部导航栏中选择“销售 > 客户业务 > 我的客户”。
- 在客户列表中，选择一条客户记录，在“可用额度”列即可查询客户的账户余额。
REST API
伙伴在伙伴销售平台查询伙伴的账户余额或者查询关联伙伴的某个代售类客户账户余额。
该接口只允许使用合作伙伴AK/SK或者Token调用。
- URI
GET /v1.0/{partner_id}/partner/account-mgr/balances
参数说明请参见下表。
表1 路径参数 参数
是否必选
取值范围
描述
partner_id
是
最大长度：64
合作伙伴ID（华为分配）。
获取方法请参见如何获取合作伙伴ID（partner_id）。
此参数暂不校验。
表2 查询参数 参数
是否必选
参数类型
取值范围
描述
customer_id
否
String
最大长度：64
客户ID。
- 空：查询合作伙伴账户余额（不携带或携带值为空时，查询合作伙伴账户余额）。
- 非空：查询代售类客户的账户余额（携带值为空串时，作为筛选条件；不能查询非代售类客户的账户余额）。
- 请求消息
无。
请求示例
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
- 响应消息
参数
是否必选
参数类型
描述
error_code
是
String
状态码。
具体请参见4。
error_msg
是
String
错误描述信息。
customer_id
否
String
客户帐号ID。
- 查询伙伴的客户账户余额时，填写客户账号ID。
- 查询合作伙伴账户时，为空或空串。
account_balances
否
List<AccountBalance>
账户余额列表。
具体请参见表3
表3 AccountBalance 参数
是否必选
参数类型
描述
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 } ] }
父主题： 管理客户账户
