700字范文,内容丰富有趣,生活中的好帮手!
700字范文 > 【接口文档】微信支付现金红包未开通 公众号发红包用第三方红包代发接口

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

时间:2022-08-13 10:34:00

相关推荐

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

对接技术支持:

QQ:3314129409 Wechat/Tel:18674509508

红包接口使用流程:

首先由后台通过红包创建接口获取红包ticket,然后使用ticket拼装红包链接,在用户前端上打开领取,领取结果通过回传url显示

配置:

apikey:参数签名密钥,不超过32字节

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

一.红包创建接口

/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秒)后主动查询确认结果。

示例:

/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,拼装出红包领取链接:/index.php/exapi/gethb?uid=3&ticket=a06aba6515bbdb776f83fa74199bd3e9

用户点击后,则立刻领取红包,注意此链接有效时间为60秒.

三. 红包查询接口

/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是用户领取红包之后由平台推送结果的地址

本内容不代表本网观点和政治立场,如有侵犯你的权益请联系我们处理。
网友评论
网友评论仅供其表达个人看法,并不表明网站立场。