Skip to content

微信会员卡 ​

微信会员卡按会员卡类别配置微信卡包里的电子卡面:卡品牌、卡颜色、条码类型、积分与抵扣规则、卡包入口开关,一张会员卡类别对应一份微信卡配置。它管的是「微信侧这张电子卡长什么样、按什么规则用」,不是实体卡档案——实体卡的余额、积分、流水和微信绑定关系在 会员卡 页逐卡管理。

一、功能概述 ​

菜单位置:O2O业务 → 微信会员 → 微信会员卡(页面地址 /admin/o2o/viptypeweixin/)

微信会员卡列表:表格列为会员卡类别、卡品牌、卡颜色、卡条码类型、允许在线充值、显示微信支付按钮、显示会员卡支付按钮、微信卡券ID

用途说明
配微信卡面按会员卡类别配卡品牌、颜色、条码类型、Logo 与背景图
定积分与抵扣消费积分、积分抵现、折让比例、充值使用规则
配卡包入口支持积分 / 储值、在线充值、在线商城、支付按钮、礼券信息等开关
接商城小程序商城小程序与小程序密钥
追溯微信对接微信卡券ID 只读展示,核对是否已推送微信

与实体卡管理的分工 ​

页面管什么
本页(微信会员卡)类别级微信卡面模板与规则,一张会员卡类别一份配置
会员卡逐卡视图:余额、积分、流水、资料,以及解除微信绑定等卡务操作
会员卡系列系列总开关:是否微信会员卡、微信会员卡Id

顾客在小程序侧领卡后,微信卡号与 ERP 会员卡号的对应记录(申领时间、投放分店、投放人员)可在 二维码投放分析 查询;某张卡要解除微信绑定,到会员卡页操作。领卡与绑定的具体流程以小程序侧为准,本页只维护卡面配置。

卡券推送到微信平台(更新到微信服务器)、投放二维码生成、卡券预览本版网页端未提供,在客户端完成,见客户端微信会员卡设置与投放。

二、界面布局说明 ​

页面是「列表 + 编辑窗体」结构。

列表页 ​

区域内容
工具栏新增、导出、打印
搜索框按卡品牌、微信卡券ID 模糊搜索,回车后表格刷新并回到第 1 页
列表会员卡类别、卡品牌、卡颜色、卡条码类型、允许在线充值、显示微信支付按钮、显示会员卡支付按钮、微信卡券ID;会员卡类别与卡品牌两列冻结,默认按会员卡类别排序
分页「共 N 条」「共 N 页」+ 页码,每页可选 10 / 20 / 30 / 50 / 100 / 200 条(默认 20 条/页)

会员卡类别是链接,点击打开该类别的微信卡配置编辑窗体。

编辑窗体 ​

字段分五组:基础信息、积分与抵扣、入口与小程序、功能开关、微信对接。顶部按钮有 返回、编辑、保存(下拉含 保存并继续编辑 / 保存并新增下一个 / 保存并返回列表)、取消、刷新、上一行、下一行。新增保存后会员卡类别编号只读,不能修改。

三、业务操作步骤 ​

步骤 1:新增微信卡配置 ​

  1. 确认目标会员卡类别已在会员编码里建好(见 会员卡类型),系列已打开微信开关(见 会员卡系列);
  2. 点工具栏 新增,在 基础信息 填卡品牌(必填)、选卡条码类型与卡颜色,填条码界面提示、服务电话、卡描述、会员特权说明;
  3. 按需填 积分与抵扣、入口与小程序,打开 功能开关 里需要的开关;
  4. 点 保存,系统自动分配编号,列表出现新行。

保存后请核对编号:会员卡类别ID 对应会员卡类别的编号(界面提示原文「对应 VipSerial.fVipSerialID,一张会员卡类别一份微信卡配置」),而网页版新增时编号由系统发号。保存后到列表核对该记录的会员卡类别与目标类别是否一致;需要与既有类别精确对应时,可在客户端微信会员卡窗口按系列维护。

步骤 2:修改卡面与规则 ​

  1. 在列表点目标记录的 会员卡类别;
  2. 点 编辑 进入编辑态,修改字段后点 保存;
  3. 会员卡类别编号与微信卡券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初稿