小程序/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"}

 

  • 0
    点赞
  • 1
    评论
  • 0
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

相关推荐
©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值