最近接了个项目，其中有需求是要实现摇一摇红包功能，在网上搜了好久，都没有找到源码，没办法，只有自动写了，下面小编把我的劳动成果分享给大家供大家参考，本文写的不好，还请各位大侠提出宝贵意见，共同学习进步。
微信官方说明如下
功能说明
摇一摇周边红包接口是为线下商户提供的发红包功能。用户可以在商家门店等线下场所通过摇一摇周边领取商家发放的红包，在线上转发分享无效。
开发者可通过接口开发摇一摇红包功能，特点包括：
1.可选择使用模板加载页或自定义html5页面调起微信原生红包页面(详见创建红包活动中use_template字段，1为使用模板，2为使用自定义html5页面)
2.原生红包页面拆红包，无需通过公众号消息下发
3.提供关注公众号能力，用户可自行选择是否关注(裂变红包分享时无效)
4.完成页面可配置跳转链接，可跳转商户的其他自定义html5页面
5.同一个用户在单个红包活动中只能领取1次红包
用户侧交互流程
红包组件接口调用流程
1. 申请红包接口权限：登录摇一摇周边商户后台https://zb.weixin.qq.com,进入开发者支持，申请开通摇一摇红包组件接口;
2. 红包预下单：调用微信支付的api进行红包预下单，告知需要发放的红包金额，人数，生成红包ticket；
3. 创建活动并录入红包信息：调用摇周边平台的api录入创建红包活动并录入信息，传入预下单时生成的红包ticket；
4. 调用jsapi抽红包：在摇出的页面中通过调用jsapi抽红包，抽中红包的用户可以拆红包；
5. 调用以上接口时，红包提供商户和红包发放商户公众号要求一致。
说明：
红包提供商户：红包预下单接口传入的参数wxappid所代表的商户
红包发放商户：调用红包接口创建红包活动、录入红包信息、发放红包的商户公众号所以步骤应该是 ① 创建红包活动 ② 预下单 ③ 录入红包找出来了之前整理的类 在写一下1.创建活动
接口说明
创建红包活动，设置红包活动有效期，红包活动开关等基本信息，返回活动id
接口调用说明
服务器端调用
http请求方式: post
url: https://api.weixin.qq.com/shakearound/lottery/addlotteryinfo?access_token=accesstoken&use_template=1&logo_url=logo_url
请求参数说明
请求示例
?
|
1
2
3
4
5
6
7
8
9
10
11
12
|
content-type: application/json post body:
{
"title": "title",
"desc": "desc",
"onoff": 1,
"begin_time": 1428854400,
"expire_time": 1428940800,
"sponsor_appid": "wxxxxxxxxxxxxxx",
"total": 10,
"jump_url": jump_url,
"key": "keyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy"
}
|
返回数据说明
示例
?
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
{
"errcode":0,
"errmsg":"",
"lottery_id":"xxxxxxllllll",
"page_id":1,
}
/**
* 摇一摇红包 创建活动
* @author jiosen
*/
class addlotteryinfo_pub extends wxpay_client_pub
{
var $code;//code码，用以获取openid
var $openid;//用户的openid
function __construct($access_token,$logo)
{
//设置接口链接
$this->url = "https://api.weixin.qq.com/shakearound/lottery/addlotteryinfo?access_token=".$access_token."&use_template=1&logo_url=".$logo;
//设置curl超时时间
$this->curl_timeout = wxpayconf_pub::curl_timeout;
}
/**
* 生成接口参数 json
*/
function createjson()
{
try
{
//检测必填参数
if($this->parameters["title"] == null)
{
throw new sdkruntimeexception("缺少抽奖活动名称title！"."<br>");
}elseif ($this->parameters["desc"] == null ) {
throw new sdkruntimeexception("缺少抽奖活动描述desc！"."<br>");
}elseif ($this->parameters["begin_time"] == null) {
throw new sdkruntimeexception("缺少活动开始时间 begin_time！"."<br>");
}elseif ($this->parameters["expire_time"] == null) {
throw new sdkruntimeexception("缺少活动结束时间 expire_time！"."<br>");
}elseif ($this->parameters["total"] == null) {
throw new sdkruntimeexception("缺少红包总数total！"."<br>");
}elseif ($this->parameters["jump_url"] == null) {
throw new sdkruntimeexception("缺少红包关注跳转连接jump_url！"."<br>");
}elseif ($this->parameters["key"] == null) {
throw new sdkruntimeexception("缺少红包key！"."<br>");
}
$this->parameters["title"] = urlencode($this->parameters["title"]);
$this->parameters["desc"] = urlencode($this->parameters["desc"]);
$this->parameters["onoff"] = '1';//开启活动
$this->parameters["sponsor_appid"] = wxpayconf_pub::appid;//公众账号id
//var_dump($this->parameters);
//echo json_encode($this->parameters);
return json_encode($this->parameters);
}catch (sdkruntimeexception $e)
{
die($e->errormessage());
}
}
function hbpreorder()
{
$data = $this->createjson();
$result = $this->curl_post($this->url,urldecode($data));
$result = json_decode($result);
return $result;
}
function curl_post($url,$data)
{
$curl = curl_init($url);
curl_setopt($curl, curlopt_connecttimeout, 30);
curl_setopt($curl, curlopt_timeout, 10);
curl_setopt($curl, curlopt_returntransfer, true);
curl_setopt($curl, curlopt_ssl_verifypeer, false);
curl_setopt($curl, curlopt_post, 1);//发送一个常规的post请求
curl_setopt($curl, curlopt_postfields, $data);//post提交的数据包
$rv = curl_exec($curl);//输出内容
curl_close($curl);
return $rv;
}
/**
* 作用：生成可以获得code的url
*/
function createoauthurlforcode($redirecturl)
{
$urlobj["appid"] = wxpayconf_pub::appid;
$urlobj["redirect_uri"] = "$redirecturl";
$urlobj["response_type"] = "code";
$urlobj["scope"] = "snsapi_base";
$urlobj["state"] = "state"."#wechat_redirect";
$bizstring = $this->formatbizqueryparamap($urlobj, false);
return "https://open.weixin.qq.com/connect/oauth2/authorize?".$bizstring;
}
/**
* 作用：生成可以获得openid的url
*/
function createoauthurlforopenid()
{
$urlobj["appid"] = wxpayconf_pub::appid;
$urlobj["secret"] = wxpayconf_pub::appsecret;
$urlobj["code"] = $this->code;
$urlobj["grant_type"] = "authorization_code";
$bizstring = $this->formatbizqueryparamap($urlobj, false);
return "https://api.weixin.qq.com/sns/oauth2/access_token?".$bizstring;
}
/**
* 作用：通过curl向微信提交code，以获取openid
*/
function getopenid()
{
$url = $this->createoauthurlforopenid();
//初始化curl
$ch = curl_init();
//设置超时
curl_setopt($ch, curlop_timeout, $this->curl_timeout);
curl_setopt($ch, curlopt_url, $url);
curl_setopt($ch,curlopt_ssl_verifypeer,false);
curl_setopt($ch,curlopt_ssl_verifyhost,false);
curl_setopt($ch, curlopt_header, false);
curl_setopt($ch, curlopt_returntransfer, true);
//运行curl，结果以jason形式返回
$res = curl_exec($ch);
curl_close($ch);
$data = json_decode($res,true);
$this->openid = $data['openid'];
return $this->openid;
}
/**
* 作用：设置code
*/
function setcode($code_)
{
$this->code = $code_;
}
}
|
要注意提交的数据是json 不是xml
前端页面随便做一下
php 代码
?
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
$title = $_post['title'];
$file = $_files['img'];
$tools = new tools(); //这是一个文件上传类 随意选择一样你喜欢的上传方式
$logo_url = $tools->_upload_award("poll_img", $file, time());
$description = $_post['description'];
$total = $_post['total'];
$jump_url = $_post['jump_url'];
$token = getaccesstoken(); //这里是我封装的一个获取 token的 方法 做了时间限制 防止超出调用次数
$redpack = new addlotteryinfo_pub($token,site_url.$logo_url);
$time = time();
$end = time()+60*24*60*60;//两个月 这里的开始和结束时间我固定了
$key = $redpack->createnoncestr(); //key
$redpack->setparameter('title', $title);
//活动标题
$redpack->setparameter('desc', $description);
//活动描述
$redpack->setparameter('begin_time', $time);
//开始时间
$redpack->setparameter('expire_time', $end);
//结束时间
$redpack->setparameter('total', $total);
//红包总数
$redpack->setparameter('jump_url', $jump_url);
//key
$redpack->setparameter('key', $key);
$result = $redpack->hbpreorder();
$result = (array)$result;
if($result['errcode']==0){
$lottery_id = $result['lottery_id'];
$page_id = $result['page_id'];
//这里记得存一下数据库；
}else{
//echo '创建活动失败：'.$result['errmsg'];
//这里是错误提示
}
|
2.预下单
接口说明
设置单个红包的金额，类型等，生成红包信息。预下单完成后，需要在72小时内调用jsapi完成抽红包的操作。（红包过期失效后，资金会退回到商户财付通帐号。）
接口调用说明
服务器端调用
http请求方式: post
https://api.mch.weixin.qq.com/mmpaymkttransfers/hbpreorder
post数据格式：xml
需要商户证书
请求参数说明
请求示例
?
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
<xml>
<sign><![cdata[e1ee61a91c8e90f299de6ae075d60a2d]]></sign>
<mch_billno><![cdata[0010010404201411170000046545]]></mch_billno>
<mch_id><![cdata[10000097]]></mch_id>
<wxappid><![cdata[wxcbda96de0b165486]]></wxappid>
<send_name><![cdata[send_name]]></send_name>
<hb_type><![cdata[normal]]></hb_type>
<auth_mchid><![cdata[10000098]]></auth_mchid>
<auth_appid><![cdata[wx7777777]]></auth_appid>
<total_amount><![cdata[200]]></total_amount>
<amt_type><![cdata[all_rand]]></amt_type>
<total_num><![cdata[3]]></total_num>
<wishing><![cdata[恭喜发财 ]]></wishing>
<act_name><![cdata[ 新年红包 ]]></act_name>
<remark><![cdata[新年红包 ]]></remark>
<risk_cntl><![cdata[normal]]></risk_cntl>
<nonce_str><![cdata[50780e0cca98c8c8e814883e5caa672e]]></nonce_str>
</xml>
|
返回数据说明
以下字段在return_code 和result_code都为success的时候有返回
成功示例
?
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
<xml>
<return_code><![cdata[success]]></return_code>
<return_msg><![cdata[发放成功.]]></return_msg>
<result_code><![cdata[success]]></result_code>
<err_code><![cdata[0]]></err_code>
<err_code_des><![cdata[发放成功.]]></err_code_des>
<mch_billno><![cdata[0010010404201411170000046545]]></mch_billno>
<mch_id>10010404</mch_id>
<wxappid><![cdata[wx6fa7e3bab7e15415]]></wxappid>
<sp_ticket><![cdata[0cca98c8c8e814883]]></sp_ticket>
<total_amount>3</total_amount>
<detail_id><![cdata[001001040420141117000004888]]></detail_id>
<send_time><![cdata[20150101080000]]></send_time>
</xml>
|
失败示例
?
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
<xml>
<return_code><![cdata[fail]]></return_code>
<return_msg><![cdata[系统繁忙,请稍后再试.]]></return_msg>
<result_code><![cdata[fail]]></result_code>
<err_code><![cdata[268458547]]></err_code>
<err_code_des><![cdata[系统繁忙,请稍后再试.]]></err_code_des>
<mch_billno><![cdata[0010010404201411170000046542]]></mch_billno>
<mch_id>10010404</mch_id>
<wxappid><![cdata[wx6fa7e3bab7e15415]]></wxappid>
<total_amount>3</total_amount>
</xml>
/**
* 摇一摇红包预下单
* @author jiosen
*/
class yhb_pub extends wxpay_client_pub
{
var $code;//code码，用以获取openid
var $openid;//用户的openid
function __construct()
{
//设置接口链接
$this->url = "https://api.mch.weixin.qq.com/mmpaymkttransfers/hbpreorder";
//设置curl超时时间
$this->curl_timeout = wxpayconf_pub::curl_timeout;
}
/**
* 生成接口参数xml
*/
function createxml()
{
try
{
//检测必填参数
if($this->parameters["mch_billno"] == null)
{
throw new sdkruntimeexception("缺少发红包接口必填参数mch_billno！"."<br>");
}elseif ($this->parameters["send_name"] == null ) {
throw new sdkruntimeexception("缺少发红包接口必填参数send_name！"."<br>");
}elseif ($this->parameters["total_amount"] == null) {
throw new sdkruntimeexception("缺少发红包接口必填参数total_amount！"."<br>");
}elseif ($this->parameters["total_num"] == null) {
throw new sdkruntimeexception("缺少发红包接口必填参数total_num！"."<br>");
}elseif ($this->parameters["wishing"] == null) {
throw new sdkruntimeexception("缺少发红包接口必填参数wishing！"."<br>");
}elseif ($this->parameters["act_name"] == null) {
throw new sdkruntimeexception("缺少发红包接口必填参数act_name！"."<br>");
}elseif ($this->parameters["remark"] == null) {
throw new sdkruntimeexception("缺少发红包接口必填参数remark！"."<br>");
}
$this->parameters["wxappid"] = wxpayconf_pub::appid;//公众账号id
$this->parameters["mch_id"] = wxpayconf_pub::mchid;//商户号
$this->parameters["nonce_str"] = $this->createnoncestr();//随机字符串
//$this->parameters["re_openid"] = $this->openid;//用户openid
$this->parameters["hb_type"] = 'normal';//红包类型 normal-普通红包；group-裂变红包(可分享红包给好友，无关注公众号能力)。
$this->parameters["auth_mchid"] = '1000052601';//摇周边商户号
$this->parameters["auth_appid"] = 'wxbf42bd79c4391863';//摇周边 appid
$this->parameters["risk_cntl"] = 'normal';//风控设置
$this->parameters["sign"] = $this->getsign($this->parameters);//签名
return $this->arraytoxml($this->parameters);
}catch (sdkruntimeexception $e)
{
die($e->errormessage());
}
}
function hbpreorder()
{
$this->postxmlssl();
$this->result = $this->xmltoarray($this->response);
return $this->result;
}
/**
* 作用：生成可以获得code的url
*/
function createoauthurlforcode($redirecturl)
{
$urlobj["appid"] = wxpayconf_pub::appid;
$urlobj["redirect_uri"] = "$redirecturl";
$urlobj["response_type"] = "code";
$urlobj["scope"] = "snsapi_base";
$urlobj["state"] = "state"."#wechat_redirect";
$bizstring = $this->formatbizqueryparamap($urlobj, false);
return "https://open.weixin.qq.com/connect/oauth2/authorize?".$bizstring;
}
/**
* 作用：生成可以获得openid的url
*/
function createoauthurlforopenid()
{
$urlobj["appid"] = wxpayconf_pub::appid;
$urlobj["secret"] = wxpayconf_pub::appsecret;
$urlobj["code"] = $this->code;
$urlobj["grant_type"] = "authorization_code";
$bizstring = $this->formatbizqueryparamap($urlobj, false);
return "https://api.weixin.qq.com/sns/oauth2/access_token?".$bizstring;
}
/**
* 作用：通过curl向微信提交code，以获取openid
*/
function getopenid()
{
$url = $this->createoauthurlforopenid();
//初始化curl
$ch = curl_init();
//设置超时
curl_setopt($ch, curlop_timeout, $this->curl_timeout);
curl_setopt($ch, curlopt_url, $url);
curl_setopt($ch,curlopt_ssl_verifypeer,false);
curl_setopt($ch,curlopt_ssl_verifyhost,false);
curl_setopt($ch, curlopt_header, false);
curl_setopt($ch, curlopt_returntransfer, true);
//运行curl，结果以jason形式返回
$res = curl_exec($ch);
curl_close($ch);
//取出openid
$data = json_decode($res,true);
$this->openid = $data['openid'];
return $this->openid;
}
/**
* 作用：设置code
*/
function setcode($code_)
{
$this->code = $code_;
}
}
|
这里需要注意的是 auth_mchid 和 auth_appid 要填摇周边平台给出的appid 和商户号
调用 （这里不贴前端页面了）
?
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
$redpack = new \\yhb_pub();
$redpack->setparameter('mch_billno', wxpayconf_pub::mchid.date('ymdhis').rand(1000, 9999));
//商户名称
$redpack->setparameter('send_name', "商户名称");
//付款金额
$redpack->setparameter('total_amount', 100); //单位分
//红包发放总人数
$redpack->setparameter('amt_type', "all_rand");
$redpack->setparameter('total_num', 1);
//红包祝福语
$redpack->setparameter('wishing', "摇一摇送红包");
//活动名称
$redpack->setparameter('act_name', "摇一摇送红包");
//备注
$redpack->setparameter('remark', "摇一摇送红包 备注");
$result = $redpack->hbpreorder();
if($result[''])
|
3.录入红包
接口说明
在调用"创建红包活动"接口之后，调用此接口录入红包信息。注意，此接口每次调用，都会向某个活动新增一批红包信息，如果红包数少于100 个，请通过一次调用添加所有红包信息。如果红包数大于100，可以多次调用接口添加。请注意确保多次录入的红包ticket总的数目不大于创建该红包活动 时设置的total值。
接口调用说明
服务器端调用
http请求方式: post
url:https://api.weixin.qq.com/shakearound/lottery/setprizebucket?access_token=accesstoken
请求参数说明
post body：json格式的结构体
请求示例
?
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
content-type: application/json post body:
{
"lottery_id": "xxxxxxllllll",
"mchid": "10000098",
"sponsor_appid": "wx8888888888888888",
"prize_info_list": [
{
"ticket": "v1|zips2l0hpmbp3uwgi1rwp45vodz/v/zq/00jp9mewt+e47/q1fjjwcip34frsjzoxaezj7k2ctag1pmcshvkchbwqbthxpm6mbuzceohtj79ihuhaen0wao+j4sxnxnbgswfoldywg1ngvrryncy3g=="
},
{
"ticket": "v1|fohnutap1oepsm5ap0hx1gmatm\\/qx\\/xn3szwl7k+5z10sbv5\\/mz4swxwxbk2spv32elrvjd4ww1g3h5a+ypqrrysi+4oo97y63koeqbrcpjbkyqby8ayvyvd40v2b9sltqcm2iggy98mpe+vxziayq=="
}
]
}
|
返回数据说明
示例