浅析微信支付：商户平台开通现金红包、指定用户发放、红包记录查询

本文是【浅析微信支付】系列文章的第十三篇，主要讲解在如何开通商户平台的红包功能和为用户发放红包，以及查询发送红包记录。


浅析微信支付系列已经更新十三篇了哟～，没有看过的朋友们可以看一下哦。

浅析微信支付：(余额提现)企业付款到微信用户零钱或银行卡账户

浅析微信支付：支付验收示例和验收指引

浅析微信支付：如何使用沙箱环境测试

浅析微信支付：申请退款、退款回调接口、查询退款

上一篇文章我们说到，如果有余额提现、返利福利等需求时，就会用到商家向用户付款的操作，基于微信支付，上篇我们说了付款到用户余额和银行卡；本文来讲解如何使用现金红包的方式向用户发送现金红包，首先我们来了解什么是微信的现金红包。

现金红包

现金红包，是微信支付商户平台提供的营销工具之一，上线以来深受广大商户与用户的喜爱。商户可以通过本平台向微信支付用户发放现金红包。用户领取红包后，资金到达用户微信支付零钱账户，和零钱包的其他资金有一样的使用出口；

注意：若用户未领取，资金将会在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

在使用现金红包之前，请前往开通现金红包功能。

操作路径：【登录微信支付商户平台——>产品中心——>现金红包——>开通】。

可以根据官方的声明来开通现金红包，这里说几个重要的点：

  1. 入住时间超过90天；
  2. 连续交易正常交易时间30天；

一定要注意：上面这两点是必要条件，很多新注册的公司很容易就着了道，入住时间不够、交易时间更不够，没搞明白，活活等了三个月时间；如果有小伙伴遇到这样的情况，可以换一个满足要求的主体公司来解决，我的github代码中也兼容不同主体的服务号使用微信支付相关功能，小伙伴可以看看源码WXPayConstants和WXPay这两个类，调用接口时扩展WXPayConfigImpl即可。

说明：在开通时请如实选择你的使用场景，且在红包的发放过程中如实上报你的场景，如有作假，微信支付将有权根据《微信支付商户平台使用协议》对你的商户号做出处理。

开发前的准备

具体的操作步骤这里就不描述了，小伙伴们可以查看官方文档：

https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_3&index=2

上面文档中已经有详细的描述，我在这里简单描述一下重点注意项：

  1. 下载API证书
  2. 充值，保证商户余额有足够的钱（一定要注意基本账户和运营账户的区别，一般情况下，有运营账户的时候，都会从运营账户中扣款）操作路径：【登录商户平台——>交易中心——>资金管理——>充值】
  3. 获取openid，指定用户发送红包必须先知道用户的标识openid，可以根据网页授权接口获得
  4. 设置红包参数，操作路径：【登录商户平台——>产品中心——>现金红包——>产品设置】

对于第四点，可以设置和更改以下参数官方解释如下：

  1. 调用IP地址：设置之后，仅有已设置的IP地址可以调用，其余的IP调用会报错；
  2. 用户领取上限：限制同一openid同一日领取的个数；
  3. 防刷等级：防刷是指微信风控针对微信小号、僵尸号、机器号等的拦截，你可以通过更改防刷等级控制防刷的强度；
  4. 同时，你也可以申请更改红包额度。但是需要经过微信支付的审核，审核通过之后才会生效；

敲黑板！！！重点来了，以上第一点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

首先是发放规则：

  1. 发送频率限制------默认1800/min
  2. 发送个数上限------按照默认1800/min算
  3. 金额限制------默认红包金额为1-200元，如有需要，可前往商户平台进行设置和申请
  4. 其他其他限制吗？------单个用户可领取红包上线为10个/天，如有需要，可前往商户平台进行设置和申请
  5. 如果量上满足不了我们的需求，如何提高各个上限？------金额上限和用户当天领取次数上限可以在商户平台进行设置

注意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<String, String> resultMap = wxPay.sendRedPack(WXPayUtil.getPayNo(), "obX_c0YRpT47zKcvq-ZYpjU6GFuA", "1", "活动名称", "红包祝福语", "备注", "127.0.0.1");
    System.out.println("wxPay.sendRedPack:" + resultMap);
}

调用发送现金红包接口：

/**
 * 作用：企业向指定微信用户的openid发放指定金额红包<br>
 * 场景：商户可以通过本平台向微信支付用户发放现金红包。用户领取红包后，资金到达用户微信支付零钱账户，和零钱包的其他资金有一样的使用出口；若用户未领取，资金将会在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<String, String> sendRedPack(String mch_billno, String openid, String amount, String act_name, String wishing, String remark, String spbill_create_ip) throws Exception {

    /** 构造请求参数数据 **/
    Map<String, String> 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<String, String> 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<String, String> resultMap = wxPay.getHbInfo("1502348237482342342");
    System.out.println("wxPay.getHbInfo:" + resultMap);
}

查询接口代码：

/**
 * 作用：查询红包记录<br>
 * 场景：用于商户对已发放的红包进行查询红包的具体信息，可支持普通红包和裂变包。
 * 接口文档地址：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<String, String> getHbInfo(String mch_billno) throws Exception {

    /** 构造请求参数数据 **/
    Map<String, String> 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<String, String> resultMap = this.getHbInfo(data);

    WXPayUtil.getLogger().info("wxPay.getHbInfo:" + resultMap);

    return resultMap;
}

此接口通过商户订单号获取红包信息，很简单，对于返回参数小伙伴们可以查看官方文档，注意一下错误代码即可。

结语

以上为商户平台开通现金红包、指定用户发放、红包记录查询相关的解释和源码，小伙伴们一定要注意看看官方文档哦，具体的源码可以看作者的github，里面对每个方法有详细的注释。

如果小伙伴有遇到解决不了的问题，可以关注作者微信公众号，加入讨论群中发出疑问，和小伙伴们一起解决哦～

预告：下一篇文章会讲发放奖励的另一种方式 商户平台代金券或立减优惠开通、指定用户发放、查询等，敬请期待！！！

?如果想要提前一览源码的小伙伴，可以先看看我的 github，地址如下：

?

??https://github.com/YClimb/wxpay-sdk/blob/master/README.md ?

关注作者微信公众号，点击下方讨论群，扫码即可加入微信支付讨论群与小伙伴一起探讨哦～

到此本文就结束了，关注公众号查看更多推送！！！



浅析微信支付：商户平台开通现金红包、指定用户发放、红包记录查询

原文地址：https://www.cnblogs.com/yclimb/p/9970832.html

时间： 2024-11-08 03:44:39

浅析微信支付：商户平台开通现金红包、指定用户发放、红包记录查询的相关文章

微信公众号红包接口开发PHP开发 CA证书出错，请登陆微信支付商户平台下载证书

微信红包接口调试过程中一直提示“CA证书出错,请登陆微信支付商户平台下载证书”,经反复调试,大致解决方法如下: 1.首先确保CA证书的路径是否正确,一定得是绝对路径,因为是PHP开发的,这里需要三个pem证书 2.确保服务器支持,新浪云的sae,经测试支持不是很好,一直报错,换用其他服务器后,一次通过 POST红包证书的代码部分如下: function post( $strXml) { $url='https://api.mch.weixin.qq.com/mmpaymkttransfers/s

解决问题：CA_ERROR证书出错，请登录微信支付商户平台下载证书-企业付款到零钱接口（原创）

这几天用到了微信企业付款到零钱这个接口,结果出现了报错:CA_ERROR, 该接口的API说明和报错提示说明:https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_2 通过看提示知道原因大概在:请求没带商户API证书或带了错误的商户API证书. 然后我自己查看了我发post请求的地方,汗,果不其然,有个控制是否携带API证书的地方我设置了不携带false. 修改为ture,然后检查下证书路径,测试OK. 原文地址:

浅析微信支付：商户平台代金券或立减优惠开通、指定用户代金券发放、查询等

本文是[浅析微信支付]系列文章的第十四篇,主要讲解在如何开通商户平台的代金券或立减优惠功能,商家向指定用户发送代金券,查询发送记录,代金券信息等. 浅析微信支付系列已经更新十四篇了哟-,没有看过的朋友们可以看一下哦. 浅析微信支付:商户平台开通现金红包.指定用户发放.红包记录查询 浅析微信支付:(余额提现)企业付款到微信用户零钱或银行卡账户 浅析微信支付:支付验收示例和验收指引 浅析微信支付:如何使用沙箱环境测试 首先我们需要了解一下什么是代金券和立减优惠? 代金券是微信支付为商家提供的一个营销

浅析微信支付：(余额提现)企业付款到微信用户零钱或银行卡账户

本文是[浅析微信支付]系列文章的第十二篇,主要讲解在商户存在的提现.商户付款到微信用户零钱或者银行卡需求. 浅析微信支付系列已经更新十二篇了哟-,没有看过的朋友们可以看一下哦. 浅析微信支付:支付验收示例和验收指引 浅析微信支付:如何使用沙箱环境测试 浅析微信支付:下载对账单和资金账单 浅析微信支付:申请退款.退款回调接口.查询退款 如果你是做电商或者某些有福利返利的系统,基本上会遇到诸如 余额提现 这类需求,主要就是平台向用户返利现金,积累到某一个门槛,可以领取到自己的余额账号.银行卡:或者是

浅析微信支付：申请退款、退款回调接口、查询退款

本文是[浅析微信支付]系列文章的第八篇,主要讲解商户如何处理微信申请退款.退款回调.查询退款接口,其中有一些坑的地方,会着重强调. 浅析微信支付系列已经更新七篇了哟-,没有看过的朋友们可以看一下哦. 浅析微信支付:查询订单和关闭订单 浅析微信支付:支付结果通知 浅析微信支付:统一下单接口 在实际场景中,申请退款和退款回调接口是比较常用到的微信支付接口,这里我们会讲原路返回方式的退款,还有的是使用直接为用户付款到零钱.现金红包等方式来退款,此种情况主要会出现在客服退款时,不是全部退款的情况,也有的

微信支付教程系列之现金红包

目录 (一)微信公众号开发之VS远程调试 (二)微信公众号开发之基础梳理 (三)微信公众号开发之自动消息回复和自定义菜单 (四)微信公众号开发之网页授权获取用户基本信息 (五)微信公众号开发之网页中及时获取当前用户Openid及注意事项 (六)微信公众号开发之扫码支付 (七)微信公众号开发之公众号支付 (八)微信公众号开发之现金红包 微信支付教程系列之现金红包 最近最弄这个微信支付的功能,然后扫码.公众号支付,这些都做了,闲着无聊,就看了看微信支付的其他功能,发现还有一个叫“现金红包”的玩意,想

微信支付商户申请接入信息汇总【接入教程】

微信支付(商户功能)功能介绍 微信支付(商户功能),是公众平台向有出售物品需求的公众号提供推广销售.支付收款.经营分析的整套解决方案. 商户通过自定义菜单.关键字回复等方式向订阅用户推送商品消息,用户可在微信公众号中完成选购支付的流程.商户也可以把商品网页生成二维码,张贴在线下的场景,如车站和广告海报.用户扫描后可打开商品详情,在微信中直接购买. 场景及类型介绍 商家可以申请公众账号支付和APP(应用客户端)支付两种接入微信支付方式. 公众账号支付:用户在微信公众帐号内使用微信支付消费,案例:易

微信支付商户系统架构背后的故事

版权声明:本文由李跃森原创文章,转载请注明出处: 文章原文链接:https://www.qcloud.com/community/article/142 来源:腾云阁 https://www.qcloud.com/community 李跃森,腾讯云PostgreSQL首席架构师,腾讯数据库团队架构师,负责微信支付商户系统核心数据库的架构设计和研发,PostgreSQL-x2社区核心成员,获多项国家发明专利.从事PG内核开发和架构设计超过10年. 2015年之前,微信支付业务快速发展,需要一款数据

浅析微信支付：如何使用沙箱环境测试

本文是[浅析微信支付]系列文章的第十篇,主要讲解如何使用沙箱环境来测试微信支付. 浅析微信支付系列已经更新十篇了哟-,没有看过的朋友们可以看一下. 浅析微信支付:下载对账单和资金账单 浅析微信支付:申请退款.退款回调接口.查询退款 浅析微信支付:查询订单和关闭订单 浅析微信支付:支付结果通知 在实际开发中,通常我们都是在开发环境中开发,本地环境也有很多限制,比如:微信支付无法调起.H5链接需要鉴权.支付结果通知需要外网等. 面对以上的问题,微信官方给出了解决的方法,就是咋们这篇文章的 沙箱环境,