本文是【浅析微信支付】系列文章的第十三篇,主要讲解在如何开通商户平台的红包功能和为用户发放红包,以及查询发送红包记录。
浅析微信支付系列已经更新十三篇了哟~,没有看过的朋友们可以看一下哦。
浅析微信支付:(余额提现)企业付款到微信用户零钱或银行卡账户
浅析微信支付:支付验收示例和验收指引
浅析微信支付:如何使用沙箱环境测试
浅析微信支付:申请退款、退款回调接口、查询退款
上一篇文章我们说到,如果有余额提现
、返利福利
等需求时,就会用到商家向用户付款的操作,基于微信支付,上篇我们说了付款到用户余额和银行卡;本文来讲解如何使用现金红包的方式向用户发送现金红包
,首先我们来了解什么是微信的现金红包。
现金红包
现金红包,是微信支付商户平台提供的营销工具之一,上线以来深受广大商户与用户的喜爱。商户可以通过本平台向微信支付用户发放现金红包。用户领取红包后,资金到达用户微信支付零钱账户,和零钱包的其他资金有一样的使用出口;
注意:若用户未领取,资金将会在24小时后退回商户的微信支付账户中。
官方文档地址:
https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_1
现金红包意义
微信支付现金红包因资金的承载方式为现金,一直以来深受用户的青睐,近年来的春晚中,现金红包都扮演着重要的角色;在日常运营中也为商户的营销活动带来热烈的反响。总的来说,现金红包在包括但不仅限于以下场景中发挥着重要意义:
◆ 为企业拉取新用户、巩固老用户关系、提升用户活跃度
◆ 结合巧妙的创意点子,辅以红包点缀,打造火爆的活动,提升企业与品牌知名度
◆ 结合企业运营活动,以红包作为奖品,使你的抽奖、满送等营销活动更便利进行
◆ 同时,除了营销之外,现金红包在企业日常的运营中也扮演着重要角色。如:为员工返福利、为供应商返利、会员积分/虚拟等级兑现等等。
什么意思?
简单点讲,就是现金红包具有特殊的营销属性,拿公众号来讲,我们可以建立活动,通过活动的方式为用户发送现金红包,而这个红包触达的消息是在公众号聊天窗口页面,这样也可以引导用户关注公众号、提升活跃度等等。
开通现金红包
官方文档如下:
https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_3&index=2
在使用现金红包之前,请前往开通现金红包功能。
操作路径:【登录微信支付商户平台——>产品中心——>现金红包——>开通】。
可以根据官方的声明来开通现金红包,这里说几个重要的点:
- 入住时间超过90天;
- 连续交易正常交易时间30天;
一定要注意:上面这两点是必要条件,很多新注册的公司很容易就着了道,入住时间不够、交易时间更不够,没搞明白,活活等了三个月时间;如果有小伙伴遇到这样的情况,可以换一个满足要求的主体公司来解决,我的github代码中也兼容不同主体的服务号使用微信支付相关功能,小伙伴可以看看源码WXPayConstants
和WXPay
这两个类,调用接口时扩展WXPayConfigImpl
即可。
说明:在开通时请如实选择你的使用场景,且在红包的发放过程中如实上报你的场景,如有作假,微信支付将有权根据《微信支付商户平台使用协议》对你的商户号做出处理。
开发前的准备
具体的操作步骤这里就不描述了,小伙伴们可以查看官方文档:
https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_3&index=2
上面文档中已经有详细的描述,我在这里简单描述一下重点注意项:
- 下载API证书
- 充值,保证商户余额有足够的钱(一定要注意基本账户和运营账户的区别,一般情况下,有运营账户的时候,都会从运营账户中扣款)操作路径:【登录商户平台——>交易中心——>资金管理——>充值】
- 获取openid,指定用户发送红包必须先知道用户的标识openid,可以根据网页授权接口获得
- 设置红包参数,操作路径:【登录商户平台——>产品中心——>现金红包——>产品设置】
对于第四点,可以设置和更改以下参数官方解释如下:
- 调用IP地址:设置之后,仅有已设置的IP地址可以调用,其余的IP调用会报错;
- 用户领取上限:限制同一openid同一日领取的个数;
- 防刷等级:防刷是指微信风控针对微信小号、僵尸号、机器号等的拦截,你可以通过更改防刷等级控制防刷的强度;
- 同时,你也可以申请更改红包额度。但是需要经过微信支付的审核,审核通过之后才会生效;
敲黑板!!!重点来了,以上第一点IP地址,就是我们调用现金红包发放的服务器IP地址了;第二点也要注意,每个用户可以领取的红包个数限制;
最需要注意的是,调用接口时,发放红包使用场景一定要慎重选择,查看一下每种场景对应的限制,比如在红包金额大于200或者小于1元时必传场景参数,这时就需要我们配置阀值。
发放方式(接口发放)
方式一:接口发放
商户根据开发文档进行开发,一次调用可以给一个指定用户发送一个指定金额的红包,满足多元化的运营需求。
方式二:通过上传openid文件发放
收集要发送红包对象的openid,将openid编辑成txt文件,登录微信支付商户平台,使用上传文件功能发放。一份文件对应一个红包模板,便于管理。
方式三:配置营销规则“满额送”发放
商户可以在商户平台配置自助规则:用户使用微信支付发生交易满足一定条件,立送现金红包
本文主要讲通过接口发放的方式。
接口链接
https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack
是否需要证书
是
调用接口
官方文档地址:
https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_4&index=3
首先是发放规则:
- 发送频率限制------默认1800/min
- 发送个数上限------按照默认1800/min算
- 金额限制------默认红包金额为1-200元,如有需要,可前往商户平台进行设置和申请
- 其他其他限制吗?------单个用户可领取红包上线为10个/天,如有需要,可前往商户平台进行设置和申请
- 如果量上满足不了我们的需求,如何提高各个上限?------金额上限和用户当天领取次数上限可以在商户平台进行设置
注意1-红包金额大于200或者小于1元时,请求参数scene_id必传。
注意2-根据监管要求,新申请商户号使用现金红包需要满足两个条件:1、入驻时间超过90天 2、连续正常交易30天。
注意3-移动应用的appid无法使用红包接口。
PS:上面是官方介绍,不难理解,划重点!!!(注意3的含义,就是只能使用公众号的openid,小程序的openid不可用。)
消息触达规则参考官方文档:
下面开始来干货,贴出源码吧,应用代码:
/**
* 发送现金红包
*
* @author yclimb
* @date 2018/9/18
*/
private void sendRedPack() throws Exception {
WXPay wxPay = new WXPay(AsydWXPayConfigImpl.getInstance());
Map resultMap = wxPay.sendRedPack(WXPayUtil.getPayNo(), "obX_c0YRpT47zKcvq-ZYpjU6GFuA", "1", "活动名称", "红包祝福语", "备注", "127.0.0.1");
System.out.println("wxPay.sendRedPack:" + resultMap);
}
调用发送现金红包接口:
/**
* 作用:企业向指定微信用户的openid发放指定金额红包
* 场景:商户可以通过本平台向微信支付用户发放现金红包。用户领取红包后,资金到达用户微信支付零钱账户,和零钱包的其他资金有一样的使用出口;若用户未领取,资金将会在24小时后退回商户的微信支付账户中。
* 接口文档地址:https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_4&index=3
*
* @param mch_billno 商户订单号
* @param openid 用户openid
* @param amount 企业付款金额
* @param act_name 活动名称
* @param wishing 红包祝福语
* @param remark 备注
* @param spbill_create_ip 该IP可传用户端或者服务端的IP
* @return API返回数据
* @throws Exception e
*/
public Map sendRedPack(String mch_billno, String openid, String amount, String act_name, String wishing, String remark, String spbill_create_ip) throws Exception {
/** 构造请求参数数据 **/
Map data = new HashMap<>();
// 商户订单号 mch_billno 是 10000098201411111234567890 String(28) 商户订单号(每个订单号必须唯一。取值范围:0~9,a~z,A~Z)接口根据商户订单号支持重入,如出现超时可再调用。
data.put("mch_billno", mch_billno);
// 商户名称 send_name 是 天虹百货 String(32) 红包发送者名称
data.put("send_name", "悦店");
// 用户openid re_openid 是 oxTWIuGaIt6gTKsQRLau2M0yL16E String(32) 接受红包的用户openid openid为用户在wxappid下的唯一标识(获取openid参见微信公众平台开发者文档:网页授权获取用户基本信息)
data.put("re_openid", openid);
// 付款金额 total_amount 是 1000 int 付款金额,单位分
data.put("total_amount", String.valueOf(new BigDecimal(amount).multiply(new BigDecimal(100)).setScale(2, BigDecimal.ROUND_HALF_UP).intValue()));
// 红包发放总人数 total_num 是 1 int 红包发放总人数 total_num=1
data.put("total_num", "1");
// 红包祝福语 wishing 是 感谢您参加猜灯谜活动,祝您元宵节快乐! String(128) 红包祝福语
data.put("wishing", wishing);
// Ip地址 client_ip 是 192.168.0.1 String(15) 调用接口的机器Ip地址
data.put("client_ip", spbill_create_ip);
// 活动名称 act_name 是 猜灯谜抢红包活动 String(32) 活动名称
data.put("act_name", act_name);
// 备注 remark 是 猜越多得越多,快来抢! String(256) 备注信息
data.put("remark", remark);
/** 以下参数为非必填参数 **/
/*
* 场景id:scene_id 否 PRODUCT_8 String(32) 发放红包使用场景,红包金额大于200或者小于1元时必传
* PRODUCT_1:商品促销
* PRODUCT_2:抽奖
* PRODUCT_3:虚拟物品兑奖
* PRODUCT_4:企业内部福利
* PRODUCT_5:渠道分润
* PRODUCT_6:保险回馈
* PRODUCT_7:彩票派奖
* PRODUCT_8:税务刮奖
*/
//data.put("scene_id", "PRODUCT_1");
/*
* 活动信息 risk_info 否 posttime%3d123123412%26clientversion%3d234134%26mobile%3d122344545%26deviceid%3dIOS String(128)
* posttime:用户操作的时间戳
* mobile:业务系统账号的手机号,国家代码-手机号。不需要+号
* deviceid :mac 地址或者设备唯一标识
* clientversion :用户操作的客户端版本 把值为非空的信息用key=value进行拼接,再进行urlencode urlencode(posttime=xx& mobile =xx&deviceid=xx)
*/
// 资金授权商户号 consume_mch_id 否 1222000096 String(32) 资金授权商户号 服务商替特约商户发放时使用
/** 以下四个参数,在 this.redPackRequestData 方法中会自动赋值 **/
// 商户号 mch_id 是 10000098 String(32) 微信支付分配的商户号
// 随机字符串 nonce_str 是 5K8264ILTKCH16CQ2502SI8ZNMTM67VS String(32) 随机字符串,不长于32位
// 签名 sign 是 C380BEC2BFD727A4B6845133519F3AD6 String(32) 详见签名生成算法
// 公众账号appid wxappid 是 wx8888888888888888 String(32) 微信分配的公众账号ID(企业号corpid即为此appId)。在微信开放平台(open.weixin.qq.com)申请的移动应用appid无法使用该接口。
// 微信调用接口
Map resultMap = this.sendRedPack(data);
WXPayUtil.getLogger().info("wxPay.sendRedPack:" + resultMap);
return resultMap;
}
以上为接口调用代码,对于接口调用的入参和出参,小伙伴看看官网文档哦,接口中的注释给大家一个参考。
官方还提供了一种发放裂变红包
的接口,有需要的小伙伴可以了解一下,文档地址:
https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_5&index=4
裂变红包:一次可以发放一组红包。首先领取的用户为种子用户,种子用户领取一组红包当中的一个,并可以通过社交分享将剩下的红包给其他用户。裂变红包充分利用了人际传播的优势。
查询红包记录
用于商户对已发放的红包进行查询红包的具体信息,可支持普通红包和裂变包。
这个接口很简单,就是查询已经发送的红包记录,根据商户发放红包的商户订单号查询即可。
接口链接
https://api.mch.weixin.qq.com/mmpaymkttransfers/gethbinfo
是否需要证书
是
调用接口
应用代码:
/**
* 查询现金红包
*
* @author yclimb
* @date 2018/9/18
*/
private void getHbInfo() throws Exception {
WXPay wxPay = new WXPay(AsydWXPayConfigImpl.getInstance());
Map resultMap = wxPay.getHbInfo("1502348237482342342");
System.out.println("wxPay.getHbInfo:" + resultMap);
}
查询接口代码:
/**
* 作用:查询红包记录
* 场景:用于商户对已发放的红包进行查询红包的具体信息,可支持普通红包和裂变包。
* 接口文档地址:https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_6&index=5
*
* @param mch_billno 商户订单号
* @return API返回数据
* @throws Exception e
*/
public Map getHbInfo(String mch_billno) throws Exception {
/** 构造请求参数数据 **/
Map data = new HashMap<>();
// 商户订单号 mch_billno 是 10000098201411111234567890 String(28) 商户订单号(每个订单号必须唯一。取值范围:0~9,a~z,A~Z)接口根据商户订单号支持重入,如出现超时可再调用。
data.put("mch_billno", mch_billno);
// 订单类型 bill_type 是 MCHT String(32) MCHT:通过商户订单号获取红包信息。
data.put("bill_type", "MCHT");
/** 以下四个参数,在 this.fillRequestData 方法中会自动赋值 **/
// 商户号 mch_id 是 10000098 String(32) 微信支付分配的商户号
// 随机字符串 nonce_str 是 5K8264ILTKCH16CQ2502SI8ZNMTM67VS String(32) 随机字符串,不长于32位
// 签名 sign 是 C380BEC2BFD727A4B6845133519F3AD6 String(32) 详见签名生成算法
// 公众账号appid appid 是 wx8888888888888888 String(32) 微信分配的公众账号ID(企业号corpid即为此appId)。在微信开放平台(open.weixin.qq.com)申请的移动应用appid无法使用该接口。
// 微信调用接口
Map resultMap = this.getHbInfo(data);
WXPayUtil.getLogger().info("wxPay.getHbInfo:" + resultMap);
return resultMap;
}
此接口通过商户订单号获取红包信息,很简单,对于返回参数小伙伴们可以查看官方文档,注意一下错误代码即可。
结语
以上为商户平台开通现金红包、指定用户发放、红包记录查询
相关的解释和源码,小伙伴们一定要注意看看官方文档哦,具体的源码可以看作者的github,里面对每个方法有详细的注释。
如果小伙伴有遇到解决不了的问题,可以关注作者微信公众号,加入讨论群中发出疑问,和小伙伴们一起解决哦~
预告:下一篇文章会讲发放奖励的另一种方式 商户平台代金券或立减优惠开通、指定用户发放、查询等
,敬请期待!!!
如果想要提前一览源码的小伙伴,可以先看看我的 github,地址如下:
`
https://github.com/YClimb/wxp...
`
关注作者微信公众号,点击下方讨论群
,扫码即可加入微信支付讨论群
与小伙伴一起探讨哦~
到此本文就结束了,关注公众号查看更多推送!!!