小程序社交立减金功能实现了商家快速获取社交、裂变传播属性。那么在经营小程序时如何开放社交立减金接口呢。
社交立减金开放接口流程
除在支付完成后通过模板消息下发社交立减金活动外，还可以在公众号图文消息、公众号模板消息、小程序等渠道下发社交立减金。
完成免充值模式验收
为支持商户免充值营销经费开展运营活动，提升运营效率，微信支付特开发免充值营销产品功能。商户开通该产品功能后，可免费使用微信支付提供的免充值代金券、立减、折扣等营销工具。商户配置使用免充值代金券、立减、折扣等营销优惠，不需要预先充值营销经费，当用户核销优惠时，微信支付会直接扣减商户订单实收金额。
开通步骤：完成6个接口的验收 https://pay.weixin.qq.com/wiki/doc/api/jsapi_sl.php?chapter=23_15
原因：开通免充值业务功能后，“下载对账单，刷卡支付、公众号/APP/扫码支付，订单查询，申请退款，查询退款，支付通知”等接口均存在部分字段变更。测试验收可以帮助商户理解接口变更字段，以确保商户和用户正常使用微信支付。
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/mkt/activity/create?access_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"
}
字段说明
字段 说明
activity_id 活动ID
数据示例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"
}
字段说明
字段 说明
activity_id 活动ID
3.3.2生成社交立减金活动路径接口
通过接口将社交立减金活动生成一条小程序路径，支持商家自助嵌入小程序流程中、模板消息、公众号文章等渠道中。
接口调用说明
协议：https
http请求方式: POST
请求URL：https://api.weixin.qq.com/card/mkt/package/alloc?access_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 跳转小程序的路径
社交立减金小程序相关热点
小程序社交立减金入口
小程序社交立减金系统开发
小程序社交立减金接口设置（支付渠道）
7*24小时售后支持
故障及时处理
价格透明
优秀的团队服务
8年对“设计创新”坚持
42名有想法有激情的队友
1000多家忠实客户
技术性团队
经验丰富
产品多样
服务精细
