交易记录统计接口

功能概述

此接口用于查询钱包账户查询区间内总交易笔数和总金额与查询区间内每月收支总交易笔数和金额。

接口地址

https://webox-api.5upay.com/webox/trade/stat

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一 id，可在商户后台查看 M
walletId 钱包 ID varchar(19) 用户钱包在我司的唯一编号 M
tradeType 交易类型 固定值 WEBOX_RECHARGE 充值 O
WEBOX_TRANSFER 转账
WEBOX_TRANSFER_REFUND 转账退款
WEBOX_WITHHOLDING 提现
WEBOX_REDPACKET 红包
WEBOX_REDPACKET_ONE_TO_ONE 一对一红包
WEBOX_REDPACKET_GROUP_NORMAL 普通群红包
WEBOX_REDPACKET_GROUP_LUCK 拼手气红包
WEBOX_REDPACKET_REFUND 红包退款
WEBOX_MERCHANT_RECHARGE 企业付款
WEBOX_APP_PAY 支付
WEBOX_APP_PAY_REFUND 支付退款
SPLIT_PAYMENT 分账
SPLIT_REFUND_PAYMEN 分账退款
如果不选，默认包括所有交易类型。
startQueryMonth 开始月份 varchar(20) 格式：yyyy-MM 例如 2020-05 M
endQueryMonth 结束月份 varchar(20) 格式：yyyy-MM 例如 2020-06 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 M

参数示例

{ "endQueryMonth": "2020-06", "hmac": "tRuqyyoTD+SYESOsYWaTCLcU9ELjjbNKNBU27PjEekubVHOEr2Yh/vcgPVctwUNFcM DzQxpVe4H2a/XVDuFNU+9JmMjMF9h61a3tBCo95H4Xzc+zo5OwRE584fr9zqqNhej5yo 8u7TjYpsbZk62DLNND0f+yb4nc9CKfuQxT7NcQ44lcp0JunXO32JBTTpTQJc3VSXBan8 ZBhcGlNjM5rxelB6BZ84yjo/Ubomynu4ZsDS/S7b+E5TkciPlgsjYpCBSL2Wq3KBCUpsDY nFXOlIWI+m/BEOsgzui5cWwKAaikHvha/uYhMGXuSvZeElUfFgDS1Wg7P9pxictFQx5S wQ==", "merchantId": "896669767", "startQueryMonth": "2020-03", "tradeType": "WEBOX_REDPACKET", "walletId": "5188146774251870128" }

同步返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 响应正常
FAIL 响应异常
merchantId 商户编号 同请求参数
walletId 钱包 ID 同请求参数
tradeType 交易类型 同请求参数
monthItem 每月统计 见下表（每月统计列表）
totalStatistics 汇总统计 见下表（汇总统计列表）
hmac 参数签名 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程

每月统计列表

参数名称 参数中文名称 参数说明
tradeMonth 查询月份 查询月份
direction 资金方向 资金方向
totalCount 总笔数 总笔数
totalAmount 总金额 单位为分

汇总统计列表

参数名称 参数中文名称 参数说明
direction 资金方向 资金方向
totalCount 总笔数 单位为分
totalAmount 总金额 单位为分

参数示例

{ "hmac": "kD+EP4FKcxCuATNzNFYEoFaxqK8EOVtYuhSrLB/9o395Bojd7X30BHyBpUb72fJe0Mx +yl1hrZvzBMDWp8F05UESAOnq7XEHCuQzblvGZfglFLV4m/vsC/3uEHud8qJT3Kf5BR1 mmNC8BRgnsR57dEWHuYDe/ekxQaQ8TifOF9/CgntS1giLwrwZcut8nuMkX1awlNqGxP 961K0hBO/EGIQmJDrxrWSrPtMfaRbFvllwEUEOg2EPaDnO7NJSCfRWYsv1MgqxbAmB Mf00UvQV1ovBcmQQ9iGO7Ufw/TJsj8y0KnT2gpSn8uNLYgmc3Y8G+FPS2cPbGTslEtE Ct+Ebkg==", "merchantId": "896671642", "monthItem": [{ "direction": "INCREASE", "totalAmount": 778, "totalCount": "19", "tradeMonth": "2020-06" }, { "direction": "DECREASE", "totalAmount": 829, "totalCount": "15", "tradeMonth": "2020-06" }], "status": "SUCCESS", "totalStatistics": [{ "direction": "INCREASE", "totalAmount": 778, "totalCount": "19" }, { "direction": "DECREASE", "totalAmount": 829, "totalCount": "15" }], "tradeType": "", "walletId": "64765324365012992" }