账户收支明细查询接口

功能概述

用户通过此接口可以查询用户钱包余额的所有收支记录。

接口地址

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

参数示例

{ "merchantId": "890000595", "walletId ":"1233345", "pageIndex":"1", "pageSize":"20", "tradeType":"WEBOX_REDPACKET", "startDateTime":"2019-10-16 09:30:00", "endDateTime":"2019-10-26 09:30:00", "currency":"CNY", "hmac": null }

同步返回参数列表

参数名称 参数中文名称 参数说明
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的方法请参考请求加密流程

记录列表(records)

参数名称 参数中文名称 参数说明
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

参数示例

{ "status":"SUCCESS", "merchantId":"890000595", "walletId":"11111111", "pageIndex":"1", "pageSize":"20", "returnSize":"20", "startDateTime":"2019-10-20 19:00:00", "endDateTime":"2019-10-30 19:00:00", "records":[{ "amount":"200", "balance":"899500", "createDateTime":"2019-10-30 30:52:04", "currency":"CNY", "direction":"INCREASE", "requestId":"20191030033450374203159553449984", "tradeType":"WEBOX_REDPACKET", }, { "amount":"10", "balance":"899400", "createDateTime":"2019-10-25 25:15:58", "currency":"CNY", "direction":"DECREASE", "requestId":"20191025112438372372150184779776", "tradeType":"WEBOX_RECHARGE_FEE", }], "hmac":"F3S8dF2Sq0cm8Xg2AOo9tyuUZRWFpq7VA9hadBX+x48VsOqVTrKvE32wI0XC DKumCdHHCSuoyOJcJgHq+5vtuAC52Txfw050bz1zv2VmI8mK2+F6DML1GsLDqtjWX2 MTa39LrxOIDahQY4yt26e23qA8otXkj32YDCciihnpUSYq3TcwZ7ir+o4q1n2D3KNmqlRvX PP0sJYpCS4IG6SFR3n7BdKpv5tarQMErGpx0kWY/a7Ctb8UvlEW8KkyGWk/M7BGQ84 XKtM6Lw/C2XpoPZCQeZZjedQmV0h6/KU+wuxcLaQAnV8GreSEWxbOzjQKT/RpCwZP MW/uCdRCLdazKA==" }