小程序怎么发红包？api接口指南

小程序怎么发红包？#小程序开发#

分享一种方式供大家参考，使用第三方API红包代发接口。

官方要求：

按微信官方规则，要实现小程序给用户派发红包需要有一个具备相关权限的商户号，再按微信官方接口文档开发对接方可使用。

那么通常商户号具备以下三种接口权限任一一种便可实现小程序派发红包功能，1）小程序红包， 2）现金红包， 3）企业付款到零钱。以上三种接口权限开通条件一样，即时入账且结算周期为T+1的商户，需满足1）入驻满90天，2）连续正常交易30天，3）保持正常健康交易。

小程序红包是微信支付提供给商户在小程序场景下向用户发放红包的营销工具。但是目前小程序红包接口的使用场景有限，仅支持用户微信扫码打开小程序时进行红包领取，其他场景暂不支持。（支持场景值1011,1025,1047,1124）小程序红包接口倾向于为商户拓展线下营销赋能，使用的局限性较大。

鉴于微信官方相关接口权限准入门槛较高，所以针对有开发能力的用户，API代发红包接口可以满足用户的个性化开发需求。

API红包代发接口指聚合了微信现金红包和企业付款到零钱接口，符合政策法规要求的应用，开发者按接口文档即可对接使用，支持小程序、H5、APP等应用接入。

接口文档：

红包接口使用流程：

两种方式：

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

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

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

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

https://www.yaoyaola.net/exapi/hbticket

参数说明（GET）:
uid:	(必填)客户编号：10000010 (请使用此数字，每个账号唯一)
type:	(必填) 红包类型，0使用红包接口，1表示使用企业付款接口如果使用企业付款，金额可以大于200元企业付款的通知消息可自定义wishing，不显示title和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 = 10000010;
$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 = "https://www.yaoyaola.net/exapi/hbticket?uid=".$uid."&type=".$type."&orderid=".$orderid."&money=".$money."&
reqtick=".$reqtick."&expire=3600&sign=".$sign."&title=恭喜发财&sendname=千跃科技&wishing=心想事成";

$result = httpGet($url);
echo $result."\n";

请求示例：

https://www.yaoyaola.net/exapi/hbticket?uid=10000010&type=0&orderid=657812195242&money=100&reqtick=1515133732&sign=7ad5e4da870203ed6c15bda5a60d06a4&title=恭喜发财&sendname=千跃科技&wishing=心想事成

返回结果:

{"errcode":"0","errmsg":"success","ticket":"a06aba6515bbdb776f83fa74199bd3e9"}

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

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

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

 1. 在小程序后台设置服务域名为www.yaoyaola.net 2. 联系客服，将域名校验文件上传服务器 3. 将上面红包链接协议头http修改为https

3. 红包查询接口

https://www.yaoyaola.net/exapi/checkhb?uid=10000010&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(多红包)

https://www.yaoyaola.net/exapi/hbticket2

参数说明（GET）仅列出与hbticket不同的地方:
money:	红包总金额，单位为分，不能低于30
minmoney:	单个红包最小金额，单位为分，不能低于30
maxmoney:	单个红包最大金额，单位为分，不能低于30
hbcount:	红包个数
示例：	https://www.yaoyaola.net/exapi/hbticket2?uid=10000010&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，拼装出红包领取链接： https://www.yaoyaola.net/exapi/gethb2/10000010?orderid=992161232006 用户点击后，则立刻领取红包，每个用户只能在此orderid下领取一次，注意如果没有指定超时时间，此链接有效时间默认为60秒.

6.授权跳转接口

https://www.yaoyaola.net/exapi/check_user/10000010

参数说明(GET)：
url：	获取到openid后的跳转url，如果有带参数，可先对整个url做下urlencode编码
flag：	0表示静默获取openid，1表示需要用户授权获取详细信息
示例：	https://www.yaoyaola.net/exapi/check_user/10000010?url=https://www.yaoyaola.net/exapi/test.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.红包直发接口

https://www.yaoyaola.net/exapi/SendRedPackToOpenid

参数说明（GET）:
uid:	客户编号：10000010 (同上)
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:	红包祝福语

示例：	https://www.yaoyaola.net/exapi/SendRedPackToOpenid?uid=10000010&type=0&orderid=793174198142&money=50&reqtick=1547025439&openid=orsKq0c59kFgew2F2xfOWdRLQ-0M&sign=a8f2333cd13153702db9b7a9bafc5b2f&title=恭喜发财&sendname=千跃科技&wishing=心想事成
成功返回:	{"errcode":"0","errmsg":"","ticket":"f07bb87429ef4f33b9de...","retmoney":"50","retmsg":"发放成功"}
失败返回:	{"errcode":"100021","errmsg":"透传微信后台返回的错误信息"}

8.账户信息查询接口

https://www.yaoyaola.net/exapi/accountinfo

参数说明（GET）:
uid:	客户编号：10000010 (同上)
示例：	https://www.yaoyaola.net/exapi/accountinfo?uid=10000010
返回结果:	{"errcode":"0","balance":"10.00","apiexpire":"2019-06-23 18:05:25"}

9.错误码列表

编码	文字描述
0	成功
100001	客户编号uid未指定
100002	时间戳reqtick错误
100003	红包金额money必须大于30(0.3元)
100004	客户编号uid无效
100005	接口服务已过期
100006	接口已手动关闭
100007	未授权的对接IP地址
100008	未设置apikey
100009	MD5签名错误
100010	账户余额不足
100011	指定的orderid已存在
100012	红包总金额不满足最小红包金额
100013	参数不正确(uid为空或orderid,ticket不正确)
100014	根据指定ticket查不到红包记录
100015	根据指定orderid查不到红包记录
100016	openid未指定
100017	指定openid的红包发放请求太频繁
100018	此用户领取次数受限
100019	此用户领取金额受限
100020	系统错误,红包记录未生成
100021	透传微信后台返回的失败原因