微信会员卡
微信会员卡按会员卡类别配置微信卡包里的电子卡面:卡品牌、卡颜色、条码类型、积分与抵扣规则、卡包入口开关,一张会员卡类别对应一份微信卡配置。它管的是「微信侧这张电子卡长什么样、按什么规则用」,不是实体卡档案——实体卡的余额、积分、流水和微信绑定关系在 会员卡 页逐卡管理。
一、功能概述
菜单位置:O2O业务 → 微信会员 → 微信会员卡(页面地址 /admin/o2o/viptypeweixin/)

| 用途 | 说明 |
|---|---|
| 配微信卡面 | 按会员卡类别配卡品牌、颜色、条码类型、Logo 与背景图 |
| 定积分与抵扣 | 消费积分、积分抵现、折让比例、充值使用规则 |
| 配卡包入口 | 支持积分 / 储值、在线充值、在线商城、支付按钮、礼券信息等开关 |
| 接商城小程序 | 商城小程序与小程序密钥 |
| 追溯微信对接 | 微信卡券ID 只读展示,核对是否已推送微信 |
与实体卡管理的分工
| 页面 | 管什么 |
|---|---|
| 本页(微信会员卡) | 类别级微信卡面模板与规则,一张会员卡类别一份配置 |
| 会员卡 | 逐卡视图:余额、积分、流水、资料,以及解除微信绑定等卡务操作 |
| 会员卡系列 | 系列总开关:是否微信会员卡、微信会员卡Id |
顾客在小程序侧领卡后,微信卡号与 ERP 会员卡号的对应记录(申领时间、投放分店、投放人员)可在 二维码投放分析 查询;某张卡要解除微信绑定,到会员卡页操作。领卡与绑定的具体流程以小程序侧为准,本页只维护卡面配置。
卡券推送到微信平台(更新到微信服务器)、投放二维码生成、卡券预览本版网页端未提供,在客户端完成,见客户端微信会员卡设置与投放。
二、界面布局说明
页面是「列表 + 编辑窗体」结构。
列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、打印 |
| 搜索框 | 按卡品牌、微信卡券ID 模糊搜索,回车后表格刷新并回到第 1 页 |
| 列表 | 会员卡类别、卡品牌、卡颜色、卡条码类型、允许在线充值、显示微信支付按钮、显示会员卡支付按钮、微信卡券ID;会员卡类别与卡品牌两列冻结,默认按会员卡类别排序 |
| 分页 | 「共 N 条」「共 N 页」+ 页码,每页可选 10 / 20 / 30 / 50 / 100 / 200 条(默认 20 条/页) |
会员卡类别是链接,点击打开该类别的微信卡配置编辑窗体。
编辑窗体
字段分五组:基础信息、积分与抵扣、入口与小程序、功能开关、微信对接。顶部按钮有 返回、编辑、保存(下拉含 保存并继续编辑 / 保存并新增下一个 / 保存并返回列表)、取消、刷新、上一行、下一行。新增保存后会员卡类别编号只读,不能修改。
三、业务操作步骤
步骤 1:新增微信卡配置
- 确认目标会员卡类别已在会员编码里建好(见 会员卡类型),系列已打开微信开关(见 会员卡系列);
- 点工具栏 新增,在 基础信息 填卡品牌(必填)、选卡条码类型与卡颜色,填条码界面提示、服务电话、卡描述、会员特权说明;
- 按需填 积分与抵扣、入口与小程序,打开 功能开关 里需要的开关;
- 点 保存,系统自动分配编号,列表出现新行。
保存后请核对编号:会员卡类别ID 对应会员卡类别的编号(界面提示原文「对应 VipSerial.fVipSerialID,一张会员卡类别一份微信卡配置」),而网页版新增时编号由系统发号。保存后到列表核对该记录的会员卡类别与目标类别是否一致;需要与既有类别精确对应时,可在客户端微信会员卡窗口按系列维护。
步骤 2:修改卡面与规则
- 在列表点目标记录的 会员卡类别;
- 点 编辑 进入编辑态,修改字段后点 保存;
- 会员卡类别编号与微信卡券ID 始终只读。
卡面修改后需重新推送到微信平台才会在顾客卡包侧生效,推送在客户端完成。
步骤 3:推送与投放(客户端)
网页版本版不提供「更新到微信服务器」推送和投放二维码生成。配置完成后到客户端微信会员卡窗口推送卡券、生成绑分店与导购员的投放二维码,顾客扫码领卡;领卡结果回本页关联的申领记录,用 二维码投放分析 查看。
四、字段详细说明
1)基础信息
| 字段名 | 含义 |
|---|---|
| 会员卡类别ID | 对应会员卡类别编号,一张会员卡类别一份微信卡配置;必填,新增保存后只读 |
| 默认卡类别 | 扫码开卡时默认归入的会员卡类别编号 |
| 卡品牌 | 品牌名称,必填,最长 30 字;为空保存时提示「卡品牌不能为空」 |
| 卡条码类型 | 卡包内条码形态,见枚举表 |
| 卡颜色 | 微信卡券背景色代码,见枚举表 |
| 条码界面提示 | 条码下方提示文字,最长 50 字 |
| 服务电话 | 卡面客服电话,最长 20 字 |
| 卡描述 | 卡面描述,最长 100 字 |
| 会员特权说明 | 多行文本,说明会员特权 |
2)积分与抵扣
| 字段名 | 含义 |
|---|---|
| 每消费金额 | 积分规则的消费金额基数 |
| 获得积分 | 每消费一个基数获得的积分 |
| 使用积分 | 抵扣规则:多少积分起抵 |
| 抵扣金额 | 对应使用积分可抵的金额 |
| 订单满额可用 | 订单达到该金额才允许积分抵扣 |
| 单笔上限积分 | 单笔订单最多可使用的积分 |
| 折让比例% | 持卡消费折让比例 |
| 充值使用规则 | 充值与使用说明文字,最长 300 字 |
3)入口与小程序
| 字段名 | 含义 |
|---|---|
| 卡片Logo | 卡面 Logo 图片地址,最长 300 字符,填可访问的图片 Url |
| 背景图片Url | 卡面背景图地址,最长 300 字符 |
| 商城小程序 | 关联的商城小程序标识,最长 50 字符 |
| 小程序密钥 | 商城小程序对接密钥,最长 100 字符。属敏感凭据,仅由授权人员维护,不要外泄或写入文档、截图 |
图片文件在 微信图片资料管理 维护,本页只填图片地址。
4)功能开关
| 字段名 | 含义 |
|---|---|
| 支持积分 | 卡是否支持积分 |
| 支持储值 | 卡是否支持储值 |
| 允许在线充值 | 是否允许微信端在线充值 |
| 显示微信支付按钮 | 卡包内是否显示微信支付入口 |
| 显示在线商城 | 卡包内是否显示在线商城入口 |
| 显示会员卡支付按钮 | 卡包内是否显示会员卡支付入口 |
| 动态显示卡条码/二维码 | 卡条码/二维码是否动态刷新 |
| 显示礼券信息 | 卡包内是否显示礼券信息 |
| 卡包首页显示动态支付码 | 卡包首页是否显示动态支付码 |
| 自动激活 | 领卡后是否自动激活 |
| 自动发送微信消息 | 是否自动发送微信消息 |
5)微信对接
| 字段名 | 含义 |
|---|---|
| 微信卡券ID | 只读,最长 40 字符。推送微信平台后回写;为空说明尚未推送。本版网页端未提供推送按钮 |
6)枚举值说明
卡条码类型:
| 取值 | 含义 |
|---|---|
| 文本 | 卡包内以文本显示卡号 |
| 一维码 | 显示一维条码 |
| 二维码 | 显示二维码 |
卡颜色(显示值即代码,共 14 项):
| 取值 |
|---|
| Color010、Color020、Color030、Color040、Color050、Color060、Color070、Color080、Color081、Color082、Color090、Color100、Color101、Color102 |
颜色代码对应微信卡券背景色,具体色值以微信卡券接口文档为准。
五、典型使用场景
场景 1:新系列接入微信卡包
背景:新开的会员卡系列要进微信卡包。 操作:会员卡系列打开是否微信会员卡、填微信会员卡Id → 本页新增该类别的微信卡配置,配卡面与规则 → 客户端推送卡券、生成投放二维码 → 顾客领卡后在 二维码投放分析 核对申领记录。
场景 2:调整积分抵现规则
背景:积分抵现比例要下调。 操作:列表搜卡品牌 → 打开编辑 → 改 积分与抵扣 组的使用积分、抵扣金额、订单满额可用 → 保存 → 客户端重新推送微信。
场景 3:换卡面形象
背景:品牌升级,换 Logo 与背景色。 操作:打开编辑 → 改卡片Logo、背景图片Url、卡颜色 → 保存 → 客户端重新推送,顾客卡包侧更新。
六、权限控制与前置条件
- 本页无独立 ERP 菜单权限映射项(Django 新增页面),有页面访问权限即可操作;菜单可见性跟随 O2O业务 分组,看不到分组时联系实施人员确认模块是否开通。
- 前置条件:会员卡类别已建好(会员卡类型),系列微信开关已打开(会员卡系列);卡面图片先备好可访问的 Url。
- 小程序密钥属敏感凭据,仅由授权人员维护。
- 配置要在顾客卡包生效,还需客户端完成卡券推送;投放二维码也在客户端生成。
七、常见问题
1. 保存时提示「卡品牌不能为空」
- 原因:卡品牌是必填名称字段;
- 处理:在基础信息组补填卡品牌再保存。
2. 微信卡券ID 一直是空的
- 原因:该类别的微信卡配置尚未推送到微信平台,本页不提供推送按钮;
- 处理:到客户端微信会员卡窗口执行「更新到微信服务器」,回写后本页只读展示。
3. 新增记录的类别编号与目标类别对不上
- 原因:网页版新增时编号由系统发号,不一定等于既有会员卡类别的编号;
- 处理:保存后核对列表的会员卡类别;需要与既有类别精确对应时,在客户端微信会员卡窗口按系列维护。
4. 改了卡面,顾客卡包里没变化
- 原因:本页只改 ERP 侧配置,微信侧卡面要重新推送才更新;
- 处理:在客户端重新推送,再让顾客刷新卡包查看。
5. 想解绑某张卡的微信会员身份
- 原因:本页是类别级配置,不做逐卡操作;
- 处理:到 会员卡 页找到该卡,用「解除微信绑定」;停用并取消微信会员走会员卡状态修改单。
附:本文档变更记录
| 日期 | 变更 |
|---|---|
| 2026-11-18 | 初稿 |
