一键开卡。
该选项与activate_url互斥。
auto_activate
否
bool
是否开通自动激活
,设置为true时用户领取会员卡自动设置为激活,
详情见自动激活。
activate_url
否
string(128)
激活链接
custom_field1
否
Json结构
自定义会员信息类目,会员卡激活后显示。
custom_field2
否
Json结构
自定义会员信息类目,会员卡激活后显示。
custom_field3
否
Json结构
自定义会员信息类目,会员卡激活后显示。
name_type
否
string(24)
会员信息类目名称。
FIELD_NAME_TYPE_LEVEL 等级
FIELD_NAME_TYPE_COUPON 优惠券
FIELD_NAME_TYPE_STAMP 印花
FIELD_NAME_TYPE_DISCOUNT 折扣FIELD_NAME_TYPE_ACHIEVEMEN 成就
FIELD_NAME_TYPE_MILEAGE 里程
url
否
string(128)
点击类目跳转外链url
custom_cell1
否
JSON结构
自定义会员信息类目,会员卡激活后显示
bonus_rule
否
JSON结构
积分规则结构体,用于微信买单功能
cost_money_unit
否
int
消费金额,以分为单位
increase_bonus
否
int
根据以上消费金额对应增加的积分
max_increase_bonus
否
int
单次获取的积分上限
init_increase_bonus
否
int
用户激活后获得的初始积分
cost_bonus_unit
否
int
每使用5积分。
reduce_money
否
int
抵扣xx元,(这里以分为单位)
least_money_to_use_bonus
否
int
抵扣条件,满xx元(这里以分为单位)可用
max_reduce_bonus
否
int
抵扣条件,单笔最多使用xx积分
discount
否
int
折扣,该会员卡享受的折扣优惠
返回数据说明
数据示例:
{ "errcode":0, "errmsg":"ok", "send_check":true}
参数名
描述
errcode
错误码,0为正常。
errmsg
错误信息。
send_check
此次更新是否需要提审,true为需要,false为不需要。
开发者注意事项注
1. 更改卡券的部分字段后会重新提交审核,详情见字段说明,更新成功后可通过调用查看卡券详情接口核查更新结果;
2. 仅填入需要更新的字段,许多开发者在调用该接口时会填入brandname等不支持修改的字段,导致更新不成功。
3. 调用该接口后更改卡券信息后,请务必调用查看卡券详情接口验证是否已成功更改。
8.3 设置跟随推荐
功能介绍
支持开发者在积分变动消息底部,配置卡券或设置跳转外链URL,具体形式如下图,可以是URL也可以是一张卡券。
开发者注意事项
一、支持两种类型的跟随推荐配置
1. 广告语+URL,支持商户配置16个汉字长度的文案,及点击跳转的链接。
2. 推荐卡券,支持商户配置一个本公众号下的卡券。
二、推荐位有效期控制
1. 广告语+URL类型,支持商户根据活动期限自定义展示时间。
2. 推荐卡券类型,由微信后台判断卡券的有效性,当卡券已过期、已被领完、已被置为失效会自动下架展示。
8.3.1 设置跟随推荐接口
接口说明
调用更新卡券信息接口将增推荐位字段 update到已成功通过审核的卡券。 同时支持在创建卡券时填入相应字段。
接口详情
接口调用请求说明
http请求方式: POSThttps://api.weixin.qq.com/card/update?access_token=TOKEN
参数说明
参数
是否必须
说明
access_token
是
调用接口凭证
POST数据
是
Json数据
使用消息配置卡券
{
"card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
"member_card": {
"modify_msg_operation": {
"card_cell": {
"end_time": 1452724561,
"card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
}
}
}
使用消息配置URL
{
"card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
"member_card": {
"modify_msg_operation": {
"url_cell": {
"end_time": 1452724561,
"text": "更多优惠",
"url": "www.qq.com"
}
}
}
}
字段说明
字段名
说明
card_id
卡券ID。
modify_msg_operation
积分余额变动消息类型
card_cell
卡券类型的推荐位。Json结构参考示例。
url_cell
链接类型的推荐位。Json结构参考示例。
card_id
需要在运营位投放的卡券id
end_time
推荐位展示的截止时间。
text
文本内容。
url
跳转链接。
返回数据
{ "errcode":0, "errmsg":"ok" }
字段说明
字段名
说明
错误码
错误码,0为正常;43008为商户没有开通微信支付权限;
errmsg
错误信息
8.4 设置支付即会员
8.4.1 增加支付即会员规则接口
开通微信支付的商户可以设置,用户在微信支付后自动为用户发送一条领卡消息,用户点击消息即可领取会员卡。
接口说明
支持商户设置支付即会员的规则,可以区分时间段和金额区间发会员卡。
接口调用请求说明
HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/add?access_token=TOKEN
参数说明
参数
是否必须
说明
POST数据
是
Json数据
access_token
是
调用接口凭证
POST数据
{
"card_id": "xxxxxxxxa",
"jump_url": "mp.weixin.qq.com/wiki",
"mchid_list": [
"123",
"1234",
"12345"
],
"begin_time": 146324567,
"end_time": 147234567,
"min_cost": 1000,
"max_cost": 10000000,
"is_locked": true
}
字段说明
字段名
说明
card_id
卡券ID,仅支持非自定义code模式的card_id和预存code模式的card_id。
jump_url
模板消息跳转的url,可以是商户自定义的领卡网页链接
mchid_list
支持赠券规则的商户号列表
begin_time
规则生效时间
end_time
规则结束时间
min_cost
本次规则生效支付金额下限,与分为单位
max_cost
本次规则生效支付金额上限,与分为单位
is_locked
是否允许其他appid设置本规则内已经设置过的商户号,默认为true
返回数据说明
数据示例:
{
"errcode": 0,
"errmsg": "ok",
"succ_list":[
"134xxxxxx"
],
"fail_list":[
{
"mchid": "xxxxx",
"errcode": 0,
"errmsg": "ok",
"occupy_appid": "wxxxxxxxxxxx"
},
{
"mchid": "xxxxx",
"errcode": 0,
"errmsg": "ok",
"occupy_appid": "wxxxxxxxxxxx"
}
]
}
参数名
描述
errcode
错误码,0为正常。
errmsg
错误信息。
succ_list
设置成功的mchid列表
fail_list
设置失败的mchid列表
mchid
支付的商户号
occupy_appid
设置失败原因为重复设置时,该mchid当前被占用的appid,商户须使用该appid解除绑定后重新设置。
开发者注意事项注
1. 会员卡领卡消息针对单个新用户仅发送一次,若该用户已经接收或者已经领取过会员卡则不会重复发送;
2. 通过该规则设置的card_id的制券appid必须和当前mch_id的主体appid一致,否则报错72001;
3.仅支持会员卡类型的卡券,否则报错:72003;
4.设置支付即会员时,须确认调用接口的appid和当前card_id主体一致,以及appid与mchid有绑定关系,否则报错:72002;
5.须保证mchid之前没有被其他appid设置过,否则报错72004;
6.单次仅限设置100个mchid,若超过100个请多次调用本接口。
8.4.2 删除支付即会员规则接口
删除之前已经设置的支付即会员规则。
接口说明
支持商户设置支付即会员的规则,可以区分时间段和金额区间发会员卡。
接口调用请求说明
HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/delete?access_token=TOKEN
参数说明
参数
是否必须
说明
POST数据
是
Json数据
access_token
是
调用接口凭证
POST数据
{
"card_id": "xxxxxxxxa",
"mchid_list": [
123,
1234,
12345
]
}
字段说明
字段名
说明
card_id
卡券ID。
mchid_list
本次删除的支付即会员的商户号列表
返回数据说明
数据示例:
{
"errcode": 0,
"errmsg": "ok",
"succ_list":[
{
"mchid": "xxxxx",
"errcode": 0,
"errmsg": "ok",
"occupy_appid": "wxxxxxxxxxxx"
},
{
"mchid": "xxxxx",
"errcode": 0,
"errmsg": "ok",
"occupy_appid": "wxxxxxxxxxxx"
}
],
"fail_list":[
{
"mchid": "xxxxx",
"errcode": 0,
"errmsg": "ok",
"occupy_appid": "wxxxxxxxxxxx"
},
{
"mchid": "xxxxx",
"errcode": 0,
"errmsg": "ok",
"occupy_appid": "wxxxxxxxxxxx"
}
]
}
参数名
描述
errcode
错误码,0为正常。
errmsg
错误信息。
succ_list
设置成功的mchid列表
fail_list
设置失败的mchid列表
mchid
支付的商户号
occupy_appid
设置失败原因为重复设置时,该mchid当前被占用的appid,商户须使用该appid解除绑定后重新设置。
8.4.3 查询商户号支付即会员规则接口
接口说明
可以查询某个商户号是否支持支付即会员功能
接口调用请求说明
HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/get?access_token=TOKEN
参数说明
参数
是否必须
说明
POST数据
是
Json数据
access_token
是
调用接口凭证
POST数据
{"mchid":"xxxxxxxx"}
字段说明
字段名
说明
mchid
要查询的支付商户号。
返回数据说明
数据示例:
{
"errcode": 0,
"errmsg": ok,
"card_id": "xxxxxxxxxxxxxxxxxx",
"occupy_appid": "wxxxxxxxxxxx",
"is_locked": true
}
8.5 设置会员卡拉出微信支付刷卡界面
通过接口创建支持刷卡类型的会员卡,用户点击快速买单后即可拉出刷卡界面进行支付。以下为示意图:
8.5.1 创建会员卡支持微信支付刷卡
商户可以创建一张会员卡支持微信支付刷卡,须在创建会员卡接口的JSON中加入以下字段:
{
"card": {
"card_type": "MEMBER_CARD",
"member_card": {
"base_info": {
"pay_info":
{
"swipe_card":
{
"is_swipe_card":true
}
}
}
}
}
}
8.5.2 更新会员卡支持微信支付刷卡
商户可以更新已有会员卡支持微信支付刷卡,须在更新会员卡接口的JSON中加入以下字段:
{
"card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
"member_card": {
"base_info": {
"pay_info":
{
"swipe_card":
{
"is_swipe_card":true
}
}
}
}
}
是否开通自动激活
,设置为true时用户领取会员卡自动设置为激活,
详情见自动激活。
会员信息类目名称。
FIELD_NAME_TYPE_LEVEL 等级
FIELD_NAME_TYPE_COUPON 优惠券
FIELD_NAME_TYPE_STAMP 印花
FIELD_NAME_TYPE_DISCOUNT 折扣FIELD_NAME_TYPE_ACHIEVEMEN 成就
FIELD_NAME_TYPE_MILEAGE 里程
least_money_to_use_bonus
接口详情
使用消息配置URL
返回数据