文档首页> 合作伙伴中心> API参考> 待下线接口> 管理交易> 管理客户账户> 查询客户账户余额

更新时间：2022-05-24 GMT+08:00

查看PDF

查询客户账户余额

功能介绍

合作伙伴可以批量查询关联的客户的账户余额。

该接口即将下线，“查询客户账户余额”接口请参考查询客户账户余额。

Web UI

伙伴可以登录伙伴中心查询关联的客户的账户余额。

在伙伴中心左侧导航栏中选择“客户业务 > 我的客户”。
在客户列表中的“可用额度”列即可查询客户的账户余额。

REST API

伙伴在伙伴销售平台批量查询关联的代售类客户的账户余额。

该接口只允许使用合作伙伴AK/SK或者Token调用。
顾问销售类客户是客户在华为云充值，合作伙伴无法调用此接口查询其账户余额。代售类客户的账户由合作伙伴拨款，所以可以查询到。

URI

POST /v1.0/{partner_id}/partner/account-mgr/customer-balances

参数说明请参见下表。

参数	是否必选	取值范围	描述
partner_id	是	最大长度：64	合作伙伴ID（华为分配）。获取方法请参见如何获取合作伙伴ID（partner_id）。此参数暂不校验。

参数

是否必选

取值范围

描述

partner_id

是

最大长度：64

合作伙伴ID（华为分配）。

获取方法请参见如何获取合作伙伴ID（partner_id）。

此参数暂不校验。

请求消息

请求参数

参数	是否必选	参数类型	取值范围	描述
customer_infos	是	List<CustomerInfo>	最大个数：100	客户信息列表。具体请参见表1。

参数

是否必选

参数类型

取值范围

描述

customer_infos

是

List<CustomerInfo>

最大个数：100

客户信息列表。

具体请参见表1。

表1 CustomerInfo
参数	是否必选	参数类型	取值范围	描述
customer_id	是	String	最大长度：64	客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。

请求示例

POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/account-mgr/customer-balances HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
    "customer_infos": [
        {
            "customer_id": "26*****e20"
        },
        {
            "customer_id": "11*****e67"
        }
    ]
}

响应消息

响应参数

参数	是否必选	参数类型	描述
error_code	是	String	状态码。具体请参见4。
error_msg	是	String	错误描述信息。
customer_balances	是	List<CustomerBalances>	账户余额列表。具体请参见表2。

参数

是否必选

参数类型

描述

error_code

是

String

状态码。

具体请参见4。

error_msg

是

String

错误描述信息。

customer_balances

是

List<CustomerBalances>

账户余额列表。

具体请参见表2。

表2 CustomerBalances
参数	是否必选	参数类型	描述
customer_id	是	String	客户账号ID。
be_id	否	String	合作伙伴对应的运营实体Id。
payer_customerId	否	String	支付方客户账号ID。
debt_amount	否	Number	客户欠款总额度。
available_amount	否	Number	客户可用总额度。
currency	否	String	币种。 CNY：人民币
measure_unit	否	Integer	度量单位： 1：元 2：角 3：分

响应示例:

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_balances": [
        {
            "customer_id": "26*****e20",
            "be_id": "10",
            "payer_customerId": "26*****e20",
            "debt_amount": 0,
            "available_amount": 1990,
            "currency": "CNY",
            "measure_unit": 1
        },
        {
            "customer_id": "11b*****e67",
            "be_id": "10",
            "payer_customerId": "26*****e20",
            "debt_amount": 0,
            "available_amount": 1990,
            "currency": "CNY",
            "measure_unit": 1
        }
    ]
}

状态码

状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。

状态码	描述
CBC.0000	成功。
CBC.0100	参数错误。
CBC.0151	访问拒绝。
CBC.0999	未知错误。
CBC.0105	非法的Token。
CBC.0117	请求非法。
CBC.5001	非合作伙伴。
CBC.5002	合作伙伴的客户不存在。
CBC.5003	余额不足。
CBC.5004	无对该客户的操作权限。