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

查询账户余额

分享
更新时间: 2019/11/15 GMT+08:00

功能介绍

客户可以查询自身的账户余额。

Web UI

客户登录费用中心进入“总览”页面,在“可用额度”区域可以查询自身的账户余额。

REST API

客户在客户自建平台查询自身的账户余额。

客户查询自身的账户余额的时候,只允许使用客户自身的AK/SK或者Token调用。

  1. URI

    GET /v1.0/{domain_id}/customer/account-mgr/balances

    参数说明请参见下表。

    表1 URI参数说明

    参数

    是否必选

    取值范围

    描述

    domain_id

    最大长度:64

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

  1. 请求消息

    请求参数

    无。

    请求示例

    GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/balances HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

  1. 响应消息

    响应参数

    参数

    是否必选

    参数类型

    描述

    error_code

    String

    状态码。

    具体请参见4

    error_msg

    String

    错误描述信息。

    account_balances

    List<AccountBalance>

    账户余额列表。

    具体请参见表2

    debtAmount

    Number

    欠款总金额。

    measureId

    Integer

    度量单位:

    1:元;

    2:角;

    3:分。

    currency

    String

    币种。

    CNY:人民币。

    表2 AccountBalance

    参数

    是否必选

    参数类型

    描述

    account_id

    String

    账户标识。

    account_type

    Integer

    账户类型。

    • 1:余额
    • 2:信用
    • 5:奖励
    • 7:保证金

    amount

    Double

    余额。

    currency

    String

    币种。

    CNY:人民币。

    值为空代表人民币。

    designated_amount

    Double

    专款专用余额。

    credit_amount

    Double

    总信用额度,仅信用账户存在该字段。

    measure_unit

    Integer

    度量单位。

    1:元

    memo

    String

    备注。

    type

    String

    • 0:华为云账户
    • 1:伙伴拨款账户

      仅当客户关联合作伙伴且关联类型为垫付模式时,才会存在伙伴拨款账户。

    响应示例

    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",
    	"account_balances": [{
    			"account_id": "AT001016B6A58D3D60",
    			"account_type": 1,
    			"amount": 20810.92,
    			"currency": "CNY",
    			"designated_amount": 14999.98,
    			"credit_amount": null,
    			"measure_unit": 1,
    			"memo": null,
    			"type": "1"
    		},
    		{
    			"account_id": "AT001016B6A58D3D81",
    			"account_type": 5,
    			"amount": 0,
    			"currency": "CNY",
    			"designated_amount": 0,
    			"credit_amount": null,
    			"measure_unit": 1,
    			"memo": null,
    			"type": "1"
    		}
    	],
    	"debtAmount": 0,
    	"measureId": 1,
    	"currency": "CNY"
    }

  1. 状态码

    状态码

    描述

    CBC.0000

    成功。

    CBC.0999

    其他错误。

    CBC.0151

    访问拒绝。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区