更新时间:2024-10-24 GMT+08:00
分享

查询收支明细

功能介绍

伙伴在伙伴销售平台上查询自身的收支明细情况。

接口约束

该接口只允许使用合作伙伴AK/SK或者Token调用。

调试

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

URI

GET /v2/accounts/partner-accounts/account-change-records

表1 查询参数

参数

是否必选

参数类型

取值范围

描述

balance_type

String

[BALANCE_TYPE_DEBIT|BALANCE_TYPE_CREDIT]

账户类型。

  • BALANCE_TYPE_DEBIT:现金账户
  • BALANCE_TYPE_CREDIT:信用账户

trade_type

String

[RECHARGE|DEDEUCT|REFUND|RFROZEN|TRANS|ADJUST|BEADJUST|BERETRIEVE|BEUNBIND|BONUSCONVERT|TRADE_MODE_TRANSFER]

交易类型。

  • RECHARGE:充值
  • DEDEUCT:消费
  • REFUND:退款
  • RFROZEN:冻结
  • TRANS:转账,余额和保证金互换(老商务模式,当前已无保证金账户)
  • ADJUST:调账(华为核销等)
  • BEADJUST:经销商拨款
  • BERETRIEVE:经销商回收
  • BEUNBIND:解绑/关联模式切换导致的回收
  • BONUSCONVERT:奖励金转换(老商务模式,当前已无奖励金账户)
  • TRADE_MODE_TRANSFER:交易模式变更

此参数不携带或携带值为空时,不作为筛选条件。

trade_time_begin

String

最大长度:10

查询收支明细的开始日期。

说明:
  • 东八区时间,格式为YYYY-MM-DD,如“2017-10-21”。
  • 默认值为一年前的当天日期。

trade_time_end

String

最大长度:10

查询收支明细的结束日期。

说明:
  • 东八区时间,格式为YYYY-MM-DD,如“2017-12-21”。
  • 默认值为当前日期。

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。

limit

Integer

[1-100]

每次查询的数量,默认值为10。

indirect_partner_id

String

最大长度:64

云经销商ID。获取方法请参见查询云经销商列表

说明:

华为云总经销商(一级经销商)查询云经销商(二级经销商)的收支明细时,需携带此参数;除此之外,此参数不作处理。否则只能查询自身的收支明细。

请求消息

请求参数

请求示例

GET https://bss.myhuaweicloud.com/v2/accounts/partner-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-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度:20

状态码。具体参见状态码。只有失败才会返回这个参数。

error_msg

String

最大长度:2000

错误描述信息。只有失败才会返回这个参数。

total_count

Integer

-

返回总条数。

currency

String

最大长度:4

币种。

CNY:人民币。

records

List<AccountChangeRecord>

-

调账记录列表。

具体请参见表2

表2 AccountChangeRecord

参数

参数类型

取值范围

描述

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:代金券回收

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

变更后余额,单位为元。

type

String

最大长度:64

收支类型。

  • 1:收入
  • 2:支出

响应示例

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",
            "type": "1"
        }
    ]
}

状态码

  • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
  • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

HTTP状态码

错误码

描述

400

CBC.0100

参数错误。

400

CBC.99000037

您没有操作该云经销商的权限。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

相关文档