抢红包接口

功能概述

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

参数示例

{ "merchantId": "890000595", "requestId": "1527746602492", "serialNumber":"56d2649370d54d3eb0e2c64d7f1e5813", " walletId ":"1233345", "hmac": null }

同步返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 响应正常
FAIL 响应异常
orderStatus 抢红包状态 INIT 初始化状态
SUCCESS 成功
CANCEL 取消
merchantId 商户编号 同请求参数
requestId 抢红包订单号 同请求参数
serialNumber 抢红包交易流水号 首信易支付系统交易流水号
receiveWalletId 接收钱包 ID 接收钱包 ID
amount 金额 红包的金额
completeDateTime 完成时间 子红包领取时间,格式:yyyy-MM-dd HH:mm:ss
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

参数示例

{ "status":"SUCCESS", "orderStatus":"SUCCESS", "merchantId":"890000595", "requestId":"1571654460635", "serialNumber":"12345678", "receiveWalletId":"11111111" "amount":"5", "completeDateTime":"2019-10-21 18:51:17", "hmac":"IpsfuWXscJCvcSCMtHbDZIqpFwG+TcvD3tLVbuZGflIbBv7DDigsYARc2h7b6oR Oec/9DKb41CqYWw2E7IegMj+OmDRUZOF6pXgNE8l7sAW+68UKJ4xKOFRCyqmw4H HZaxh7An5Ml/IYI1pfUYyAVSfaQGdnef4CTdkq+JJfBTjB2BED6CE0sCBEtWE7eT/bOYE +Ha1wlVhpbBxRG8/301QK5WtVh8l5whsdqDw+WqqEw5DMoxpBopZfrF8oxqNA/6/Fzb/ ZApUG4rwzRfFXBQaGQHZVe+JFTuOoXfDhPrdqT5Qhm6i2OZindeHx2Q0YoCxMNKu9f YIupX1Vw53Stg==", }