修改会员卡模板信息

更新时间：2023.11.28

通过此接口可更新指定用户的会员卡背景图、会员卡号、等级、储值余额

# 接口说明

支持商户： 【普通服务商】

请求方式： 【PATCH】

请求URL： /v3/marketing/membercard-open/cards/{card_id}/codes/{code}

# 请求参数

Path 路径参数

card_id 必填 string(32)

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

code 必填 string(32)

【会员卡code】 会员在一个card_id下的唯一标志，用户领取会员卡后获得的code

Body 包体参数

membership_number 选填 string(32)

【会员卡编号】 在用户会员卡上展示的会员卡编号，如不填写，默认使用会员卡code作为membership_number。只能录入数字／英文／半角标点

background_picture_url 选填 string(32)

【会员卡背景】 商家自定义会员卡背景图。仅支持通过《图片上传API》接口获取的图片URL地址。支持JPG/JPEG/PNG格式，且图片小于1M。

level 选填 string(5)

【用户等级】 用户会员等级

out_request_no 必填 string(32)

【商户请求单号】 商户据号。商户自定义，注意保持唯一性，仅供参考的格式：商户ID+日期+流水号。可包含英文字母，数字，｜，_，*，-等内容，不允许出现其他不合法符号。

balance_information 选填 object

【用户储值变更信息】 用户储值变更信息

属性

need_inform_balance 选填 boolean

【是否发送储值变更通知】 储值变更时是否触发系统模板消息，默认为true

need_inform_level 选填 boolean

【是否发送等级变更通知】 等级变更时是否触发系统模板消息，默认为true

# 返回参数

处理成功，应答无内容

请求示例

1{
2  "appid": "wxea9c30890f48d5ae",
3  "logo_url": "https://wxpaylogo.qpic.cn/wxpaylogo/PiajxSqBRaEIPAeia7Imvtsn7sYGNcEj33YzVvJF88ECQ19LXId8ZL2Q/0",
4  "title": "微信支付测试卡",
5  "background_picture_url": "https://wxpaylogo.qpic.cn/wxpaylogo/PiajxSqBRaEIPAeia7Imvtsn7sYGNcEj33YzVvJF88ECQ19LXId8ZL2Q/0",
6  "description": "使用本会员卡表示你同意xxx公司的协议",
7  "service_phone": "010-8877xxxx",
8  "total_quantity": 5000000,
9  "date_information": {
10    "type": "FIX_TIME_RANGE",
11    "available_end_time": "2030-05-20T13:29:35.120+08:00",
12    "available_day_after_receive": 200,
13    "wait_days_after_receive": 2
14  },
15  "need_display_level": false,
16  "init_level": "白银会员",
17  "balance_information": {
18    "need_balance": false,
19    "balance_appid": "wxea9c30890f48d5ae",
20    "balance_path": "pages/balance/balance",
21    "balance_url": "https://xxx.com"
22  },
23  "user_information_form": {
24    "can_modify_after_activate":false,
25    "common_field_list": [
26    "USER_FORM_FLAG_MOBILE",
27    "USER_FORM_FLAG_SEX"
28  ],
29    "custom_field_list": [
30      {
31        "type": "TEXT",
32        "name": "喜欢的运动",
33        "values": [
34          "篮球",
35          "足球",
36          "羽毛球"
37        ]
38      }
39    ]
40  },
41  "additional_statement": {
42    "title": "xxx会员卡使用须知",
43    "url": "https://xxx.111.com",
44    "appid": "wxea9c30890f48d5ae",
45    "path": "pages/statement/statement"
46  },
47  "need_dynamic_code": false
48}

返回示例

1204
2
3处理成功，应答无内容

# 错误码

# 公共错误码

状态码	错误码	描述	解决方案
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绑定到品牌

文档是否有帮助

商户文档

商户文档中心

更多支持

开发者社区微信开放平台微信公众平台腾讯客服

修改会员卡模板信息

# 接口说明

# 请求参数

# 返回参数

# 错误码

# 公共错误码

# 业务错误码

关于我们

服务支持

友情链接

客服帮助