添加会员卡服务项

更新时间：2026.01.13

在会员卡模板上添加并展示某个会员服务项，指定添加服务项id后会在会员卡上展示对应的会员服务

接口说明

适用对象：直连商户

请求URL：https://api.mch.weixin.qq.com/v3/marketing/membercard-open/cards/{card_id}/service-modules

请求方式：POST

path 指该参数为路径参数

query 指该参数为URL参数

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

请求参数

参数名

变量

类型[长度限制]

必填

描述

会员卡ID

card_id

string[16, 32]

是

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

会员服务项ID

service_module_id

string[1, 9]

是

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

跳转小程序

jump_miniprogram

object

否

body 服务项指定跳转小程序。用户可在会员卡详情页中点击当前服务项，跳转到商家配置的小程序
填写时，服务项的cell可点击跳转，否则不能跳转

属性

请求示例

1{
2  "service_module_id": "666",
3  "jump_miniprogram": {
4    "appid": "wx37178d097a6851d8",
5    "path": "pages/index/index"
6  }
7}

返回参数

参数名

变量

类型[长度限制]

必填

描述

会员卡ID

card_id

string[16, 32]

是

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

会员服务项ID

service_module_id

string[1, 9]

是

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

跳转小程序

jump_miniprogram

object

否

服务项指定跳转小程序。用户可在会员卡详情页中点击当前服务项，跳转到商家配置的小程序
请求时无传jump_miniprogram，则无jump_miniprogram字段返回

属性

返回示例

1{
2  "card_id": "pbLatjvWOibDc5-TBnbUk1pD12o0",
3  "service_module_id": "666",
4  "jump_miniprogram": {
5    "appid": "wx37178d097a6851d8",
6    "path": "pages/index/index"
7  }
8}

错误码

公共错误码

状态码	错误码	描述	解决方案
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版)开发者社区微信开放平台微信公众平台腾讯客服