浅析微信支付：开通社交立减金活动、建立立减金及领取使用的相关文档和源码

时间  2019-11-08
标签 浅析 微信 支付 开通 社交 活动 建立 领取 使用 相关 文档 源码 栏目 快乐工作 繁體版
原文   原文链接

本文是【浅析微信支付】系列文章的第十七篇，主要讲解在在微信平台中，如何建立优惠券，开通社交立减金，并为用户配置发送立减金。java

上篇文章已经为你们讲解了如何在微信公众平台建立优惠券并为用户发券，这片文章是优惠券的一个进阶，讲解微信平台上的社交立减金用法，但愿能够帮助到你们。git

应用场景

小程序社交立减金是一款帮助商家快速生成具有裂变传播属性的小程序经营工具，用户经过支付、扫码等场景能够参与社交立减金活动，将社交立减金礼包分享至朋友后本身可获取一份，朋友在会话中可随机获取社交立减金，并直达商家小程序使用。github

产品优点json

  1. 打通“小程序+支付+优惠”，支付成功页分发社交立减金，支付时抵扣使用；
  2. 经过聊天分享和裂变，触达更多潜在用户，下降拉新成本；
  3. 根据用户标签属性，可配置分发不一样金额的社交立减金，如新老用户、是否会员等；
  4. 结合用户偏好兴趣，可配置个性化商品推荐，提升转化。

官方文档地址：小程序

https://mp.weixin.qq.com/wiki?t=resource/res_main&id=21515658940X5pIn
复制代码

接入流程

进入上面文档地址，文中有开通公众号活动配置权限，这个权限必须开启，开启指南以下：api

社交立减金可经过微信支付后向用户下发消息领取，在配置活动时须要登陆发起支付的商户号开通权限。

Q:在微信支付平台开通“公众号活动配置”权限
A:使用管理员账号（管理员为申请商户号时给用户分配的登陆帐号）登陆微信支付商户平台pay.weixin.qq.com，进入“产品中心－个人产品－运营工具”，进入并开通“公众号活动配置”权限。
复制代码

开通权限以后，还须要完成免充值模式验收，这个验收在个人前几篇文章中已经讲过，下面贴上对应的连接查看： 浅析微信支付：开通免充值产品功能及如何进行接口升级指引bash

完成免充值模式验收后，便可经过接口建立与支付打通的代金券，为配置立减金活动作准备。微信

若已完成免充值模式验收，可直接调用建立代金券并设置跳转小程序，下面是建立的流程和对应代码。app

建立社交立减金的步骤说明

首先，咱们来理解一下社交立减金的构成和建立流程，这样才能不被微信给弄迷糊了，下面是几个步骤的说明：微信公众平台

  1. 开通微信公众平台中的微信卡券功能
  2. 开通微信商户平台中的公众号活动配置功能
  3. 开通微信商户平台中的免充值相关产品功能
  4. 完成免充值模式验收
  5. 在微信商户平台建立或者经过接口建立微信代金券
  6. 登录微信支付商户平台 -营销中心-管理代金券-草稿箱中激活对应卡券
  7. 经过建立支付后领取立减金活动接口建立活动
  8. 登录微信支付商户平台 -营销中心-营销活动-满额送-管理-草稿箱激活活动。
  9. 下单购买某个商品后，在服务通知消息中能够领取或者转发社交立减金
  10. 领取，结束

上面的步骤，缺一不可，须要小伙伴一步步的调试和试错，幸运的是，我已经都试过错，因此把经验总结一下，但愿小伙伴们不会再次趟坑，建立社交立减金活动的源码也是有的哦～

好了，话很少说，对于上面的10步，前4步不须要讲，不清楚的小伙伴能够看看个人历史文章，有对应的讲解，下面从第5步开始提及。

建立代金券并设置跳转小程序

下面先讲解接口的方式，完成配置社交立减金活动奖品准备环节，经过本接口开发者能够建立和支付打通的代金券，并设置代金券跳转小程序使用，在 base_info 中新增设置字段"pay_info"，详情参考建立卡券接口。

协议：https  
http请求方式: POST  
请求URL：https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN  
POST数据格式：JSON
复制代码

对于POST的数据能够参考个人历史文章微信卡券建立，或者查看如下官方文档：

https://mp.weixin.qq.com/wiki?t=resource/res_main&id=21515658940X5pIn
复制代码

注意：

  1. 卡券提交前需检查是否有传："pay_info"、"is_swipe_card": true 字段；
  2. 卡券的起止时间应大于当前时间；如当前时间为：2018/1/17 0:0:0，起止时间需大于当前时间：2018/1/17 13:30:03 （时间精确到秒）；
  3. 需设置最低消费门槛，如：5元代金券，满10元可用。 "reduce_cost": 5 ,"least_cost":10 。

推荐查看个人文章，里面有一些字段的注意事项，这里就不细讲了，下面说一下第二种方式，就是直接经过微信商户平台建立代金券，建立完成后，须要在“微信支付商户平台 -营销中心-管理代金券-草稿箱”中激活对应卡券，获取卡券id后，可继续建立立减金活动。

建立支付后领取立减金活动接口

重头戏来了，能够经过此接口建立立减金活动。将已建立的代金券cardid、跳转小程序appid、发起支付的商户号等信息经过此接口建立立减金活动，成功返回活动id即为建立成功。

协议：https  
http请求方式: POST  
请求URL：https://api.weixin.qq.com/card/mkt/activity/create?access_token=ACCESS_TOKEN 
POST数据格式：JSON
复制代码

大白话解释一下，上面的代金券cardid就是经过接口返回的卡券ID，或者是经过手动建立后的卡包ID，就是乱七八糟一串英文的那一个，例如：pX2-vjpU_MT1gFDsP8lNl15PdaFS，官方的POST示例能够查看文档：

https://mp.weixin.qq.com/wiki?t=resource/res_main&id=21515658940X5pIn
复制代码

好消息来了，这个接口我已经封装在sdk中了，封装为方法便于你们使用，下面是调用方法和具体方法的代码。

调用方法：

/**
 * 建立支付后领取立减金活动接口
 *
 * @author yclimb
 * @date 2018/9/18
 */
private void createCardActivity() {
    WXUtils wxUtils = new WXUtils();
    wxUtils.createCardActivity("2018-09-18 18:00:00", "2018-09-18 19:59:59", 3, 1,
            1, "pX2-vjpU_MT1gFDsP8lNl15PdaZE", "100",
            null, false);
}
复制代码

方法源码：

/**
 * 建立支付后领取立减金活动接口
 * 经过此接口建立立减金活动。
 * 将已建立的代金券cardid、跳转小程序appid、发起支付的商户号等信息经过此接口建立立减金活动，成功返回活动id即为建立成功。
 * 接口地址：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=21515658940X5pIn
 *
 * @param begin_time               活动开始时间，精确到秒
 * @param end_time                 活动结束时间，精确到秒
 * @param gift_num                 单个礼包社交立减金数量（3-15个）
 * @param max_partic_times_act     每一个用户活动期间最大领取次数,最大为50，默认为1
 * @param max_partic_times_one_day 每一个用户活动期间单日最大领取次数,最大为50，默认为1
 * @param card_id                  卡券ID
 * @param min_amt                  最少支付金额，单位是元
 * @param membership_appid         奖品指定的会员卡appid。如用户标签有选择商户会员，则须要填写会员卡appid，该appid须要跟全部发放商户号有绑定关系。
 * @param new_tinyapp_user         能够指定为是否小程序新用户（membership_appid为空、new_tinyapp_user为false时，指定为全部用户）
 * @return json
 * @author yclimb
 * @date 2018/9/18
 */
public JSONObject createCardActivity(String begin_time, String end_time, int gift_num, int max_partic_times_act,
                                     int max_partic_times_one_day, String card_id, String min_amt,
                                     String membership_appid, boolean new_tinyapp_user) {
    try {

        // 建立活动接口以前的验证
        String msg = checkCardActivity(begin_time, end_time, gift_num, max_partic_times_act, max_partic_times_one_day, min_amt);
        if (null != msg) {
            JSONObject resultJson = new JSONObject(2);
            resultJson.put("errcode", "1");
            resultJson.put("errmsg", msg);
            return resultJson;
        }

        // 获取[商户名称]公众号的 access_token
        String accessToken = this.getAccessToken(WXConstants.WX_MINI_PROGRAM_CODE);

        // 调用接口传入参数
        JSONObject paramJson = new JSONObject(1);

        // info 包含 basic_info、card_info_list、custom_info
        JSONObject info = new JSONObject(3);

        // 基础信息对象
        JSONObject basic_info = new JSONObject(8);
        // activity_bg_color	是	活动封面的背景颜色，可参考：选取卡券背景颜色
        basic_info.put("activity_bg_color", CardBgColorEnum.COLOR_090.getBgName());
        // activity_tinyappid	是	用户点击连接后可静默添加到列表的小程序appid；
        basic_info.put("activity_tinyappid", WXPayConstants.APP_ID);
        // mch_code	是	支付商户号
        basic_info.put("mch_code", WXPayConstants.MCH_ID);
        // begin_time	是	活动开始时间，精确到秒（unix时间戳）
        basic_info.put("begin_time", DateTimeUtil.getTenTimeByDate(begin_time));
        // end_time	是	活动结束时间，精确到秒（unix时间戳）
        basic_info.put("end_time", DateTimeUtil.getTenTimeByDate(end_time));
        // gift_num	是	单个礼包社交立减金数量（3-15个）
        basic_info.put("gift_num", gift_num);
        // max_partic_times_act	否	每一个用户活动期间最大领取次数,最大为50，不填默认为1
        basic_info.put("max_partic_times_act", max_partic_times_act);
        // max_partic_times_one_day	否	每一个用户活动期间单日最大领取次数,最大为50，不填默认为1
        basic_info.put("max_partic_times_one_day", max_partic_times_one_day);

        // card_info_list	是	能够配置两种发放规则：小程序新老用户、新老会员
        JSONArray card_info_list = new JSONArray(1);
        JSONObject card_info = new JSONObject(3);
        // card_id	是	卡券ID
        card_info.put("card_id", card_id);
        // min_amt	是	最少支付金额，单位是分
        card_info.put("min_amt", String.valueOf(new BigDecimal(min_amt).multiply(new BigDecimal(100)).setScale(2, BigDecimal.ROUND_HALF_UP).intValue()));
        /*
         * membership_appid	是	奖品指定的会员卡appid。如用户标签有选择商户会员，则须要填写会员卡appid，该appid须要跟全部发放商户号有绑定关系。
         * new_tinyapp_user	是	能够指定为是否小程序新用户
         * total_user	是	能够指定为全部用户
         * membership_appid、new_tinyapp_user、total_user以上字段3选1，未选择请勿填，没必要故意填写false
         */
        if (StringUtils.isNotBlank(membership_appid)) {
            card_info.put("membership_appid", membership_appid);
        } else {
            if (new_tinyapp_user) {
                card_info.put("new_tinyapp_user", true);
            } else {
                card_info.put("total_user", true);
            }
        }
        card_info_list.add(card_info);

        // 自定义字段，表示支付后领券
        JSONObject custom_info = new JSONObject(1);
        custom_info.put("type", "AFTER_PAY_PACKAGE");

        // 拼装json对象
        info.put("basic_info", basic_info);
        info.put("card_info_list", card_info_list);
        info.put("custom_info", custom_info);
        paramJson.put("info", info);

        // 请求微信接口，获得返回结果[json]
        HttpEntity<JSONObject> entity = new HttpEntity<>(paramJson, this.getHttpHeadersUTF8JSON());
        JSONObject resultJson = restTemplate.postForObject(WXURL.WX_CARD_ACTIVITY_CREATE_URL, entity, JSONObject.class, accessToken);

        // {"errcode":0,"errmsg":"ok","activity_id":"4728935"}
        System.out.println(resultJson.toJSONString());

        return resultJson;
    } catch (Exception e) {
        WXPayUtil.getLogger().error(e.getMessage(), e);
    }
    return null;
}

/**
 * 建立活动接口以前的验证
 *
 * @param begin_time               活动开始时间，精确到秒
 * @param end_time                 活动结束时间，精确到秒
 * @param gift_num                 单个礼包社交立减金数量（3-15个）
 * @param max_partic_times_act     每一个用户活动期间最大领取次数,最大为50，默认为1
 * @param max_partic_times_one_day 每一个用户活动期间单日最大领取次数,最大为50，默认为1
 * @param min_amt                  最少支付金额，单位是元
 * @return msg str
 * @author yclimb
 * @date 2018/9/18
 */
public String checkCardActivity(String begin_time, String end_time, int gift_num, int max_partic_times_act,
                                int max_partic_times_one_day, String min_amt) {

    // 开始时间不能小于结束时间
    if (DateTimeUtil.latterThan(end_time, begin_time, DateTimeUtil.TIME_FORMAT_NORMAL)) {
        return "活动开始时间不能小于活动结束时间";
    }

    // 单个礼包社交立减金数量（3-15个）
    if (gift_num < 3 || gift_num > 15) {
        return "单个礼包社交立减金数量（3-15个）";
    }

    // 每一个用户活动期间最大领取次数,最大为50，默认为1
    if (max_partic_times_act <= 0 || max_partic_times_act > 50) {
        return "每一个用户活动期间最大领取次数,最大为50，默认为1";
    }

    // 每一个用户活动期间单日最大领取次数,最大为50，默认为1
    if (max_partic_times_one_day <= 0 || max_partic_times_one_day > 50) {
        return "每一个用户活动期间单日最大领取次数,最大为50，默认为1";
    }

    // 最少支付金额，单位是元
    if (BigDecimal.ONE.compareTo(new BigDecimal(min_amt)) > 0) {
        return "最少支付金额必须大于1元";
    }

    return null;
}


复制代码

对应的所有代码，能够查看个人github，地址以下：

https://github.com/YClimb/wxpay-sdk/blob/master/src/main/java/com/weixin/pay/util/WXUtils.java
复制代码

建立成功后，会返回一个 "activity_id": "123456" 的json数据，也就是立减金活动id咯，若是建立失败，也不要着急，查看上面说到的官方文档，建立接口下有对应的返回码说明， 已知是足够解决问题了。

活动建立成功后，须要登录“微信支付商户平台 -营销中心-营销活动-满额送-管理-草稿箱”激活活动，激活后，社交立减金投放成功。能够经过支付行为进行验证。

PS：激活活动后，活动是经过满额送行为发送给用户的，并且是自动发放，若是你在平台上购买的商品价格知足规则，则会在服务通知中显示社交立减金的信息，此活动须要用户主动领取才行，用户领取的券最终就是咋们最初建立的代金券，此代金券使用规则和正常代金券同样。

PPS：社交立减金能够分享转发给朋友，这个是他的特色，对于每一个活动的代金券规则和份数，你们必定要注意，根据场景投放。

结语

以上为社交立减金相关的解释和源码，小伙伴们必定要注意看看官方文档哦，具体的源码能够看个人github，里面对每一个方法有详细的注释。

若是小伙伴有遇到解决不了的问题，能够关注做者微信公众号，加入讨论群中发出疑问，和小伙伴们一块儿解决哦～

​若是想要提早一览源码的小伙伴，能够先看看个人 github，地址以下： ​ ​​https://github.com/YClimb/wxpay-sdk/blob/master/README.md ​

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

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

关注个人公众号
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程