本文主要是介绍小程序/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接口代发微信现金红包(附接口文档)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!