用户通过此接口可以查询用户钱包余额的所有收支记录。
https://webox-api.5upay.com/webox/accountHistory/query
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 | M |
walletId | 钱包 ID | varchar(19) | 用户钱包在我司的唯一编号 | M |
currency | 币种 | varchar(15) | CNY 人民币 | M |
pageIndex | 当前页数 | varchar(2) | 查询的页码 | M |
pageSize | 每页多少条 | varchar(3) | 如果为空 默认 20 条,最大 100 条 | O |
tradeType | 交易类型 | varchar(50) | WEBOX_MERCHANT_RECHARGE 企业付款 | O |
WEBOX_APP_PAY 微包支付 | ||||
WEBOX_APP_PAY_REFUND 微包支付退款 | ||||
SPLIT_PAYMENT 微包分账 | ||||
SPLIT_REFUND_PAYMENT 微包分账退款 | ||||
如果不选,默认包括所有交易类型 | ||||
startDateTime | 开始日期 | varchar(20) | 格式:yyyy-MM-dd开始时间与结束时间只能查询 15 个自然日数据若超过,则从结束日期 endDateTime 起向前推15 天的 00:00:00 得到新开始时间 startDateTime作为时间条件并查询返回结果。若未超过,则以商户所查时间范围直接返回 | M |
endDateTime | 结束日期 | varchar(20) | 格式:yyyy-MM-dd开始时间与结束时间只能查询 15 个自然日数据若超过,则从结束日期 endDateTime 起向前推15 天的 00:00:00 得到新开始时间 startDateTime作为时间条件并查询返回结果。结束日期取对应日期的 23:59:59若未超过,则以商户所查时间范围直接返回 | M |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
status | 响应状态 | SUCCESS 响应正常 |
FAIL 响应异常 | ||
merchantId | 商户编号 | 同请求参数 |
walletId | 钱包 ID | 同请求参数 |
pageIndex | 当前页数 | 同请求参数 |
pageSize | 每页的条数 | 同请求参数 |
returnSize | 查询当前结果条数 | 查询当前结果条数 |
tradeType | 交易类型 | 同请求参数 |
startDateTime | 开始日期 | 格式:yyyy-MM-dd HH:mm:ss |
endDateTime | 结束日期 | 格式:yyyy-MM-dd HH:mm:ss |
records | 记录列表 | 见下表(记录列表) |
hmac | 参数签名 | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
requestId | 订单号 | 订单号 |
direction | 资金方向 | INCREASE 增加(入账) |
DECREASE 减少(出账) | ||
tradeType | 交易类型 | WEBOX_MERCHANT_RECHARGE 企业付款 |
WEBOX_APP_PAY 微包支付 | ||
WEBOX_APP_PAY_REFUND 微包支付退款 | ||
SPLIT_PAYMENT 微包分账 | ||
SPLIT_REFUND_PAYMENT 微包分账退款 | ||
currency | 货币 | CNY 人民币 |
amount | 金额 | 单位为分 |
balance | 剩余金额 | 单位为分 |
createDateTime | 入账时间 | 格式:yyyy-MM-dd HH:mm:ss |