红包记录统计接口

功能概述

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

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一 id，可在商户后台查看 M
walletId 钱包 ID varchar(19) 用户钱包在我司的唯一编号 M
tradeType 交易类型 固定值 WEBOX_REDPACKET 微包红包 O
WEBOX_REDPACKET_ONE_TO_ONE 一对一红包
WEBOX_REDPACKET_GROUP_NORMAL 普通群红包
WEBOX_REDPACKET_GROUP_LUCK 拼手气红包
WEBOX_REDPACKET_REFUND 红包退款
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": "o2+NQts1Ds/YplLJ6t889TLz+pp591PmMejyM9VdpIobZ5lqNep+cGgiyofZ+nmrUx5VWk uWJwGFhroZwUIsoAFs57JVkRF5L1riRDJPs/+XGN9/zS9gYWl5t5/PUAs4Ogf7477A916 eI3FQ/zYUB8jJr0h/7q4l/QMzaERI6h3x26CC5V6Jnz12lM4tRGIX12NCX+5EWG+aCZyIk v9I2/5qMs9IUmUl2t2bGa5BLtpvAxAUs+bzPAyDv0nzcLbEJQldqnyLZsr5AVsABfi/oflsqiW LhTWwJx8ij77kq1yzMGPRuVNQ/3COOeetcPcOOB3WUdjmeBRabx5f2Fvk1A==", "merchantId": "896671642", "monthItem": [{ "direction": "INCREASE", "totalAmount": 332, "totalCount": "11", "tradeMonth": "2020-06" }, { "direction": "DECREASE", "totalAmount": 362, "totalCount": "8", "tradeMonth": "2020-06" }], "status": "SUCCESS", "totalStatistics": [{ "direction": "INCREASE", "totalAmount": 332, "totalCount": "11" }, { "direction": "DECREASE", "totalAmount": 362, "totalCount": "8" }], "tradeType": "", "walletId": "64765324365012992" }