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

查询伙伴账户余额

分享
更新时间: 2020/03/05 GMT+08:00

功能介绍

合作伙伴可以查询伙伴的账户余额或者查询关联伙伴的某个客户账户余额。

Web UI

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

  1. 伙伴可以在伙伴中心总览页面的“账户信息”区域查询伙伴自身的账户余额。
  2. 伙伴查询关联伙伴的某个客户账户余额的操作步骤如下:
  1. 在伙伴中心左侧导航栏中选择“客户业务 > 我的客户”。
  2. 在客户列表中,选择一条客户记录,在“可用额度”列即可查询客户的账户余额。

REST API

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

该接口只允许使用合作伙伴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。

    • 空:查询合作伙伴账户余额。
    • 非空:查询垫付类客户的账户余额。
  1. 请求消息

    请求参数

    无。

    请求示例

    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-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

  1. 响应消息

    响应参数

    参数

    是否必选

    参数类型

    描述

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

  1. 状态码

    状态码

    描述

    CBC.0000

    成功。

    CBC.0999

    其他错误。

    CBC.0105

    非法的Token。

    CBC.0117

    请求非法。

    CBC.5001

    非合作伙伴。

    CBC.5002

    合作伙伴的客户不存在。

    CBC.5003

    余额不足。

    CBC.5004

    无对该客户的操作权限。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区