社交立减金专区-社交立减金活动接入流程


上一篇 : 会员卡专区-管理会员卡 下一篇: 朋友的券-朋友的券说明



社交立减金业务接口文档

社交立减金产品目录

1 社交立减金产品概述

2 社交立减金活动接入流程

2.1 开通产品权限

2.2 完成免充值验收

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

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

2.5 激活立减金活动

1 社交立减金产品概述

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

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

0 (3).jpg

2 社交立减金活动接入流程

2.1 开通产品权限

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

在微信支付平台开通“公众号活动配置”权限
使用管理员帐号(管理员为申请商户号时给用户分配的登录账号)登录微信支付商户平台pay.weixin.qq.com,进入“产品中心-我的产品-运营工具”,进入并开通“公众号活动配置”权限。
0 (2).jpg

0 (1).png

2.2 完成免充值模式验收

完成免充值模式验收后,即可通过接口创建与支付打通的代金券,为配置立减金活动做准备。

开通步骤:完成免充值模式验收 免充值模式验收

原因:
开通免充值业务功能后,“下载对账单,刷卡支付、公众号/APP/扫码支付,订单查询,申请退款,查询退款,支付通知”等接口均存在部分字段变更。测试验收可以帮助商户理解接口变更字段,以确保商户和用户正常使用微信支付。

若已完成免充值模式验收,可直接调用 2.3 创建代金券并设置跳转小程序

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

完成配置社交立减金活动奖品准备环节,通过本接口开发者可以创建和支付打通的代金券,并设置代金券跳转小程序使用,在 base_info 中新增设置字段"pay_info",详情参考创建卡券接口。

接口调用请求说明

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

POST 数据示例

{
   "card": {
       "card_type": "CASH",
       "cash": {
           "base_info": {
               "logo_url": "http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9",
               "pay_info": {
                   "swipe_card": {
                       "use_mid_list": [
                           "1900015421"
                       ],
                       "create_mid": "1900015421",
                       "is_swipe_card": true
                   }
               },
               "brand_name": "微信餐厅",
               "code_type": "CODE_TYPE_NONE",
               "title":"111",
               "color": "Color010",
               "service_phone": "020-88888888",
               "description": "不可与其他优惠同享\n如需团购券发票,请在消费时向商户 提出",
               "date_info": {
                   "type": "DATE_TYPE_FIX_TIME_RANGE",
                   "begin_timestamp": 1519669331,
                   "end_timestamp": 1519969331
               },
               "can_share": false,
               "center_title": "立即使用",
               "center_app_brand_user_name": "gh_7195ea80d2e6@app",
               "center_app_brand_pass": "pages/index/index",
               "can_give_friend": false,
                "sku": {
                 "quantity": 500000
             },
               "get_limit": 30,
               "custom_url_name": "立即使用",
               "custom_url": "http://www.qq.com",
               "custom_url_sub_title": "6个汉字tips",
               "promotion_url_name": "更多优惠",
               "promotion_url": "http://www.qq.com"
           },
            "advanced_info": {
              "use_condition": {
                  "accept_category": "鞋类",
                  "reject_category": "阿迪达斯",
                  "can_use_with_other_discount": true,
                  "least_cost":"51"
              },
              "abstract": {
                  "abstract": "微信餐厅推出多种新季菜品,期待您的光临",
                  "icon_url_list": [
                      "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj
 piby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0"
                  ]
              },
              "text_image_list": [
                  {
                      "image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0",
                      "text": "此菜品精选食材,以独特的烹饪方法,最大程度地刺激食 客的味蕾"
                  },
                  {
                      "image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj piby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0",
                      "text": "此菜品迎合大众口味,老少皆宜,营养均衡"
                  }
              ],
              "time_limit": [
                  {
                      "type": "MONDAY",
                      "begin_hour":0,
                      "end_hour":10,
                      "begin_minute":10,
                      "end_minute":59
                  },
                  {
                      "type": "HOLIDAY"
                  }
              ],
              "business_service": [
                  "BIZ_SERVICE_FREE_WIFI",
                  "BIZ_SERVICE_WITH_PET",
                  "BIZ_SERVICE_FREE_PARK",
                  "BIZ_SERVICE_DELIVER"
              ]
          },


           "reduce_cost": 5
       }
   }
}

请求数据说明

字段 是否必填 示例 说明
pay_info
JSON 结构,设置刷卡类型的卡券必填
swipe_card
JSON 结构,设置刷卡类型的卡券必填
use_mid_list 1219518501 适用商家商户号列表,创建卡券后将发送通知至适用商户号,需制券商家激活。
create_mid 1219518501 创建代金券的商户号,可登录公众平台-微信支付查看。需创建代金券的商户号登录支付后台进行激活。
center_title 立即使用 配置代金券跳转小程序
center_app_brand_user_name gh_50338e5b8c9d@app 原始ID+@app
center_app_brand_pass 立即使用 配置代金券跳转小程序path

具体代金券对应字段可到创建卡券接口文档 查看。
创建成功后,登陆“微信支付商户平台 -营销中心-管理代金券-草稿箱”中激活对应卡券。

0 (1).jpg

获取卡券id后,可继续创建立减金活动。

注意:
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 。

激活代金券

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

通过此接口创建立减金活动。
将已创建的代金券cardid、跳转小程序appid、发起支付的商户号等信息通过此接口创建立减金活动,成功返回活动id即为创建成功。

接口调用请求说明

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

POST 数据示例

{
   "info":{
       "basic_info":{
           "activity_bg_color":"Color010",
           "activity_tinyappid":"wx123456789",
           "begin_time": 1515934945,
           "end_time": 1515935945,
           "gift_num": 3,
           "max_partic_times_act": 10,
           "max_partic_times_one_day": 10,
           "mch_code": "1234567"
       },
       "card_info_list": [{
           "card_id": "p12345678123124",
           "min_amt": 100,
           "membership_appid": "wx123456789"
           //new_tinyapp_user: true //
         //total_user: true //
         //以上字段3选1,未选择请勿填,不必故意填false
       }],
       "custom_info": {
           "type": "AFTER_PAY_PACKAGE"
       }
   }
}

请求数据说明

字段 是否必填 说明
activity_bg_color 活动封面的背景颜色,可参考:选取卡券背景颜色
activity_tinyappid 用户点击链接后可静默添加到列表的小程序appid;
begin_time 活动开始时间,精确到秒(unix时间戳)
end_time 活动结束时间,精确到秒(unix时间戳)
gift_num 单个礼包社交立减金数量(3-15个)
max_partic_times_act 每个用户活动期间最大领取次数,最大为50,不填默认为1
max_partic_times_one_day 每个用户活动期间单日最大领取次数,最大为50,不填默认为1
mch_code 支付商户号
card_id 卡券ID
min_amt 最少支付金额,单位是分
card_info_list 可以配置两种发放规则:小程序新老用户、新老会员
membership_appid 奖品指定的会员卡appid。如用户标签有选择商户会员,则需要填写会员卡appid,该appid需要跟所有发放商户号有绑定关系。
new_tinyapp_user 可以指定为是否小程序新用户
total_user 可以指定为所有用户


membership_appid、new_tinyapp_user、total_user以上字段3选1,未选择请勿填,不必故意填写false

返回数据

{
   "activity_id": "123456"
}

请求数据说明

字段 说明
activity_id 立减金活动id

返回码列表

返回码 说明
268505101 创建卡券有误,注意卡券"is_swipe_card": true字段
268505099 公众号活动配置权限未开通
268701697 推荐小程序与奖品的发放商户无绑定关系
268505103 传入的appid与cardid对应appid不匹配
268702034 参与活动次数达到上限
268702033 参与活动次数达到单日上限
268702063 其他帐号已领取代金券(达到自然人领取上限)
268702020 活动已结束(活动曝光用完)
268702100 活动已结束(商户账户营销经费不足)
268702065 活动已过期
268702990 无库存
268701985 代金券库存不足
268702022 无库存
268701984 达到代金券领取上限
268702025 未开通发券账户
268701989 代金券已过期
268505089 *需根据对应返回提示排查问题
999008 小程序appid填写错误
999103 没有填user_tag字段
999102 创建卡券有误,注意卡券"is_swipe_card": true字段
10023 代金券卡券id填写错误
29 代金券库存不足
30 达到领取上限

2.5 激活立减金活动

返回立减金活动id,活动创建成功,登陆“微信支付商户平台 -营销中心-营销活动-满额送-管理-草稿箱”激活活动。

0.jpg

0.png

激活后,社交立减金投放成功。可以通过支付行为进行验证。

如有任何疑问可到小程序开发者社区 留言。


上一篇 : 会员卡专区-管理会员卡 下一篇: 朋友的券-朋友的券说明