小程序/H5/APP应用api接口代发微信现金红包(附接口文档)

2023-11-24 23:40

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



http://www.chinasem.cn/article/422748

相关文章

python获取指定名字的程序的文件路径的两种方法

《python获取指定名字的程序的文件路径的两种方法》本文主要介绍了python获取指定名字的程序的文件路径的两种方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要... 最近在做项目,需要用到给定一个程序名字就可以自动获取到这个程序在Windows系统下的绝对路径,以下

C#实现一键批量合并PDF文档

《C#实现一键批量合并PDF文档》这篇文章主要为大家详细介绍了如何使用C#实现一键批量合并PDF文档功能,文中的示例代码简洁易懂,感兴趣的小伙伴可以跟随小编一起学习一下... 目录前言效果展示功能实现1、添加文件2、文件分组(书签)3、定义页码范围4、自定义显示5、定义页面尺寸6、PDF批量合并7、其他方法

PHP应用中处理限流和API节流的最佳实践

《PHP应用中处理限流和API节流的最佳实践》限流和API节流对于确保Web应用程序的可靠性、安全性和可扩展性至关重要,本文将详细介绍PHP应用中处理限流和API节流的最佳实践,下面就来和小编一起学习... 目录限流的重要性在 php 中实施限流的最佳实践使用集中式存储进行状态管理(如 Redis)采用滑动

SpringBoot实现不同接口指定上传文件大小的具体步骤

《SpringBoot实现不同接口指定上传文件大小的具体步骤》:本文主要介绍在SpringBoot中通过自定义注解、AOP拦截和配置文件实现不同接口上传文件大小限制的方法,强调需设置全局阈值远大于... 目录一  springboot实现不同接口指定文件大小1.1 思路说明1.2 工程启动说明二 具体实施2

Java实现在Word文档中添加文本水印和图片水印的操作指南

《Java实现在Word文档中添加文本水印和图片水印的操作指南》在当今数字时代,文档的自动化处理与安全防护变得尤为重要,无论是为了保护版权、推广品牌,还是为了在文档中加入特定的标识,为Word文档添加... 目录引言Spire.Doc for Java:高效Word文档处理的利器代码实战:使用Java为Wo

使用Python实现Word文档的自动化对比方案

《使用Python实现Word文档的自动化对比方案》我们经常需要比较两个Word文档的版本差异,无论是合同修订、论文修改还是代码文档更新,人工比对不仅效率低下,还容易遗漏关键改动,下面通过一个实际案例... 目录引言一、使用python-docx库解析文档结构二、使用difflib进行差异比对三、高级对比方

深入浅出Spring中的@Autowired自动注入的工作原理及实践应用

《深入浅出Spring中的@Autowired自动注入的工作原理及实践应用》在Spring框架的学习旅程中,@Autowired无疑是一个高频出现却又让初学者头疼的注解,它看似简单,却蕴含着Sprin... 目录深入浅出Spring中的@Autowired:自动注入的奥秘什么是依赖注入?@Autowired

Python自动化处理PDF文档的操作完整指南

《Python自动化处理PDF文档的操作完整指南》在办公自动化中,PDF文档处理是一项常见需求,本文将介绍如何使用Python实现PDF文档的自动化处理,感兴趣的小伙伴可以跟随小编一起学习一下... 目录使用pymupdf读写PDF文件基本概念安装pymupdf提取文本内容提取图像添加水印使用pdfplum

Python从Word文档中提取图片并生成PPT的操作代码

《Python从Word文档中提取图片并生成PPT的操作代码》在日常办公场景中,我们经常需要从Word文档中提取图片,并将这些图片整理到PowerPoint幻灯片中,手动完成这一任务既耗时又容易出错,... 目录引言背景与需求解决方案概述代码解析代码核心逻辑说明总结引言在日常办公场景中,我们经常需要从 W

PostgreSQL简介及实战应用

《PostgreSQL简介及实战应用》PostgreSQL是一种功能强大的开源关系型数据库管理系统,以其稳定性、高性能、扩展性和复杂查询能力在众多项目中得到广泛应用,本文将从基础概念讲起,逐步深入到高... 目录前言1. PostgreSQL基础1.1 PostgreSQL简介1.2 基础语法1.3 数据库