红包接口使用流程:
首先由后台通过红包创建接口获取红包ticket,然后使用ticket拼装红包链接,在用户前端上打开领取,领取结果通过回传url显示配置:
apikey:参数签名**,不超过32字节
对接ip:调用红包创建接口的服务器IP,可写多个,用逗号分隔
1.红包创建接口
http://www.yaoyaola.cn/index.php/exapi/hbticket参数说明(GET):
uid: 客户编号:17508
type: 红包类型,0使用红包接口,1表示使用企业付款接口
如果使用企业付款,金额可以大于200元
企业付款的通知消息只能显示sendname,不能显示活动名称和祝福语
money: 红包金额,单位为分,不能低于100
orderid:自定义订单号
reqtick: 请求时间戳
sign:参数验证签名 md5(uid+type+orderid+money+reqtick+apikey)
title: 红包活动名称
sendname: 红包发送方名称
wishing: 红包祝福语
rurl: 结果回传url,客户自定义页面url,通过GET方式传送三个参数
ticket:红包回执
retmoney:红包领取金额,单位为分,0为领取失败
retmsg:返回信息
如果rurl为空,则跳转至系统默认结果页面cburl: 服务器通知url,参数形式同rurl, 用户红包领取成功时回调此url,失败则不回调,由客户方在红包超时(60秒)后主动查询确认结果。
示例:
http://www.yaoyaola.cn/index.php/exapi/hbticket?uid=17508&type=0&orderid=657812195242&money=100&reqtick=1515133732&sign=7ad5e4da870203ed6c15bda5a60d06a4&title=发财发财&sendname=佰睿&wishing=发发发
返回结果:
{"errcode":"0","errmsg":"success","ticket":"a06aba6515bbdb776f83fa74199bd3e9"}
2. 红包领取接口
通过上面返回的ticket,拼装出红包领取链接:http://www.yaoyaola.cn/index.php/exapi/gethb?uid=3&ticket=a06aba6515bbdb776f83fa74199bd3e9用户点击后,则立刻领取红包,注意此链接有效时间为60秒.
3. 红包查询接口
http://www.yaoyaola.cn/index.php/exapi/checkhb?uid=17508&ticket=a06aba6515bbdb776f83fa74199bd3e9返回结果:
{"errcode":"0","ticket":"红包回执","orderid":"用户订单号","mch_billno":"微信支付订单号","openid":"用户openid","money":"金额(分)","status":"状态(0未领取,1已领取,2已退回,其他异常)","hbtype":"红包类型","gotip":"领取红包的IP地址","gottime":"领取时间","fee":"平台扣费(分)","opmsg":"错误信息","recheck":"微信支付确认标志","rechecktime":"微信支付确认时间"}