本文主要是介绍小程序/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〉红包创建接口(单红包)
https://www.yaoyaola.cn/exapi/hbticket
| 参数说明（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 = "https://www.yaoyaola.cn/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.cn/exapi/hbticket?uid=78&type=0&orderid=657812195242&money=100&reqtick=1515133732&sign=7ad5e4da870203ed6c15bda5a60d06a4&title=恭喜发财&sendname=佰睿科技&wishing=心想事成 |
| 返回结果: | {"errcode":"0","errmsg":"success","ticket":"a06aba6515bbdb776f83fa74199bd3e9"} |
2〉红包领取接口(单红包)
通过上面返回的ticket，拼装出红包领取链接： https://www.yaoyaola.cn/exapi/gethb/78?ticket=a06aba6515bbdb776f83fa74199bd3e9 ,用户点击后，则立刻领取红包，注意如果没有指定超时时间，此链接有效时间默认为60秒.
如果要在小程序中打开领取，需要做如下操作：
1、在小程序后台设置服务域名为www.yaoyaola.cn（如该域名不可用，请咨询【Wechat：dl-9413】获取可用域名）
2、咨询【Wechat：dl-9413】将域名校验文件上传服务器
3、将上面红包链接协议头http修改为https
3〉红包查询接口
https://www.yaoyaola.cn/exapi/checkhb?uid=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(多红包)
https://www.yaoyaola.cn/exapi/hbticket2
| 参数说明（GET）仅列出与hbticket不同的地方: | |
|---|---|
| money: | 红包总金额，单位为分，不能低于30 |
| minmoney: | 单个红包最小金额，单位为分，不能低于30 |
| maxmoney: | 单个红包最大金额，单位为分，不能低于30 |
| hbcount: | 红包个数 |
| 示例： | https://www.yaoyaola.cn/exapi/hbticket2?uid=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，拼装出红包领取链接： https://www.yaoyaola.cn/exapi/gethb2/78?orderid=992161232006 用户点击后，则立刻领取红包，每个用户只能在此orderid下领取一次，注意如果没有指定超时时间，此链接有效时间默认为60秒
6〉授权跳转接口
https://www.yaoyaola.cn/exapi/check_user/78
| 参数说明(GET)： | |
|---|---|
| url： | 获取到openid后的跳转url，如果有带参数，可先对整个url做下urlencode编码 |
| flag： | 0表示静默获取openid，1表示需要用户授权获取详细信息 |
| 示例： | https://www.yaoyaola.cn/exapi/check_user/78?url=https://www.yaoyaola.cn/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.cn/exapi/SendRedPackToOpenid
| 参数说明（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: | 红包祝福语 |
| 示例： | https://www.yaoyaola.cn/exapi/SendRedPackToOpenid?uid=78&type=0&orderid=793174198142&money=50&reqtick=1547025439&openid=orsKq0c59kFgew2F2xfOWdRLQ-0M&sign=a8f2333cd13153702db9b7a9bafc5b2f&title=恭喜发财&sendname=佰睿科技&wishing=心想事成 |
| 返回结果: | {"ticket":"f07bb87429ef4f33b9debff7b93ad5d4","retmoney":"50","retmsg":"发放成功"} |
8〉账户信息查询接口
https://www.yaoyaola.cn/exapi/accountinfo
| 参数说明（GET）: | |
|---|---|
| uid: | 客户编号：78 (同上) |
| 示例： | https://www.yaoyaola.cn/exapi/accountinfo?uid=78 |
| 返回结果: | {"errcode":"0","balance":"10.00","apiexpire":"2019-06-23 18:05:25"} |
这篇关于小程序/H5/APP应用api接口代发微信现金红包（附接口文档）的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
