小程序/H5/APP应用api接口代发微信现金红包（附接口文档）

接口代发微信现金红包（附接口文档）"/>

小程序/H5/APP应用api接口代发微信现金红包（附接口文档）

【接口同时支持现金红包接口及企业付款到零钱接口，支持单个发放金额：0.3元~1000元，常见场景：答题/问卷调查/积分兑换/游戏互动/拉新促活奖励等】

技术支持：Wechat&Tel - 186　7450　9508

红包接口使用流程：

两种方式：

第一种，首先由后台通过红包创建接口获取红包ticket，然后使用ticket拼装红包链接，在用户前端上打开领取，领取结果通过回传url显示

第二种，首先通过授权跳转链接获取用户openid，然后在服务器端调用红包直发接口发放红包

配置：
apikey：	参数签名密钥，不超过32字节
对接ip：	调用红包创建接口的服务器IP，可写多个，用逗号分隔
	以下配置在第二种方式是在调用授权跳转接口check_user时起作用
是否禁止桌面版微信：	默认为否，选是则桌面版微信不允许领取红包
是否拦截可疑来源：	默认关闭，如果开启，会根据IP地址和终端访问频次拦截疑似刷红包的行为来源。注意：此为辅助功能，并非100%准确
限定活动区域：	限定用户领取红包所处的区域，省份城市，多个可用逗号分隔。IP地址使用阿里云数据库，根据经验，城市误差较大，省份相对准确。注意：此为辅助功能，并非100%准确
限制在指定天数之内每个用户最大领取次数:	指定天数和指定最大领取次数都大于0时此配置生效。注意：此为辅助功能，客户应用的风控逻辑仍需根据需求自行设计。

 

 

 

 

 

 

 

 

 

 

1〉红包创建接口(单红包)

参数说明（GET）:
uid:	(必填)客户编号：78 (请使用此数字，每个账号唯一)
type:	(必填) 红包类型，0使用红包接口，1表示使用企业付款接口 如果使用企业付款，金额可以大于200元 企业付款的通知消息只能显示sendname，不能显示活动名称和祝福语
money:	(必填)红包金额，单位为分，不能低于30
orderid:	(必填)自定义订单号，不超过60字节
reqtick:	(必填)请求时间戳，单位为秒，与北京标准时间误差不能超过30秒
expire：	红包超时时间，单位为秒，不指定则默认60秒
sign:	(必填)参数验证签名 md5(uid+type+orderid+money+reqtick+apikey)，共32字节，字母都为小写
title:	红包活动名称(不能超过10个汉字或32个字符)
sendname:	红包发送方名称(不能超过10个汉字或32个字符)
wishing:	红包祝福语
rurl:	红包领取结果跳转url，用于给用户显示客户的自定义页面，通过GET方式传送三个参数(以下三行为平台传给rurl的参数),如果rurl为空，则跳转至系统默认结果页面
	ticket: 红包回执
	retmoney: 红包领取金额，单位为分，0为领取失败
	retmsg: 返回信息
cburl:	服务器通知url，参数形式同rurl,用户红包领取成功时回调此url，失败则不回调，由客户方在红包超时后主动查询确认结果。

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

PHP示例代码:	$apikey = "xxxxxxxxxxxxx"; $uid = 78; $type = 0; $money = 50; $orderid = rand(1000,9999).rand(1000,9999).rand(1000,9999); $reqtick = time(); $signstr = $uid.$type.$orderid.$money.$reqtick.$apikey; $sign = md5($signstr); $url = "=".$uid."&type=".$type."&orderid=".$orderid."&money=".$money."& reqtick=".$reqtick."&expire=3600&sign=".$sign."&title=恭喜发财&sendname=佰睿科技&wishing=心想事成"; $result = httpGet($url); echo $result."\n";
请求示例：	=78&type=0&orderid=657812195242&money=100&reqtick=1515133732&sign=7ad5e4da870203ed6c15bda5a60d06a4&title=恭喜发财&sendname=佰睿科技&wishing=心想事成
返回结果:	{"errcode":"0","errmsg":"success","ticket":"a06aba6515bbdb776f83fa74199bd3e9"}

2〉红包领取接口(单红包)

通过上面返回的ticket，拼装出红包领取链接： =a06aba6515bbdb776f83fa74199bd3e9 ,用户点击后，则立刻领取红包，注意如果没有指定超时时间，此链接有效时间默认为60秒.

如果要在小程序中打开领取，需要做如下操作：

1、在小程序后台设置服务域名为www.yaoyaola（如该域名不可用，请咨询【Wechat：dl-9413】获取可用域名） 

2、咨询【Wechat：dl-9413】将域名校验文件上传服务器

3、将上面红包链接协议头http修改为https

3〉红包查询接口

=78&orderid=xxxxxxxxxx&ticket=a06aba6515bbdb776f83fa74199bd3e9

参数说明：若orderid不为空，查询此订单号下所有记录，否则查询指定ticket对应的记录

返还结果：

                参数orderid不为空时返回：{"errcode":"0","orders":[{"ticket":"红包回执","orderid":"用户订单号","mch_billno":"微信支付订单号","openid":"用户openid","money":"金额（分）","status":"状态（0未领取，1已领取，2已退回，3已过期）","hbtype":"红包类型","gotip":"领取红包的IP地址","gottime":"领取时间","fee":"平台扣费（分）","opmsg":"错误信息","recheck":"微信支付确认标志","rechecktime":"微信支付确认时间"},{...}]}参数orderid为空，ticket不为空时返回：{"errcode":"0","ticket":"红包回执","orderid":"用户订单号","mch_billno":"微信支付订单号","openid":"用户openid","money":"金额（分）","status":"状态（0未领取，1已领取，2已退回，3已过期）","hbtype":"红包类型","gotip":"领取红包的IP地址","gottime":"领取时间","fee":"平台扣费（分）","opmsg":"错误信息","recheck":"微信支付确认标志","rechecktime":"微信支付确认时间"} 

4〉红包创建接口2(多红包)

参数说明（GET）仅列出与hbticket不同的地方:
money:	红包总金额，单位为分，不能低于30
minmoney:	单个红包最小金额，单位为分，不能低于30
maxmoney:	单个红包最大金额，单位为分，不能低于30
hbcount:	红包个数
示例：	=78&type=0&orderid=992161232006&money=500&minmoney=30&maxmoney=100&hbcount=10&reqtick=1546927322&expire=3600&sign=a4cf7a516f61391b94f57536e76a03df&title=恭喜发财&sendname=佰睿科技&wishing=心想事成

返回结果：

                {"errcode":"0","errmsg":"success","ticketlist":[{"ticket":"7836381fb74b95b1a8f510d737d6e6da","money":"30"},{"ticket":"2540daff7daa39ee1382c83273ce2618","money":"42"},{"ticket":"b3bda284bd94c10225c3b2323f14fd57","money":"64"},{"ticket":"553b8a269df69e017a651fef336e7a5a","money":"43"},{"ticket":"364085f52198df5ed6662b7b1e619c39","money":"37"},{"ticket":"53b6b97ee26819b5011d0e4f4829c539","money":"99"},{"ticket":"847f26e068437346b4e5b2bdd5117ad0","money":"35"},{"ticket":"d8a522b670665791f1b5e85b7dc7e073","money":"30"},{"ticket":"e1735bb134e3ccc5f105c061239acbba","money":"44"},{"ticket":"be317fb4f4900be1997c1e3367eb607e","money":"76"}],"balance":"40689"} 

5〉红包领取接口2(多红包)

通过上面创建的orderid，拼装出红包领取链接： =992161232006 用户点击后，则立刻领取红包，每个用户只能在此orderid下领取一次，注意如果没有指定超时时间，此链接有效时间默认为60秒

6〉授权跳转接口

参数说明(GET)：
url：	获取到openid后的跳转url，如果有带参数，可先对整个url做下urlencode编码
flag：	0表示静默获取openid，1表示需要用户授权获取详细信息
示例：	=.html&flag=0

跳转ulr示例：

test.html?ivtick=1547025023&u_openid=orsKq0c59kFgew2F2xfOWdRLQ-0M&encdata=3aae5867b37028491062d6f34e592772&userinfo=

跳转URL携带参数说明(GET)：
ivtick：	当前时间戳
u_openid：	获取到的用户openid
encdata：	签名验证信息，md5(apikey+openid+ivtick)
userinfo：	flag=1时返回的用户详细信息，base64编码

7〉红包直发接口

参数说明（GET）:
uid:	客户编号：78 (同上)
type:	红包类型，0使用红包接口，1表示使用企业付款接口 如果使用企业付款，金额可以大于200元 企业付款的通知消息只能显示sendname，不能显示活动名称和祝福语
money:	红包金额，单位为分，不能低于30
orderid：	自定义订单号
reqtick：	请求时间戳
openid：	用户openid，可通过上面check_user接口获取
sign：	参数验证签名 md5(uid+type+orderid+money+reqtick+openid+apikey)
title:	红包活动名称(不能超过10个汉字或32个字符)
sendname:	红包发送方名称(不能超过10个汉字或32个字符)
wishing:	红包祝福语

示例：	=78&type=0&orderid=793174198142&money=50&reqtick=1547025439&openid=orsKq0c59kFgew2F2xfOWdRLQ-0M&sign=a8f2333cd13153702db9b7a9bafc5b2f&title=恭喜发财&sendname=佰睿科技&wishing=心想事成
返回结果:	{"ticket":"f07bb87429ef4f33b9debff7b93ad5d4","retmoney":"50","retmsg":"发放成功"}

8〉账户信息查询接口

参数说明（GET）:
uid:	客户编号：78 (同上)
示例：	=78
返回结果:	{"errcode":"0","balance":"10.00","apiexpire":"2019-06-23 18:05:25"}