设置会员服务项用户信息

更新时间：2026.01.13

可根据用户当前的服务状态和信息，调用该接口更新当前用户的会员服务信息：包括展示在会员卡面上的服务信息和服务消息触达

接口说明

适用对象：服务商

请求URL：https://api.mch.weixin.qq.com/v3/marketing/membercard-open/cards/{card_id}/codes/{code}/set-service-module-data

请求方式：POST

path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参

请求参数

参数名

变量

类型[长度限制]

必填

描述

会员卡ID

card_id

string[16, 32]

是

path 商户创建微信会员卡模板成功后系统返回的会员卡模板id
示例值：pbLatjvWOibDc5-TBnbUk1pD12o0

会员卡code

code

string[1, 32]

是

path 领取会员卡后用户获得的code
示例值：478515832665

会员服务项ID

service_module_id

string[1, 9]

是

body 会员服务项的唯一识别ID，创建服务项后由微信支付生成的服务项ID。商户可通过服务项id查询服务项的配置信息及用途。
示例值：666

服务状态设置

state_setting

object

是

body 用户的服务状态设置，这些设置会展示在用户的会员卡详情页。可设置状态的内容字段、按钮、消息内容等

属性

参数名

变量

类型[长度限制]

必填

描述

状态ID

state_id

string[1, 32]

是

状态的id。由微信支付提供，一个服务项通常包含多个状态，商户可根据服务流程选择其中的状态进行设置，模板内容展示在用户的会员卡详情页，并支持通过公众号给用户发送触达消息
示例值：CHECKED_IN

内容模板设置

content_template_data

object

是

用户的服务内容模板设置，这些设置会展示在用户的会员卡详情页。可设置状态的内容字段、按钮等

属性

消息模板设置

message_template_setting

object

否

公众号模板消息设置。部分服务项支持给用户发送触达消息，商户可通过模板id选择模板消息样式，并设置字段值。API调用成功后会通过微信公众号自动给用户发送此模板消息。不填则默认不发消息

属性

商户请求单号

out_request_no

string[8, 128]

是

body 商户凭据号。商户自定义，注意保持唯一性，仅供参考的格式：商户id+日期+流水号）。可包含英文字母，数字，｜，_，*，-等内容，不允许出现其他不合法符号。
建议格式：商户id+日期+流水号
示例值：100002322019090134234sfdf

请求示例

1{
2  "service_module_id": "666",
3  "state_setting": {
4    "state_id": "CHECKED_IN",
5    "content_template_data": {
6      "field_list": {
7        "field_id": "hotel_name",
8        "field_value": "深圳市南山区滨海路700号"
9		},
10      "action_setting": {
11          "action_name": "一键开锁",
12          "jump_miniprogram": {
13            "appid": "wx37178d097a6851d8",
14            "path": "pages/index/index"
15          }
16        }
17      },
18    "message_template_setting": {
19        "message_template_id": "9bJgRNz9XG248XZ-a0nDKH3Vt_vaTp32fRP1LWvxjzI",
20        "field_list": {
21          "field_id": "keyword1",
22          "field_value": "深圳市南山区滨海路700号"
23        }
24      }
25  },
26  "out_request_no": "100002322019090134234sfdf"
27}
28

返回参数

处理成功，应答无内容

返回示例

1 
2204
3处理成功，应答无内容
4

错误码

公共错误码

状态码	错误码	描述	解决方案
403	NO_AUTH	商户暂无权限使用此功能	请开通商户号权限。请联系产品或商务申请
400	INVALID_REQUEST	会员卡已添加该会员服务项	请勿重复添加，如需修改，可调用修改服务项API
	INVALID_REQUEST	该服务状态不在会员服务项模板中	请更换状态id重试
	INVALID_REQUEST	消息模板字段值部分为空，请检查	消息模板字段值部分为空，请检查
	INVALID_REQUEST	消息模板id错误	消息模板id错误，请检查
	INVALID_REQUEST	内容字段不在当前会员服务项模板中	请检查输入的内容字段
	INVALID_REQUEST	会员卡暂未添加该会员服务项，无法设置用户服务信息	请先添加该服务项
	INVALID_REQUEST	该会员服务项id不存在	请检查输入的服务项id
	INVALID_REQUEST	当前品牌id无该会员服务项的使用权限	请联系产品或商务申请开通权限
400	PARAM ERROR	设置会员服务参数错误	请使用正确的参数重新调用

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服