文档首页 > > API参考> 管理交易> 管理客户账户> 查询子客户账户余额

查询子客户账户余额

分享
更新时间: 2020/06/28 GMT+08:00

功能介绍

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

Web UI

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

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

REST API

伙伴在伙伴销售平台查询关联的垫付类客户的账户余额。

  • 该接口只允许使用合作伙伴AK/SK或者Token调用。
  • 推荐类客户是客户在华为云充值,合作伙伴无法调用此接口查询其账户余额。垫付类客户的账户由合作伙伴拨款,所以可以查询到。

  1. 调试

    您可以在API Explorer中直接运行调试该接口。

  2. URI

    POST /v2/accounts/customer-accounts/balances/batch-query

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    customer_infos

    List<CustomerInfo>

    最大个数:100

    客户的客户信息列表。

    具体请参见表1

    表1 CustomerInfo

    参数

    是否必选

    参数类型

    取值范围

    描述

    customer_id

    String

    最大长度:64

    客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id

    请求示例

    POST https://bss.myhuaweicloud.com/v2/accounts/customer-accounts/balances/batch-query HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
    {
      "customer_infos": [
        {
          "customer_id": "04fcc8e9dd00d5ad0f9dc017971dcec0"
        }
      ]
    }

  1. 响应消息

    响应参数

    参数

    参数类型

    描述

    error_code

    String

    状态码。

    具体请参见5

    error_msg

    String

    错误描述信息。

    customer_balances

    List<CustomerBalances>

    账户余额列表。只有成功的时候才返回。

    具体请参见表2

    表2 CustomerBalances

    参数

    参数类型

    描述

    customer_id

    String

    客户账号ID。

    debt_amount

    BigDecimal

    客户欠款总额度。

    amount

    BigDecimal

    客户可用总额度。

    currency

    String

    币种。

    CNY:人民币。

    measure_id

    Integer

    度量单位:

    • 1:元
    • 2:角
    • 3:分

    响应示例:

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time  
    {
        "customer_balances": [
            {
                "customer_id": "05377f723980d4330f06c01929ec37a0",
                "debt_amount": 0,
                "amount": 100000.0,
                "currency": "CNY",
                "measure_id": 3
            }
        ]
    }

  1. 状态码

    HTTP状态码

    错误码

    描述

    400

    CBC.0100

    参数错误。

    400

    CBC.5001

    非合作伙伴。

    400

    CBC.5002

    合作伙伴的客户不存在。

    400

    CBC.5004

    无对该客户的操作权限。

    403

    CBC.0151

    访问拒绝。

    500

    CBC.0999

    未知错误。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问