设置用户会员权益信息
更新时间：2023.11.28通过此接口商家可设置是否变更后的用户最新积分值，该值会展示在会员卡详页上
# 接口说明
支持商户： 【普通商户】
请求方式： 【PATCH】
请求URL： /v3/marketing/membercard-open/cards/{card_id}/codes/{code}/rights
# 请求参数
- card_id 必填【会员卡ID】 商户创建微信会员卡模板成功后系统返回的会员卡模板ID
- code 必填【会员卡code】 领取会员卡后用户获得的code
Path 路径参数
- before_bonus_value 选填【变更前的用户的积分值】 变更前的用户的积分值
- bonus_value 选填【变更后的会员积分值】 变更后的用户最新积分值，该值会展示在会员卡详页上
- add_bonus_value 选填【会员积分变动值】 本次变更的积分值，等于bonus_value-before_bonus_value，正数表示增加，负数表示减小
- out_request_no 必填【商户请求单号】 商户凭据号。商户自定义，注意保持唯一性，仅供参考的格式：商户ID+日期+流水号。可包含英文字母，数字，｜，_，*，-等内容，不允许出现其他不合法符号。
- need_inform_bonus 选填【是否发送积分变更通知】 积分变更时是否触发系统模板消息，默认为true
- member_price_word 选填【会员专享价文案】 用户会员卡详情页会员优惠栏目中的会员专享价文案
- fapiao_jump_word 选填【发票跳转文案】 发票栏跳转小程序的引导文案
- guide 选填【客服信息】 设置商家联系人员的名字、头像和联系方式
- 属性
Body 包体参数
# 返回参数
处理成功，应答无内容
请求示例
1{2 "before_bonus_value": 500,3 "bonus_value": 600,4 "add_bonus_value": 100,5 "out_request_no": "100002322019090134234sfdf",6 "need_inform_bonus": true,7 "member_price_word": "钻石会员尊享8折",8 "fapiao_jump_word": "3张发票可开",9 "guide": {10 "staff_name": "酒店管家-何小明",11 "head_image_url": "https://wxpaylogo.qpic.cn/wxpaylogo/PiajxSqBRaEIPAeia7Imvtsn7sYGNcEj33YzVvJF88ECQ19LXId8ZL2Q/0",12 "contact_information_name": "微信号",13 "contact_information_value": "weixin123",14 "phone_number": "0755-12345677"15 }16}返回示例
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绑定到品牌 |
文档是否有帮助
