设置会员卡模板权益项

更新时间:2024.09.20

设置是否在用户的会员卡详情页展示积分、优惠、发票等权益,以及展示的一些商家自定义的字段值

接口说明

支持商户:【普通商户】

请求方式:【PATCH】/v3/marketing/membercard-open/cards/{card_id}/rights

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header HTTP头参数

Authorization  必填 string

请参考签名认证生成认证信息


Accept  必填 string

请设置为application/json


Content-Type  必填 string

请设置为application/json


path 路径参数

card_id  必填 string(32)

【会员卡模板ID】商户创建微信会员卡模板成功后系统返回的会员卡模板ID


body 包体参数

show_bonus  必填 boolean

【是否展示会员积分】会员卡详情页中是否要展示会员积分栏,不填默认false


show_favor  必填 boolean

【是否展示会员优惠】会员卡详情页中是否要展示会员优惠栏,不填默认false


bonus  选填 object

【会员积分】

属性

favor  选填 object

【会员优惠】

属性

show_fapiao  选填 boolean

【是否展示会员发票】会员卡详情页中是否要展示发票栏,不填默认false


fapiao  选填 object

【会员发票】设置发票栏目的文案、跳转小程序

属性

show_guide  选填 boolean

【是否展示会员专属咨询】是否在用户的会员卡详情页展示联系客服信息,不填默认false


guide  选填 object

【会员专属咨询信息】设置商家联系人员的名字、头像和联系方式

属性

请求示例

PATCH

1curl -X PATCH \
2  https://api.mch.weixin.qq.com/v3/marketing/membercard-open/cards/pbLatjvWOibDc5-TBnbUk1pD12o0/rights \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "show_bonus" : false,
8    "show_favor" : false,
9    "bonus" : {
10      "init_bonus" : 0,
11      "bonus_value_word" : "我的积分",
12      "bonus_cost_title" : "积分兑换",
13      "bonus_cost_word" : "500积分=2小时免费停车券",
14      "bonus_jump_word" : "更多礼品",
15      "bonus_jump_appid" : "wxea9c30a90fs8d3fe",
16      "bonus_jump_path" : "/pages/bonus/bonus",
17      "bonus_support_appid" : "wxea9c30a90fs8d3fe",
18      "bonus_support_path" : "pages/selfbonus/selfbonus"
19    },
20    "favor" : {
21      "show_coupon" : true,
22      "member_price_word" : "周二会员全场八折",
23      "member_price_appid" : "wxea9c30a90fs8d3fe",
24      "member_price_path" : "pages/favor/favor",
25      "member_price_title" : "MEMBER_PRICE",
26      "favor_module_title" : "FAVOR"
27    },
28    "show_fapiao" : false,
29    "fapiao" : {
30      "fapiao_jump_word" : "查看我的发票",
31      "fapiao_jump_appid" : "wxea9c30a90fs8d3fe",
32      "fapiao_jump_path" : "pages/fapiao/fapiao"
33    },
34    "show_guide" : false,
35    "guide" : {
36      "staff_name" : "酒店管家-何小明",
37      "head_image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0",
38      "contact_information_name" : "微信号",
39      "contact_information_value" : "weixin123",
40      "phone_number" : "0755-12345677"
41    }
42  }'
43

应答参数

无应答包体

应答示例

204 No Content

1'无应答包体'
2

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

403

NO_AUTH

商户暂无权限使用此功能

请开通商户号权限。请联系产品或商务申请

500

SYSTEM_ERROR

生成二维码链接失败,请重试

系统异常,请使用相同参数稍后重新调用

400

INVALID_REQUEST

扫码投放场景不支持实时code模式

请更换非实时code模式的会员卡再重试

400

INVALID_REQUEST

会员卡的创建商户号不等于调用方商户号

请使用会员卡的创建商户号进行操作

400

INVALID_REQUEST

请先升级会员卡才能使用此功能

请先调用《升级会员卡API》升级会员卡

400

INVALID_REQUEST

AppID非服务号

请使用正确的服务号的AppID重新调用,不支持App、小程序、订阅号。

400

INVALID_REQUEST

会员卡code分配类型不支持修改

会员卡code分配类型为“系统分配”,不支持修改

400

INVALID_REQUEST

会员卡code分配类型不支持修改为“系统分配”

会员卡code分配类型无法修改为“系统分配”。

400

INVALID_REQUEST

储值小程序path为空

请填写储值小程序path

400

INVALID_REQUEST

会员卡ID无效

请检查会员卡ID是否正确填写

400

INVALID_REQUEST

该会员1年内未在本商家有微信支付交易,无法导入

请更换手机号重试

400

INVALID_REQUEST

会员已经领取过该卡

请使用其他会员卡

400

INVALID_REQUEST

会员卡code为实时模式,需要传入卡code

请填入卡code

400

INVALID_REQUEST

积分跳转path为空

请填写积分跳转path

400

INVALID_REQUEST

自助积分跳转path为空

请填写自助积分跳转path

400

INVALID_REQUEST

会员专享价跳转path为空

请填写会员专享价跳转path

400

INVALID_REQUEST

该手机号和会员卡已被导入过

请更换手机号或会员卡ID重试

400

INVALID_REQUEST

该商户号不是会员卡的创建商户号

请使用会员卡的创建商户号进行操作

400

INVALID_REQUEST

手机号未绑定微信号,无法导入

请更换手机号重试

400

INVALID_REQUEST

商户无授权,请重试

请开通商户号权限。请联系产品或商务申请

400

INVALID_REQUEST

该手机号会员卡记录不存在

请更换手机号或会员卡ID重试

400

INVALID_REQUEST

没有符合条件的数据

请使用正确的参数重新调用

400

INVALID_REQUEST

商户号不属于该卡的创建方

请使用会员卡创建方的商户号重新调用

400

INVALID_REQUEST

会员卡已经迁移

会员卡已经迁移,无需重复操作

400

INVALID_REQUEST

会员权益一旦展示无法关闭

会员权益一旦展示无法关闭

400

INVALID_REQUEST

会员储值一旦展示无法关闭

会员储值一旦展示无法关闭

400

INVALID_REQUEST

需要上架至少一个积分权益、优惠权益、服务才可以投放

请先给会员卡上架至少一个积分权益、优惠权益、服务

400

PARAM ERROR

AppID有误

请使用正确的AppID重新调用

400

PARAM ERROR

OpenID有误

请使用正确的OpenID重新调用

400

PARAM ERROR

商户和品牌关系校验失败

请先将商户号绑定到品牌

400

PARAM ERROR

品牌、AppID关系校验失败

请先将AppID绑定到品牌

 

 

反馈
咨询
目录
置顶