# 查询收支明细-ListCustomerAccountChangeRecords #### 功能介绍 客户可以查询自身的收支明细情况。 ![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png) 查询时间跨度最大限制为一年。 #### 接口约束 客户查询自身的收支明细的时候，只允许使用客户自身的AK/SK或者Token调用。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=ListCustomerAccountChangeRecords)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[策略授权参考](https://support.huaweicloud.com/api-oce/jac_000053.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 描述 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | |:---|:---|:---|:---|:---|:---| | billing:balance:view | 授予查看收支明细，付款历史记录，消费配额，调账记录，欠费查询的权限 | list | - | - | - | #### URI GET /v2/accounts/customer-accounts/account-change-records 表1查询参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | balance_type | 是 | String | \[BALANCE_TYPE_DEBIT\|BALANCE_TYPE_CREDIT\] | 账户类型。 - BALANCE_TYPE_DEBIT：现金账户 - BALANCE_TYPE_CREDIT：信用账户 说明： 伙伴的代售类客户无信用账户。 | | revenue_expense_type | 否 | String | \[REVENUE\|EXPENSE\] | 收支类型。 - REVENUE：收入 - EXPENSE：支出 此参数不携带时，不作为筛选条件；此参数携带值不允许为空、空串，有枚举值校验。 | | trade_type | 否 | String | 最大长度：20 | 交易类型。 - RECHARGE：充值 - DEDEUCT：消费 - REFUND：退款 - RFROZEN：冻结 - TRANS：转账，余额和保证金互换（老商务模式，当前已无保证金账户） - ADJUST：调账（华为核销等） - BEADJUST：经销商拨款/企业主拨款 - BERETRIEVE：经销商回收/企业主回收 - BEUNBIND：解绑/关联模式切换导致的回收 - EXPIRED：过期清零 - BONUSCONVERT：奖励金转换（老商务模式，当前已无奖励金账户） - TRADE_MODE_TRANSFER：交易模式变更 - DEPOSIT：保证金 此参数不携带、携带值为空时，不作为筛选条件。 | | trade_time_begin | 否 | String | 最大长度：10 | 查询收支明细的开始日期。 说明： - 东八区时间，格式为YYYY-MM-DD，如"2017-10-21"。 - 默认值为一年前的当天日期。 此参数不携带、携带值为空时，取默认值。 | | trade_time_end | 否 | String | 最大长度：10 | 查询收支明细的结束日期。 说明： - 东八区时间，格式为YYYY-MM-DD，如"2017-12-21"。 - 默认值为当前日期。 此参数不携带、携带值为空时，取默认值。 | | trade_id | 否 | String | 最大长度：128 | 交易ID/订单ID。 此参数不携带、携带值为空时，不作为筛选条件。 | | payment_channel_id | 否 | String | 最大长度：64 | 交易渠道。可以一次查询多个，用逗号分隔。 - 0：无交易渠道 - 1：支付宝 - 2：银行转账 - 4：支付宝/网银 - 5：微信支付 - 6：提现 - 7：激励返点 - 10：交易模式变更 - 11：调账 - 317：银联（统一支付平台） - 319：Huawei Pay - 320：华为支付 此参数不携带、携带值为空时，不作为筛选条件。 | | payment_channel_no | 否 | String | 最大长度：64 | 交易渠道流水号。 此参数不携带、携带值为空时，不作为筛选条件。 | | offset | 否 | Integer | \[0-最大整数\] | 偏移量，从0开始。默认值为0。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2\~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 此参数不携带或携带值为空时，默认传参为0。 | | limit | 否 | Integer | \[1-100\] | 每次查询的数量，默认值为10。 此参数不携带时，默认传参为10；此参数不允许为空。 | #### 请求消息 **请求参数** 无 **请求示例** ``` GET https://bss.myhuaweicloud.com/v2/accounts/customer-accounts/account-change-records?balance_type=BALANCE_TYPE_DEBIT&trade_type=RECHARGE&trade_time_begin=2020-10-20&trade_time_end=2021-10-20&offset=0&limit=10 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ ``` #### 响应消息 **响应参数** | 参数 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---| | error_code | String | 最大长度：20 | 状态码。具体参见[状态码]。只有失败才会返回这个参数。 | | error_msg | String | 最大长度：2000 | 错误描述信息。只有失败才会返回这个参数。 | | total_count | Integer | - | 返回总条数。 | | currency | String | 最大长度：4 | 币种。 CNY：人民币。 | | records | List\ | - | 收支明细记录列表。 具体请参见[表2]。 | 表2CustomerAccountChangeRecord | 参数 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---| | account_change_id | String | 最大长度：128 | 收支明细流水号。 | | trade_detail_type | String | 最大长度：128 | 交易详细类型。 - SOURCE_OPERAIION_ADJUST_CREDIT：调账(信用额度调整) - SOURCE_OPERAIION_RECHARGE：充值 - SOURCE_OPERAIION_DEDEUCT：消费(包年/包月) - SOURCE_OPERAIION_MANUALFROZE：冻结(人工冻结) - SOURCE_OPERAIION_MANUALUNFROZE：冻结(人工解冻) - SOURCE_OPERAIION_MANUALCLEARFROZEN：冻结(人工清零) - SOURCE_OPERAIION_TRANS_TO_BALANCE：转账(保证金转余额) - SOURCE_OPERATION_BEADJUST：企业拨款/伙伴拨款 - SOURCE_OPERATION_BEUNBIND：交易模式变更(切换/解除关联回收) - SOURCE_OPERAIION_EXPIRECLEAR：过期清零 - SOURCE_OPERAIION_ONETIME：消费(一次性扣费) - SOURCE_OPERAIION_REFUND：退款 - SOURCE_OPERAIION_UNFROZEN：退款(退款解冻) - SOURCE_OPERAIION_CLEARFROZEN：退款(退款清零) - SOURCE_OPERAIION_ADJUST：调账(余额调整) - SOURCE_OPERAIION_USAGE：消费(按需) - SOURCE_OPERAIION_WRITEOFF：消费(欠费还款) - SOURCE_OPERAIION_UNSUBSCRIBE：退款 - SOURCE_OPERAIION_RFROZEN：退款(退款冻结) - SOURCE_OPERAIION_TRANS_TO_FOREGIFT：转账(余额转保证金) - SOURCE_OPERAIION_PRIZE：调账(赠送) - SOURCE_OPERATION_BERETRIEVE：企业回收/伙伴回收 - SOURCE_OPERAIION_PRECISIONCOMP：消费(精度补扣) - SOURCE_OPERAIION_FREERESDEDUCT：消费(免费资源扣减) - SOURCE_OPERAIION_MERGE：奖励金转换(合并) - SOURCE_OPERAIION_CONVERT_BONUS：奖励金转换 - SOURCE_OPERAIION_RECHARGE_REBATE：充值(激励返点) - SOURCE_OPERATION_COUPONCANCEL：优惠券回收 - SOURCE_OPERAIION_BILLREFUND：调账(华为核销) - SOURCE_OPERATION_TRADEMODE_TRANSFER：交易模式变更(和伙伴关联) - SOURCE_OPERATION_SYSTEM_FROZEN：调账（余额调整） - SOURCE_OPERATION_SYSTEM_UNFROZEN：调账（余额调整） - SOURCE_OPERATION_COUPON_QUOTA_TRANSFER：调账(兑换现金券额度) - SOURCE_OPERATIION_RIDEDUCT：消费(预留实例) - SOURCE_OPERATION_COUPON_QUOTA_RECLAIM：代金券回收 - SOURCE_OPERATION_DEPOSIT_FROZEN：保证金冻结 - SOURCE_OPERATION_DEPOSIT_UNFROZEN：保证金解冻 - SOURCE_OPERAIION_SAVINGS_PLANS：消费(节省计划) - SOURCE_OPERAIION_WRITEOFF_CREDIT：消费(信用还款) | | trade_time | String | 最大长度：20 | 交易时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如"2016-03-28T14:45:38Z"。 | | trade_id | String | 最大长度：128 | 交易ID/订单ID。 | | change_amount | String | 最大长度：64 | 变更金额，单位为元。 | | balance_after_change | String | 最大长度：64 | 变更后余额，单位为元。 | | revenue_expense_type | String | 最大长度：64 | 收支类型。 - REVENUE：收入 - EXPENSE：支出 | | bill_cycle | String | 最大长度：7 | 账期。 | | payment_channel_id | String | 最大长度：128 | 交易渠道。 - 0：无交易渠道 - 1：支付宝 - 2：银行转账 - 4：支付宝/网银 - 5：微信支付 - 6：提现 - 7：激励返点 - 10：交易模式变更 - 11：调账 - 317：银联（统一支付平台） - 319：Huawei Pay - 320：华为支付 | | payment_channel_no | String | 最大长度：128 | 交易渠道流水号。 | | consume_time | String | 最大长度：64 | 消费时间。为UTC时间。 格式： - 包年/包月：与账单的交易时间一致，yyyy-MM-dd'T'HH:mm:ss'Z' - 按需/分期：标识账单的计费开始时间和结束时间，yyyy-MM-dd'T'HH:mm:ss'Z'\|yyyy-MM-dd'T'HH:mm:ss'Z'，如"2016-03-28T14:00:00Z\|2016-03-28T14:59:59Z"。 说明： - 包年/包月：交易类型为调账时，此字段标识账单的计费开始时间和结束时间。格式yyyy-MM-dd'T'HH:mm:ss'Z'\|yyyy-MM-dd'T'HH:mm:ss'Z'，如"2016-03-28T14:00:00Z\|2016-03-28T14:59:59Z"。 | | account_name | String | 最大长度：128 | 账号名称 | | cloud_service_type_name | String | 最大长度：200 | 云服务类型名称 | | resource_type_name | String | 最大长度：200 | 资源类型名称，该字段为预留字段。 | **响应示例** ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "total_count": 1, "currency": "CNY", "records": [ { "account_change_id": "AC-8500000373-0", "trade_detail_type": "SOURCE_OPERAIION_RECHARGE", "trade_time": "2021-04-02T06:05:38Z", "trade_id": "CB123456", "change_amount": "1053.35", "balance_after_change": "0.00", "revenue_expense_type": "REVENUE", "bill_cycle": "2018-08", "payment_channel_id": "4", "payment_channel_no": "AC6780*****73-0", "consume_time":"2025-07-25T23:15:24Z", "account_name":"hw83****62", "cloud_service_type_name":"弹性云服务器", "resource_type_name":"云主机" } ] } ``` #### 状态码 ![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png) - 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 - 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 | HTTP状态码 | 错误码 | 描述 | |:---|:---|:---| | 400 | CBC.0100 | 参数错误。 | | 400 | CBC.80021021 | 查询时间跨度最大限制为一年。 | | 403 | CBC.0151 | 访问拒绝。 | | 500 | CBC.0999 | 其他错误。 |