【接口文档】微信支付现金红包未开通，公众号发红包用第三方红包代发接口

对接技术支持：

QQ：3314129409   Wechat/Tel：18674509508

红包接口使用流程：

首先由后台通过红包创建接口获取红包ticket，然后使用ticket拼装红包链接，在用户前端上打开领取，领取结果通过回传url显示
配置：
apikey：参数签名密钥，不超过32字节

对接ip：调用红包创建接口的服务器IP，可写多个，用逗号分隔

 

一.红包创建接口

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"} 

二. 红包领取接口

通过上面返回的ticket，拼装出红包领取链接：http://www.yaoyaola.cn/index.php/exapi/gethb?uid=3&ticket=a06aba6515bbdb776f83fa74199bd3e9
用户点击后，则立刻领取红包，注意此链接有效时间为60秒.

三. 红包查询接口

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":"微信支付确认时间"} 

 

四. 常见疑问解答

1. UID是什么

就是在平台上注册的账号对应的id，在网页上打开“对接指南”里面显示的数字就是自己的uid

2. {"errcode":"403","errmsg":"api expired"}

API过期，没有购买服务或服务已过期，或检查发起请求的url里面填写的uid是否正确

3. {"errcode":"403","errmsg":"Unauth ip address"}

未授权的对接ip地址，请先登录平台点击“对接配置”配置对接服务器的ip地址

4. {"errcode":"403","errmsg":"sign error"}

签名错误，先检查md5后的字符串是小写的，再看做md5前拼的字符串是否正确，仔细看对接指南里的说明

5. {"errcode":"403","errmsg":"timestamp error"}

时间戳错误，提交请求的时间戳跟服务器时间误差不能超过30秒，时间戳单位是秒

6. 红包链接有效时间默认是60秒，能修改吗

可以修改，把需要修改的时间告诉我们操作

7.  rurl和cburl有什么区别

rurl是用户领取红包之后前端跳转的页面地址
cburl是用户领取红包之后由平台推送结果的地址