产品介绍

更新时间：2026.10.15

||| 安装 Skill

1、产品概述

商家名片会员是商家名片的功能之一，在接入前需先申请开通商家名片功能。

商家名片会员是微信支付为商家提供的会员经营工具，提供联动微信支付下单的会员资产变动感知，拉动入会，跳转商家小程序会员相关页面，发放会员券的能力，结合微信生态能力向品牌商家提供更丰富的会员解决方案，帮助商家提升会员运营效率。

2、产品功能

2.1、基础会员容器

商家可通过开通会员卡模版，获取会员卡模版id，用于后续的会员经营活动。该会员卡模版将在微信支付商家名片上进行展示。

商家仅需传入会员卡名称、小程序AppId、会员中心小程序跳转path等信息，即可创建一个会员卡模版；其余信息均为选填信息。

会员卡展示的内容以商家在创建会员卡模板接口中的配置为准，未配置的信息不展示：

展示信息	对应配置	说明
卡名称	`card_title`	必填
卡面背景	`card_picture_url`（卡图片）、`card_color`（卡背景颜色）	未传卡图片时，以卡背景颜色纯色展示卡面；卡背景颜色不传时默认为 `#FFFFFF`
会员等级	`need_display_level`、`init_level`	默认不展示。开启展示后，新开卡用户展示初始等级；用户的会员等级可通过修改用户会员卡信息接口，或在下单同步用户实时动态时更新
积分	`points_information`	不配置时不展示
会员码	`code_type`	默认不展示任何码型
卡片有效期	`valid_date_information`	默认永久有效

已入会的会员可查看会员的基础信息（卡名称、会员信息、会员等级、卡积分、会员码）及可用的券。针对卡面、积分、会员码都支持配置跳转商家小程序自身页面（创建会员卡模板接口中指定）。
支持与不支持用户主动入会的会员卡，展示内容的规则一致；区别仅在于用户未入会时：支持用户主动入会的会员卡展示入会入口，不支持用户主动入会的会员卡不展示入会入口，用户点击卡面跳转商家小程序（详见 2.3「入会模式」）。
多张会员卡的展示顺序：同一品牌下存在多张生效中的会员卡时，置顶会员卡（need_pinned 为 true）优先展示，多张置顶卡按更新时间倒序排序；其余会员卡按创建时间倒序排序。

*进入商家名片的渠道

支付凭证跳转商家名片（需联系微信支付运营申请开通）：用户交易后，微信支付下发「支付凭证」，用户点击支付凭证即可跳转商家名片

2.2、会员动态

会员卡动态是针对积分的变更信息，平台提供消息赋能，提供给商家告知用户的运营能力。
比如用户支付了一笔订单，对应某一张会员卡积分增加400，并可兑换礼品。这类信息可以通过会员卡动态传递给用户。
动态分为实时动态和异步动态。
- 会员支付实时动态：商家在调用微信支付下单接口时同步传入用户的会员实时动态，用户完成支付后，微信支付将在「支付凭证」中向用户展示本次支付相关的会员信息变动，并联动在商家名片会员卡卡面展示，让用户在支付时即可感知会员身份与会员资产变化。详见下单同步用户实时动态能力
- 异步动态将不会联动支付凭证等渠道展示。仅会展示在会员卡卡面上。详见创建用户动态信息接口

会员支付：实时动态通过下单同步用户实时动态能力实现	异步动态通过创建用户动态信息接口实现

2.3、新用户入会

用户手机号作为用户开卡的必填信息，其他平台提供的通用开卡信息（如：性别、生日、地址、邮箱、城市）都是非必需的，商家可依据自身的经营情况合理使用（如需用户提供，在创建会员卡模板接口中指定即可）

2.3.1、入会模式

商家在创建会员卡模板时，可通过「是否支持用户主动入会」（support_user_active_join）字段设置会员卡的入会模式，不传时默认为 true。

对比项	支持用户主动入会（`true`）	不支持用户主动入会（`false`）
用户开通方式	用户可通过商家名片、支付相关入会入口，以及商家小程序或 H5 的入会组件填写开卡信息并开通；商家也可通过导入等方式为用户开通	用户不能在微信支付内主动开通，只能由商家通过导入等方式开通（见 2.4）
商家名片展示	用户未入会时展示入会入口；已入会时展示会员卡信息	不展示入会入口，直接展示会员卡；用户点击卡面跳转商家小程序
创建模板时额外必填	会员权益（`benefits`）、回调地址（`notify_url`）、商家法务协议（`legal_agreement`）	无需填写上述字段
开卡结果同步	需同步会员开通结果（见 3.1）	不涉及
适用场景	有独立入会诉求的会员卡，如以线下门店为主的零售会员卡	以商家小程序为中心的会员卡，如线上、餐饮类会员卡；付费会员卡

注意：

support_user_active_join 为 true 时，若未填写会员权益、回调地址、商家法务协议，接口将返回错误。若不需要用户在微信支付内主动开通，请将该字段设为 false。
两种模式下，会员中心信息（member_information）均为必填，用户点击会员卡卡面将跳转至该页面。
付费会员卡（purchase_membership 为 true）暂不支持用户主动入会，请将 support_user_active_join 设为 false，详见 2.6。

2.3.2、用户主动入会方式

商家名片入会

商家开通商家名片功能后，即可创建会员卡模板。存在生效中的会员卡模板时，商家名片将展示该会员卡：

支持用户主动入会的会员卡：用户未入会时展示入会组件，用户可在商家名片内完成入会；
不支持用户主动入会的会员卡：不展示入会入口，直接展示会员卡，用户点击卡面进入商家小程序的会员中心页面，由商家小程序承接入会及会员服务。

进入商家名片的渠道

支付凭证跳转商家名片（需联系微信支付运营申请开通）：用户交易后，微信支付下发「支付凭证」，用户点击支付凭证即可跳转商家名片
「摇优惠」入口跳转商家名片：通过「微信支付号」底部「摇优惠」入口进入「喜欢的商家」列表，点击具体的商家，即可跳转「商家名片」

注意：

商家名片中默认有‘优惠’入口，当商家有一张生效中的会员卡模板时，‘优惠’入口会升级为‘会员’入口。

商家小程序/H5入会

商户可在自身小程序或H5页面（公众号），通过微信支付提供的入会组件引导用户完成入会流程。

商家在小程序/H5入会组件引导用户开通会员	会员开通成功后会通知用户	用户可以通过会员开通成功通知，进入商家名片主页

注意：

入会组件仅适用于支持用户主动入会（support_user_active_join 为 true）的会员卡。

入会有礼活动入会

商家可通过入会有礼活动在商家名片、支付凭证cell、支付完成页引导用户入会，提高用户入会的转化率（配置入会有礼活动请联系微信支付运营）。
入会有礼支持商家配置多张商品券（最多6张），作为入会有礼的礼品，将在用户入会成功后直接发放给用户。用户可在商家名片-会员中查看并使用。

注意

商家在微信支付下单接口传入对应的信息且当前有关联的入会有礼活动，支付凭证cell才会展示入会入口。详见下单同步用户实时动态能力
入会有礼活动仅适用于支持用户主动入会的会员卡。

2.4、存量会员导入

针对商家侧的存量会员，可通过OPENID导入、下单同步入会两种方式将存量会员导入至商家名片

OPENID导入：商家可通过用户在微信公众号/小程序内的OPENID，将存量会员通过根据OPENID导入用户会员卡接口导入至微信支付的商家名片。
下单同步入会：商家可通过在微信支付下单接口的attach字段传入会员卡code（ user_card_code）来导入未开通会员的用户。下单用户若此前未开通会员卡，通过此方式可实时添加会员并自动生效一张会员卡，详细指引请参考：实时动态传入的方式

2.5、会员码拉起微信支付付款码（暂不开放）

为提升线下用户的支付体验，微信侧提供从商家小程序会员码页面直接拉起微信支付付款码的能力（需联系微信支付运营申请开通）。

注意

需在创建会员卡模板时「code_type」字段需要指定为JUMP_MINI_PROGRAM: 跳转商家小程序。

2.6、付费会员（暂不开放）

付费会员是平台提供给商家的运营能力，通过该功能，商家可将其自有业务的付费会员体系与平台的运营能力实现对接，从而更高效地开展付费会员的管理与运营工作。
商家可在创建会员卡模板时，将「是否为付费会员」（purchase_membership）设为 true，标记该会员卡为付费会员。该字段仅作标记，设为 true 时不要求填写付费会员价格和跳转信息。
用户并不在平台页面付费，平台仅负责将开通的信息传递给用户，实际付费操作在商家的小程序内完成。

2.7、名片会员-积分兑券能力

商家名片会员-积分兑券能力，是微信支付给到已经接入商家名片会员的商家（创建过至少一张会员卡），提供的通过支付后流量运营品牌核心用户的能力。

2.7.1、完整流程概览

接入积分兑券的用户体验	没接入积分兑券的用户体验

2.7.2、积分兑券主流程

2.7.3、积分兑券异常流程

3、注意事项

3.1、在商家名片入会后需同步平台开通状态

本节仅适用于支持用户主动入会（support_user_active_join 为 true）的会员卡；不支持用户主动入会的会员卡不涉及该流程。

为了保证仅入会的会员才能享受到权益-如入会有礼，积分变化同步。用户在平台提供的页面中点击入会按钮后，平台会同步商家，商家此时需要在自身的CRM系统里面也为该用户创建会员卡，创建成功后通过同步会员开通结果接口通知平台，此时平台才会将会员卡的状态扭转为激活。

注意：

如果不及时同步将导致用户在名片会员入会失败，与商家系统会员状态存在不一致。

3.2、存量会员导入到商家名片的方式

模块	渠道	备注
商家CRM系统存量会员数据	批量导入（根据OPENID导入用户会员卡）	针对存量会员，商家可通过用户在微信公众号/小程序内的OpenID，将存量会员通过接口导入至商家名片
商家CRM系统存量会员数据	下单同步用户实时动态	如果商家已经创建了一张会员卡模板ID，某一个用户还没有领取这张会员卡，微信支付下单接口内也可使用下单同步用户实时动态的能力同步传入该cardID
微信支付存量会员数据	会员卡1.0接口会员关系	针对存量接过卡包会员能力的商家，平台可在商家申请后，提供能力协助商家将已有的用户会员卡关系导入给商家名片会员中继承（具体方式请联系微信支付运营）。
微信支付存量会员数据	会员卡2.0接口会员关系

3.3、用户主动删除会员卡

为了避免商户导入无效会员卡，影响用户体验。用户可以主动删除在名片内的某一张会员卡，删除后平台将通过会员卡事件通知接口将删除信息同步商家。

注意

不支持用户主动入会、且未配置回调地址（notify_url）的会员卡，用户删除会员卡后，平台暂无法将删除信息同步给商家。

3.4、会员卡状态说明

文档是否有帮助

LLM请查看llms.txt

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