设置会员服务项用户信息
更新时间：2026.01.13||
可根据用户当前的服务状态和信息，调用该接口更新当前用户的会员服务信息：包括展示在会员卡面上的服务信息和服务消息触达
接口说明
适用对象：服务商
请求URL：https://api.mch.weixin.qq.com/v3/marketing/membercard-open/cards/{card_id}/codes/{code}/set-service-module-data
请求方式：POST
请求参数
|
会员卡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 | 是 | 用户的服务内容模板设置，这些设置会展示在用户的会员卡详情页。可设置状态的内容字段、按钮等 | | 属性 | | |
服务内容列表 | field_list | array | 是 | 服务内容列表，最多包含5条内容 | | 属性 | | |
内容字段ID | field_id | string[1, 32] | 是 | 当前服务状态下，可以设置的内容字段id
示例值：hotel_name | 内容字段值 | field_value | string[1, 256] | 是 | 服务状态字段的值
示例值：深圳市南山区滨海路700号 |
|
| 操作设置 | action_setting | object | 否 | 服务状态对应的操作设置，可配置跳转文案和跳转小程序路径。
需配置跳转文案及跳转小程序路径时必填 | | 属性 | | |
操作名称 | action_name | string[1, 6] | 是 | 操作名称
示例值：一键开锁 | 跳转小程序 | jump_miniprogram | object | 是 | 服务状态指定跳转小程序 | | 属性 | | |
小程序appid | appid | string[1, 32] | 是 | 小程序的appid
示例值：wx37178d097a6851d8 | 小程序path | path | string[1, 128] | 是 | 小程序的页面path
示例值：pages/index/index |
|
|
|
|
|
| 消息模板设置 | message_template_setting | object | 否 | 公众号模板消息设置。部分服务项支持给用户发送触达消息，商户可通过模板id选择模板消息样式，并设置字段值。API调用成功后会通过微信公众号自动给用户发送此模板消息。不填则默认不发消息 | | 属性 | | |
模板消息ID | message_template_id | string[16, 64] | 是 | 公众号模板消息的id
示例值：9bJgRNz9XG248XZ-a0nDKH3Vt_vaTp32fRP1LWvxjzI | 模板消息字段列表 | field_list | array | 是 | 模板消息字段列表。商户在此设置模板消息每个字段需展示的内容
特殊规则：限制最多可提交9条 | | 属性 | | |
消息字段ID | field_id | string[1, 16] | 是 | 公众号模板消息字段id，相当于字段的id
示例值：keyword1 | 消息字段的值 | field_value | string[1, 256] | 是 | 公众号模板消息字段的值，会作为消息内容展示给用户
示例值：深圳市南山区滨海路700号 |
|
|
|
|
|
|
商户请求单号 | 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 | 设置会员服务参数错误 | 请使用正确的参数重新调用 |
