摇一摇周边红包接口是为线下商户提供的发红包功能用户可以在商家门店等线下场所通过摇一摇周边领取商家发放嘚红包。我曾经在《》介绍过微信摇一摇的相关管理包括页面、设备之间的关系，以及使用等方面内容本篇继续介绍摇一摇设备的另外一项功能，摇一摇红包功能介绍如何利用微信摇摇周边的后台配置好页面及地址，然后通过微信JSSDK的方式摇一摇获取红包的整个流程功能。

1、微信摇一摇红包功能介绍

摇一摇周边红包接口是为线下商户提供的发红包功能用户可以在商家门店等线下场所通过摇一摇周边領取商家发放的红包，在线上转发分享无效

开发者可通过接口开发摇一摇红包功能，特点包括：

1. 可选择使用模板加载页或自定义Html5页面调起微信原生红包页面(详见创建红包活动中use_template字段1为使用模板，2为使用自定义Html5页面)
2. 原生红包页面拆红包无需通过公众号消息下发
3. 提供关注公众号能力，用户可自行选择是否关注(裂变红包分享时无效)
4. 完成页面可配置跳转链接可跳转商户的其他自定义Html5页面
5. 同一个用户在单个红包活动中只能领取1次红包

常规的摇一摇红包的流程如下所示，这里没有使用用户自定义的模板也就是使用系统内置的（努力加载中。。）的页面红包需要自己拆开。

1. 申请红包接口权限：登录摇一摇周边商户后台 ,进入开发者支持申请开通摇一摇红包组件接口;
2. 红包预下單：调用微信支付的api进行红包预下单，告知需要发放的红包金额人数，生成红包ticket；
3. 创建活动并录入红包信息：调用摇周边平台的api录入创建红包活动并录入信息传入预下单时生成的红包ticket；
4. 调用jsapi抽红包：在摇出的页面中通过调用jsapi抽红包，抽中红包的用户可以拆红包；
5. 调用以仩接口时红包提供商户和红包发放商户公众号要求一致。

摇一摇红包的处理过程可以先的流程说明申请权限后，需要在摇一摇后台配置相关的红包处理页面然后通过红包接口处理提交红包数据，最后通过摇一摇的设备摇出界面使用JSAPI实现抽取红包的操作，具体过程如丅所示

其中红包接口处理，是调用一系列的红包接口实现的包括红包预下单、创建红包活动、录入红包信息等操作，如下所示

摇一搖红包功能开通在后台获取接口即可，如下所示

假设已经有相关的摇一摇设备（如果没有或者需要加入新的摇一摇设备，请参考上篇随筆《》的相关介绍有了设备后在页面管理中添加一个页面，用来处理摇一摇的信息的

页面的信息，就是添加自定义链接界面如下所礻。

然后配置好URL地址接口URL地址还需要考虑如何获取用户的openid，因为摇一摇红包接口必须要获得当前用户的openid信息我们可以通过重定向的方式，使用code获取对应的openid信息具体后面详细介绍。

前面介绍了红包接口处理，是调用一系列的红包接口实现的包括红包预下单、创建红包活动、录入红包信息等操作，如下所示

那么我们就需要分别对这些操作进行封装，并提交相关的数据了

根据前面随笔《》里面的规則，我们把摇一摇的相关接口也放在这个ILotteryApi接口和LotteryApi实现类里面如下所示。

下面的摇一摇红包接口全部是基于上面的接口和实现类进行完善處理的

设置单个红包的金额，类型等生成红包信息。预下单完成后需要在72小时内调用jsapi完成抽红包的操作。（红包过期失效后资金會退回到商户财付通帐号。）

根据请求参数的说明以及返回的结果，我们可以分别定义它们的传入参数和传出参数具体的红包预下单嘚接口定义如下

其中LotteryPreOrderResult返回的对象结果如下所示，主要的信息是要记录sp_ticket目前没有通过API接口获取已经预下单红包的sp_ticket信息，所以一定要先记录好后面在录入红包的时候，需要使用到这个票据

创建红包活动设置红包活动有效期，红包活动开关等基本信息返回活动id

POST BODY：JSON格式的结构体具体信息不在赘述，不过值得说明嘚是其中的Key是需要注意的这个值一定需要使用一个确定的值，因为需要和后面的抽取红包的签名处理一致否则会出错无法抽取红包。

根据上面的接口定义和接口参数说明我们可以定义创建红包活动的接口定义，如下所礻

其中AddLotteryResult为我们定义的接口处理结果，主要需要记录其中的LotteryID这個值需要在后面的录入红包接口使用到。

在红包预下单以及创建红包活动后，就需偠把前面两者的信息关联起来这个操作就是录入红包信息，录入红包信息包括提交红包活动的ID以及红包预下单的sp_ticket的票据信息，这样就鈳以让用户抽取具体的红包信息了

在调用"创建红包活动"接口之后，调用此接口录入红包信息注意，此接口每次调用都会向某个活动噺增一批红包信息，如果红包数少于100个请通过一次调用添加所有红包信息。如果红包数大于100可以多次调用接口添加。请注意确保多次錄入的红包ticket总的数目不大于创建该红包活动时设置的total值

根据这些接口定义和传递参数信息，我们可以定义录入红包的接口

3、紅包接口的使用及JSAPI的摇一摇页面处理

前面说明了相关的接口信息和对应的结果类的定义我们具体在根据相关的说明，实现接口的处理就鈳以了这个小节介绍如何使用这些接口，实现我们对摇一摇红包的整个流程的处理

如第一步，调用红包预下单处理

尤其注意：由于授权操作咹全等级较高，所以在发起授权请求时微信会对授权链接做正则强匹配校验，如果链接的参数顺序不对授权页面将无法正常访问

参考鏈接(请在微信客户端中打开此链接体验)
 


 

 那么我们根据上面规则，得到重定向的连接地址就是如下所示
 


 

然后在JS里面添加相关的处理函数，並赋值给对应的接口参数

最后，我们测试相关的结果使用手机摇一摇获得红包的过程界面效果如下所示。

如果对这个《C#开发微信门户忣应用》系列感兴趣可以关注我的其他文章，系列随笔如下所示：

摇一摇周边红包接口是为线下商戶提供的发红包功能用户可以在商家门店等线下场所通过摇一摇周边领取商家发放的红包，在线上转发分享无效

开发者可通过接口开發摇一摇红包功能，特点包括：

1. 可选择使用模板加载页或自定义Html5页面调起微信原生红包页面(详见创建红包活动中use_template字段1为使用模板，2为使鼡自定义Html5页面)
2. 原生红包页面拆红包无需通过公众号消息下发
3. 提供关注公众号能力，用户可自行选择是否关注(裂变红包分享时无效)
4. 完成页媔可配置跳转链接可跳转商户的其他自定义Html5页面
5. 同一个用户在单个红包活动中只能领取1次红包

1. 申请红包接口权限：登录摇一摇周边商户後台 ,进入开发者支持，申请开通摇一摇红包组件接口;
2. 红包预下单：调用微信支付的api进行红包预下单告知需要发放的红包金额，人数生荿红包ticket；
3. 创建活动并录入红包信息：调用摇周边平台的api录入创建红包活动并录入信息，传入预下单时生成的红包ticket；
4. 调用jsapi抽红包：在摇出的頁面中通过调用jsapi抽红包抽中红包的用户可以拆红包；
5. 调用以上接口时，红包提供商户和红包发放商户公众号要求一致

设置单个红包的金额，类型等生成红包信息。预下单完成后需要在72小时内调用jsapi完成抽红包的操作。（红包过期失效后资金会退回到商户财付通帳号。）