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

查询客户账户余额

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

功能介绍

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

Web UI

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

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

REST API

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

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

  1. URI

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

    参数说明请参见下表。

    参数

    是否必选

    取值范围

    描述

    partner_id

    最大长度:64

    合作伙伴ID(华为分配)。

    获取方法请参见如何获取合作伙伴ID(partner_id)

    此参数暂不校验。

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    customer_infos

    List<CustomerInfo>

    -

    客户的客户信息列表。

    具体请参见表1

    表1 CustomerInfo

    参数

    是否必选

    参数类型

    取值范围

    描述

    customer_id

    String

    最大长度:64

    客户账号ID。

    请求示例

    POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/account-mgr/customer-balances HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
    
    {
        "customer_infos": [
            {
                "customer_id": "26*****e20"
            },
            {
                "customer_id": "11*****e67"
            }
        ]
    }

  1. 响应消息

    响应参数

    参数

    是否必选

    参数类型

    描述

    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

    币种。

    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
            }
        ]
    }

  1. 状态码

    状态码

    描述

    CBC.0000

    成功。

    CBC.0100

    参数错误。

    CBC.0151

    访问拒绝。

    CBC.0999

    未知错误。

    CBC.0105

    非法的Token。

    CBC.0117

    请求非法。

    CBC.5001

    非合作伙伴。

    CBC.5002

    合作伙伴的客户不存在。

    CBC.5003

    余额不足。

    CBC.5004

    无对该客户的操作权限。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问