1、抢红包时请筛选出成功领取红包的用户请求,调用此抢红包接口。
2、以正确的流水号抢红包:
24 小时内,如果红包已领完,则将返回“红包已抢完”
24 小时外,不论红包是否抢完,返回“红包已过期”。
https://webox-api.5upay.com/webox/redpacket/grab
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 | M |
requestId | 订单号 | varchar(32) | 红包预下单流水号加上自定义号(自定义号不能大于 13 位数字)同一个红包下自定义不能重复,不能超过 32位 | M |
serialNumber | 红包预下单流水号 | varchar(19) | 红包预下单时,返回的交易流水号 | M |
walletId | 接收方钱包ID | varchar(19) | 用户钱包在我司的唯一编号 | M |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
status | 响应状态 | SUCCESS 响应正常 |
FAIL 响应异常 | ||
orderStatus | 抢红包状态 | INIT 初始化状态 |
SUCCESS 成功 | ||
CANCEL 取消 | ||
merchantId | 商户编号 | 同请求参数 |
requestId | 抢红包订单号 | 同请求参数 |
serialNumber | 抢红包交易流水号 | 首信易支付系统交易流水号 |
receiveWalletId | 接收钱包 ID | 接收钱包 ID |
amount | 金额 | 红包的金额 |
completeDateTime | 完成时间 | 子红包领取时间,格式:yyyy-MM-dd HH:mm:ss |
hmac | 参数签名 | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |