24小时内红包查询接口

功能概述

此接口适用于红包支付成功 24 小时以内查询红包的领取信息(如:子红包领取人、领取金额、领取时间)。

备注:如果已获知订单已经为终态时,请保存。后续查询请查询本地数据,不要再次调用此接口。

接口地址

https://webox-api.5upay.com/webox/redpacket/grabHistory

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一 id,可在商户后台查看 M
serialNumber 红包交易流水号 varchar(50) 红包预下单返回的流水号 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "890000595", "serialNumber": "1527746602492", "hmac": null }

同步返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 响应正常
FAIL 响应异常
merchantId 商户编号 同请求参数
serialNumber 交易流水号 首信易支付系统交易流水号
receivers 接收方信息 见下表(接收方信息)
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

接收方信息

参数名称 参数中文名称 参数说明
serialNumber 抢红包交易流水号 抢红包交易流水号
walletId 接收钱包 ID 接收钱包 ID
amount 接收金额 单位为分
completeDateTime 红包领取时间 格式:yyyy-MM-dd HH:mm:ss
seq 红包顺序号 根据领红包的时间倒序排序,返回整数型 1,2,3 等

参数示例

{ "merchantId":"890000595", "serialNumber": "20191101141206375053684138393600", "receivers": [ { "walletId": "13704400121211430", "amount": "100", "completeDateTime": "2019-12-04 09:11:00", "serialNumber": "20191101141206375053284132393600" "seq": "1" }, { "walletId": "13704400121211431", "amount": "100", "completeDateTime": "2019-12-04 09:11:01", "serialNumber": "20191101141206375053284132393601" } ], "status": "SUCCESS" }