微信小程序社交立减金活动接入流程1 社交立减金产品概述
小程序社交立减金是一款帮助商家快速生成具备裂变传播属性的小程序经营工具，用户通过支付、扫码等场景可以参与社交立减金活动，将社交立减金礼包分享至朋友后自己可获取一份，朋友在会话中可随机获取社交立减金，并直达商家小程序使用。
产品优势
1.打通“小程序+支付+优惠”，支付成功页分发社交立减金，支付时抵扣使用；
2.通过聊天分享和裂变，触达更多潜在用户，降低拉新成本；
3.根据用户标签属性，可配置分发不同金额的社交立减金，如新老用户、是否会员等；
4.结合用户偏好兴趣，可配置个性化商品推荐，提高转化。
2 支付后下发社交立减金活动接入流程
在微信支付平台开通“公众号活动配置”权限
管理员帐号（管理员为申请商户号时给用户分配的登录账号）登录微信支付商户平台pay.weixin.qq.com，进入“产品中心－我的产品－运营工具”，进入并开通“公众号活动配置”权限后，即可调用创建社交立减金活动接口创建活动。
微信小程序社交立减金活动接入流程
微信小程序社交立减金活动接入流程
接口调用请求说明
协议：https
http请求方式: POST
请求URL：https://api.weixin.qq.com/card/m ... _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": "p12345678123123",
"min_amt": 100,
"membership_appid": ["wx123456789"]
//new_tinyapp_user: true //
//total_user: true //
//以上字段3选1，未选择请勿填，不必故意填false
},
{
"card_id": "p12345678123124",
"min_amt": 100,
}
],
"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 | 是 | 支付商户号 | | membership_appid | 是 | 奖品指定的会员卡appid。如用户标签有选择商户会员，则需要填写会员卡appid，该appid需要跟所有发放商户号有绑定关系。 | | new_tinyapp_user | 是 | 可以指定为是否小程序新用户 | | total_user | 是 | 可以指定为所有用户 | |
| membership_appid、new_tinyapp_user、total_user以上字段3选1，未选择请勿填，不必故意填写false | | card_id | 是 | 卡券ID | | min_amt | 是 | 最少支付金额，单位是分
|
3 非支付渠道下发社交立减金活动接入流程
除在支付完成后通过模板消息下发社交立减金活动外，还可以在公众号图文消息、公众号模板消息、小程序等渠道下发社交立减金。
3.1完成免充值模式验收
为支持商户免充值营销经费开展运营活动，提升运营效率，微信支付特开发免充值营销产品功能。商户开通该产品功能后，可免费使用微信支付提供的免充值代金券、立减、折扣等营销工具。商户配置使用免充值代金券、立减、折扣等营销优惠，不需要预先充值营销经费，当用户核销优惠时，微信支付会直接扣减商户订单实收金额。
微信小程序社交立减金活动接入流程
3.2 创建代金券并设置跳转小程序
完成免充值代金券产品权限开通后即可通过接口创建与支付打通的代金券，创建成功后配置社交立减金活动。
通过本接口开发者可以创建和支付打通的代金券，并设置代金券跳转小程序使用，在 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",
"color": "Color010",
"service_phone": "020-88888888",
"description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户 提出",
"date_info": {
"type": "DATE_TYPE_FIX_TIME_RANGE",
"begin_timestamp": 1509977220,
"end_timestamp": 1515897259
},
"can_share": false,
"can_give_friend": false,
"location_id_list": [
272981040,
400183234
],
"get_limit": 30,
"center_title": "快速核销",
"center_sub_title": "",
"center_url": "www.xxx.com",
"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": false,
"least_cost": 101
},
"abstract": {
"abstract": "微信餐厅推出多种新季菜品，期待您的光临",
"icon_url_list": [
"http://mmbiz.qpic.cn/mmbiz/p98FjXy8Lac"
]
},
"text_image_list": [
{
"image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8",
"text": "此菜品精选食材，以独特的烹饪方法，最大程度地刺激食 客的味蕾"
},
{
"image_url": "http://mmbiz.qpic.cn/mmbiz/p98Fj",
"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"
]
},
"center_title": "立即使用", //配置代金券跳转小程序
"center_app_brand_user_name": "gh_50338e5b8c9d@app", //原始ID+@app
"center_app_brand_pass": "API/cardPage"//小程序的路径path
}
}"reduce_cost": 10
}
}
}
}
请求数据说明
字段 | 是否必填 | 示例 | 说明 | | pay_info | 是 |
| JSON 结构，设置刷卡类型的卡券必填 | | swipe_card | 是 |
| JSON 结构，设置刷卡类型的卡券必填 | | zuse_mid_list | 否 | 1219518501 | 适用商家商户号列表，创建卡券后将发送通知至适用商户号，待商家登录微信支付后台审核通过后，由制券商家激活。 | | create_mid | 是 | 1219518501 | 创建朋友券的商户号，可登录公众平台-微信支付查看。待适用商家审核通过后需创建朋友券的商户号登录支付后台进行激活。 |
创建成功后获取卡券id，并登录支付后台进行卡券激活。
3.3 生成社交立减金活动3.3.1创建社交立减金活动接口
接口调用说明 协议：https
http请求方式: POST
请求URL：https://api.weixin.qq.com/card/m ... _token=ACCESS_TOKEN
POST数据格式：JSON
请求参数说明
字段 | 是否必填 | 说明 | | access_token | 是 | 调用接口凭证 | | POST数据 | 是 | JSON数据 |
POST数据
数据示例1（新老会员）
{
"info": {
"basic_info": {
"begin_time": 1508259270,
"end_time": 1508269270,
"max_partic_times_act": 99,
"gift_num": 3,
"activity_tinyappid": "wx3661dec4a09553f1",
"activity_bg_color": "Color010"
},
"card_info_list": [
{
"card_id": "pbLatjtZKQ0VXqyy5pW6OaHthWTg",
"priority": 2,
"membership_appid": "wxc0b84a53ed8e8d29"
},
{
"card_id": "pbLatjvsk2Fr8pfcYQagMw1ez_mk",
"priority": 2
}
],
"custom_info": {
"gen_limit": 2
}
}
}
字段说明
字段 | 是否必填 | 说明 | | begin_time | 是 | 活动开始时间，精确到秒（unix时间戳） | | end_time | 是 | 活动结束时间，精确到秒（unix时间戳） | | max_partic_times_act | 否 | 每个用户活动期间最大领取次数,最大为50，不填默认为1 | | gift_num | 是 | 单个礼包社交立减金数量（3-15个） | | activity_tinyappid | 是 | 用户点击链接后可静默添加到列表的小程序appid； | | activity_bg_color | 是 | 活动封面的背景颜色，可参考：选取卡券背景颜色 | | card_id | 是 | 卡券ID | | priority | 是 | 奖品优先级，只支持整数 | | membership_appid | 是 | 奖品指定的会员卡appid。如用户标签有选择商户会员，则需要填写会员卡appid，该appid需要跟所有发放商户号有绑定关系。 | | gen_limit | 是 | 生成上限
|
返回数据 {
"errcode": 0,
"errmsg": "ok",
"activity_id": "1_428704405"
}
字段说明
数据示例2（新老小程序用户） {
"info": {
"basic_info": {
"begin_time": 1508259270,
"end_time": 1508269270,
"max_partic_times_act": 99,
"gift_num": 3,
"activity_tinyappid": "wx3661dec4a09553f1",
"activity_bg_color": "Color010"
},
"card_info_list": [
{
"card_id": "pbLatjtZKQ0VXqyy5pW6OaHthWTg",
"priority": 2,
"new_tinyapp_user": true
},
{
"card_id": "pbLatjvsk2Fr8pfcYQagMw1ez_mk",
"priority": 2,
"new_tinyapp_user": false
}
],
"custom_info": {
"gen_limit": 2
}
}
}
字段说明
字段 | 是否必填 | 说明 | | begin_time | 是 | 活动开始时间，精确到分 | | end_time | 是 | 活动结束时间，精确到分 | | max_partic_times_act | 否 | 每个用户活动期间最大领取次数,最大为50，不填默认为1 | | gift_num | 是 | 单个礼包社交立减金数量（3-15个） | | activity_tinyappid | 是 | 用户点击链接后可静默添加到列表的小程序appid； | | activity_bg_color | 是 | 活动封面的背景颜色，可参考：选取卡券背景颜色 | | card_id | 是 | 卡券ID | | priority | 是 | 奖品优先级，只支持整数 | | new_tinyapp_user | 是 | 奖品指定的小程序新老用户。 true：小程序新用户 false：小程序老用户 | | gen_limit | 是 | 生成上限 |
返回数据 {
"errcode": 0,
"errmsg": "ok",
"activity_id": "1_428704405"
}
字段说明
3.3.2生成社交立减金活动路径接口
通过接口将社交立减金活动生成一条小程序路径，支持商家自助嵌入小程序流程中、模板消息、公众号文章等渠道中。
接口调用说明 协议：https
http请求方式: POST
请求URL：https://api.weixin.qq.com/card/m ... _token=ACCESS_TOKEN
POST数据格式：JSON
请求参数说明
字段 | 是否必填 | 说明 | | access_token | 是 | 调用接口凭证 | | POST数据 | 是 | JSON数据 |
POST数据
数据示例1 {
"activity_id":"1_428705474",
"scene":"ALLOC_ONE",
"openid":"obLatjgoYejavUtHsWwrX-2GtFJE"
}
字段说明
字段 | 是否必填 | 说明 | | activity_id | 是 | 活动ID | | scene | 是 | 场景值 ALLOC_ONE 生成社交立减金活动入口路径 | | openid | 否 | 若生成一个礼包则必填 |
返回数据 {
"errcode": 0,
"errmsg": "ok",
"wxa_username": "gh_af84e82fc39c@app",
"wxa_path": "pages/index/index?signature=dd524bc4974f280e2bb1ef57d5fb7953f0bfe609&type=1&scene=3&pack_id=NDYxMzI5OTMzXzEyMDQyNDA1NDA%3D&act_id=428705474"
}
字段说明
字段 | 说明 | | wxa_username | 跳转小程序的原始ID | | wxa_path | 跳转小程序的路径 |
数据示例2 {
"activity_id":"1_428705474",
"scene":"ALLOC_ENTRANCE"
}
字段说明
字段 | 是否必填 | 说明 | | activity_id | 是 | 活动ID | | scene | 是 | 场景值 ALLOC_ENTRANCE 生成社交立减金活动二维码 |
返回数据 {
"errcode": 0,
"errmsg": "ok",
"wxa_username": "gh_af84e82fc39c@app",
"wxa_path": "pages/index/index?signature=aba25623e78f4bc48c62d0de7aabcb8b524f122b&type=1&scene=2&act_id=428705474"
}
字段说明
字段 | 说明 | | wxa_username | 跳转小程序的原始ID | | wxa_path | 跳转小程序的路径
|
|
|Archiver|手机版|小黑屋|鲁公网安备 37082802000167号|微信邦
( 鲁ICP备19043418号-5 )
发表于 2018-1-17 10:46:58
