此接口适用于红包支付成功 24 小时以内查询红包的领取信息(如:子红包领取人、领取金额、领取时间)。
备注:如果已获知订单已经为终态时,请保存。后续查询请查询本地数据,不要再次调用此接口。
https://webox-api.5upay.com/webox/redpacket/grabHistory
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 | M |
| serialNumber | 红包交易流水号 | varchar(50) | 红包预下单返回的流水号 | M |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| status | 响应状态 | SUCCESS 响应正常 |
| FAIL 响应异常 | ||
| merchantId | 商户编号 | 同请求参数 |
| serialNumber | 交易流水号 | 首信易支付系统交易流水号 | receivers | 接收方信息 | 见下表(接收方信息) |
| hmac | 参数签名 | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| serialNumber | 抢红包交易流水号 | 抢红包交易流水号 |
| walletId | 接收钱包 ID | 接收钱包 ID |
| amount | 接收金额 | 单位为分 |
| completeDateTime | 红包领取时间 | 格式:yyyy-MM-dd HH:mm:ss |
| seq | 红包顺序号 | 根据领红包的时间倒序排序,返回整数型 1,2,3 等 |