修改会员卡模板信息
更新时间:2023.11.28通过此接口可更新会员卡的信息,包括基本信息、储值信息、开卡信息、补充说明
# 接口说明
支持商户: 【普通服务商】
请求方式: 【GET】
请求URL: /v3/marketing/membercard-open/cards/{card_id}
# 请求参数
- card_id 必填【会员卡模板ID】 商户创建微信会员卡模板成功后系统返回的会员卡模板ID
Path 路径参数
- code_mode 必填【会员卡code分配类型】 1、会员卡code是会员在card_id下唯一身份标识,平台支持3中分配类型:SYSTEM_ALLOCATE 微信支付系统分配,用户领取会员卡时从微信支付系统分配12位数字作为会员code;MERCHANT_DEPOSIT 商户预存code,商户可提前通过导入预存code接口导入code,用户领取会员卡时平台从商户导入的code中随机分配作为会员codeREAL_TIME 商家在激活时实时传入code,该模式仅支持小程序拉起开卡组件投放,不支持通过支付后、二维码投放。2、会员卡code分配模式一旦指定,不支持修改。SYSTEM_ALLOCATE:系统分配MERCHANT_DEPOSIT:商户预存REAL_TIME:实时传入
- code_type 选填【会员码型】 员卡的码型支持二维码/条形码/二维码+条形码/不展示码,这4种码型是根据membershipnumber字段生成,用户领卡后membershipnumber默认为code值,支持商户修改
- appid 选填【商户AppID】 商户的公众号AppID。1、只能为服务号AppID,不支持App、小程序、订阅号的AppID。2、该AppID用于获取会员OpenID及unionid。3、会员相关(会员状态、权益、服务)消息将通过该服务号触达用户4、该AppID需要与会员卡归属品牌有B-A关系
- logo_url 选填【会员卡logo】 会员卡logo的URL地址。仅支持通过《图片上传API》接口获取的图片URL地址。1、商户logo大小需为120像素*120像素。2、支持JPG/JPEG/PNG格式,且图片小于1M。
- title 选填【卡名称】 1.展示在卡面上2.支持最长10个中文字3.支持中文字、英文字符、标点
- background_picture_url 选填【会员卡背景图】 商家自定义会员卡背景图。仅支持通过图片上传API接口获取的图片URL地址。支持JPG/JPEG/PNG格式,且图片小于1M。
- description 选填【使用须知】 展示在会员卡详情内,最长500个中文字符,建议填写会员权益及服务相关描述。
- service_phone 选填【服务电话】 展示在会员卡详情内,建议填写商家固定电话。
- total_quantity 选填【会员卡总库存】 可投放的最大会员卡数量。仅在会员卡code分配类型为系统自动分配(SYSTEM_ALLOCATE)时需要填写,其他分配类型不需要填写库存。系统分配code类型下,若未填写总库存,则微信支付系统会默认将总库存设置为5000000 (默认值)。
- date_information 选填【有效期】 有效期
- 属性
- init_level 选填【会员初始等级】 如果展示会员等级,必填init_level,作为新用户开卡后的初始等级。如因商家业务规则需要变更某会员等级,可通过更新用户会员卡接口更新等级信息
- balance_information 选填【储值信息】 储值信息
- 属性
- user_information_form 选填【开卡信息】 用户在开通会员卡时需要填写的信息
- 属性
- additional_statement 选填【商户补充声明】 商户补充声明
- 属性
- need_dynamic_code 选填【是否启用动态码】 是否启用动态码功能。若启用,用户会员卡的身份识别码会被系统生成的18位数字取替,动态改变,可有效保障用户的储值资产安全,降低用户因被截图带来的储值盗用风险。默认为false
Body 包体参数
# 返回参数
处理成功,应答无内容
请求示例
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": 214 },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": false48}
返回示例
120423处理成功,应答无内容
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
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绑定到品牌 |
文档是否有帮助