客户运营能力-查询收支明细:URI

时间:2024-10-24 20:09:01

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:支出

此参数不携带时,不作为筛选条件;此参数携带值不允许为空、null、空串,有枚举值校验。

trade_type

String

最大长度:20

交易类型。

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

此参数不携带、携带值为空时,不作为筛选条件;此参数携带值为null,作为筛选条件过滤;此参数不允许为空串,有正则校验。

trade_time_begin

String

最大长度:10

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

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

此参数不携带、携带值为空时,不作为筛选条件;此参数不允许携带值为空串或值为null,有参数校验。

trade_time_end

String

最大长度:10

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

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

此参数不携带、携带值为空时,不作为筛选条件;此参数不允许携带值为空串或值为null,有参数校验。

trade_id

String

最大长度:128

交易ID/订单ID。

此参数不携带、携带值为空时,不作为筛选条件;携带值为null时,作为筛选条件;此参数不允许为空串,有正则校验。

payment_channel_id

String

最大长度:64

交易渠道。可以一次查询多个,用逗号分隔。

  • 0:无交易渠道
  • 1:支付宝
  • 2:银行转账
  • 4:支付宝/网银
  • 5:微信支付
  • 6:提现
  • 7:激励返点
  • 10:交易模式变更
  • 11:调账
  • 317:银联(统一支付平台)
  • 319:Huawei Pay
  • 320:华为支付

此参数不携带、携带值为空时,不作为筛选条件;此参数携带值为空串或为null时,作为筛选条件过滤。

payment_channel_no

String

最大长度:64

交易渠道流水号。

此参数不携带、携带值为空时,不作为筛选条件;此参数携带值为null,作为筛选条件过滤;此参数不允许为空串,有正则校验。

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。

此参数不携带、为null或携带值为空时,默认传参为0;此参数不允许为空串,有参数校验。

limit

Integer

[1-100]

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

此参数不携带时,默认传参为10;此参数不允许为空、空串或为null,有参数校验。

support.huaweicloud.com/api-oce/mac_00003.html