Skip to content

微信礼品卡 ​

微信礼品卡是微信端售卖的储值卡、兑换卡的卡面模板:一张卡在这里定义标题、品牌、面额、有效期、积分与抵扣规则,以及微信卡包里的入口开关。卡模板建好后挂到微信礼品卡货架上售卖,顾客在小程序购买或转赠,售出订单在微信礼品卡订单查询里追溯。

一、功能概述 ​

菜单位置:O2O业务 → 微信礼品卡 → 微信礼品卡(页面地址 /admin/o2o/wxgeneralcard/)

微信礼品卡列表:表格列为礼品卡ID、卡标题、卡品牌、面额、卡颜色、有效期类型、动态显示卡条码/二维码、微信卡券ID

用途说明
定义卡面卡标题、卡品牌、卡颜色、条码类型、Logo 与背景图
定面额与有效期面额、固定区间或领取后生效的有效期规则
定积分与抵扣消费积分、积分抵现、折让比例、充值使用规则
配卡包入口支持积分 / 储值、在线充值、在线商城、支付按钮等开关
追溯微信对接微信卡券ID 只读展示,核对卡模板是否已推送微信

本页管的是「卡长什么样、按什么规则用」,不管逐张卡的发放与余额。卡券推送到微信平台、自定义卡号上传等操作本版网页端未提供,在客户端完成,见客户端微信礼品卡。

二、界面布局说明 ​

页面是「列表 + 编辑窗体」结构:列表定位卡模板,点卡标题打开编辑窗体,字段按五个分组排列。

列表页 ​

区域内容
工具栏新增、导出、打印
搜索框按卡标题、卡品牌、微信卡券ID 模糊搜索,回车后表格刷新并回到第 1 页
列表礼品卡ID、卡标题、卡品牌、面额、卡颜色、有效期类型、动态显示卡条码/二维码、微信卡券ID;礼品卡ID 与卡标题两列冻结,默认按礼品卡ID 排序
分页「共 N 条」「共 N 页」+ 页码,每页可选 10 / 20 / 30 / 50 / 100 / 200 条(默认 20 条/页)

卡标题是链接,点击打开这张卡的编辑窗体。

编辑窗体 ​

字段分五组:基础信息、有效期、积分与抵扣、入口与开关、微信对接。顶部按钮有 返回、编辑、保存(下拉含 保存并继续编辑 / 保存并新增下一个 / 保存并返回列表)、取消、刷新、上一行、下一行。新增时礼品卡ID 由系统在保存时自动发号,保存后编号只读,不能修改。

三、业务操作步骤 ​

步骤 1:新增卡模板 ​

  1. 点工具栏 新增,打开空白编辑窗体;
  2. 在 基础信息 填卡标题、卡品牌,选卡条码类型与卡颜色,填面额(两位小数);
  3. 在 有效期 选有效期类型,按类型填固定区间或天数;
  4. 按需填 积分与抵扣、打开 入口与开关 里需要的开关;
  5. 点 保存。系统自动分配礼品卡ID,窗体提示保存成功,列表出现新行。

步骤 2:修改卡模板 ​

  1. 在列表点目标卡的 卡标题;
  2. 点 编辑 进入编辑态,修改字段后点 保存;
  3. 礼品卡ID 与微信卡券ID 始终只读,改不了。

卡面规则修改后,需要重新推送到微信平台才会在顾客卡包侧生效;推送操作在客户端完成。

步骤 3:删除的限制 ​

已上传自定义卡号的卡模板不允许删除,删除时系统提示:

号码已经上传不能删除!

这类卡改为停止投放即可,不要强行删除。

四、字段详细说明 ​

1)基础信息 ​

字段名含义
礼品卡ID卡模板唯一编号,新增保存时系统自动发号,保存后只读
卡标题卡面名称,必填,最长 30 字;为空保存时提示「卡标题不能为空」
卡品牌品牌名称,最长 30 字
卡条码类型卡包内条码形态,见枚举表
卡颜色微信卡券背景色代码,见枚举表
面额卡面值,金额两位小数
条码界面提示条码下方提示文字,最长 50 字
服务电话卡面客服电话,最长 20 字
卡描述卡面描述,最长 100 字
特权说明多行文本,说明持卡特权

2)有效期 ​

字段名含义
有效期类型界面提示原文「微信 date_info.type:固定区间/领取后生效」,按微信卡券接口口径取值,具体数值对照以微信卡券文档为准
有效期开始 / 有效期结束固定区间方式下的起止时间
固定有效天数固定区间方式下的有效天数
领取后生效天数领取后生效方式下,自领取起算的天数
使用自定义卡号开关。开启后该卡使用预先上传的自定义卡号;卡号上传本版网页端未提供,在客户端维护

3)积分与抵扣 ​

字段名含义
每消费金额积分规则的消费金额基数
获得积分每消费一个基数获得的积分
使用积分抵扣规则:多少积分起抵
抵扣金额对应使用积分可抵的金额
订单满额可用订单达到该金额才允许积分抵扣
单笔上限积分单笔订单最多可使用的积分
折让比例%持卡消费折让比例
充值使用规则充值与使用说明文字,最长 300 字

4)入口与开关 ​

字段名含义
卡片Logo卡面 Logo 图片地址,最长 300 字符,填可访问的图片 Url
背景图片Url卡面背景图地址,最长 300 字符
支持积分开关,卡是否支持积分
支持储值开关,卡是否支持储值
允许在线充值开关,是否允许微信端在线充值
显示微信支付按钮开关,卡包内是否显示微信支付入口
显示在线商城开关,卡包内是否显示在线商城入口
显示会员卡支付按钮开关,卡包内是否显示会员卡支付入口
动态显示卡条码/二维码开关,卡条码/二维码是否动态刷新
自动发送微信消息开关,是否自动发送微信消息

图片文件本身在 微信图片资料管理 维护,本页只填图片地址;本版网页端不提供卡面图片上传。

5)微信对接 ​

字段名含义
微信卡券ID只读,最长 40 字符。推送微信平台后回写;为空说明尚未推送。本版网页端未提供推送按钮,推送在客户端完成

6)枚举值说明 ​

卡条码类型:

取值含义
文本卡包内以文本显示卡号
一维码显示一维条码
二维码显示二维码

卡颜色(显示值即代码,共 14 项):

取值
Color010、Color020、Color030、Color040、Color050、Color060、Color070、Color080、Color081、Color082、Color090、Color100、Color101、Color102

颜色代码对应微信卡券背景色,具体色值以微信卡券接口文档为准。

五、典型使用场景 ​

场景 1:上线一张新面额的储值卡 ​

背景:门店要售 100 元面值的微信储值卡。 操作:本页新增卡模板,填面额与有效期,打开支持储值、允许在线充值 → 到微信礼品卡货架把卡挂上货架 → 在客户端推送微信卡券并发布货架 → 顾客购买后在微信礼品卡订单查询核对订单。

场景 2:节日兑换卡 ​

背景:中秋售月饼兑换卡,有效期固定到节日后一段时间。 操作:新增卡模板,有效期类型按固定区间口径设置起止时间,卡描述写清兑换范围 → 挂货架售卖 → 节后按订单查询导出核对售出与退款。

场景 3:合作单位员工福利卡 ​

背景:烘焙企业给合作单位做福利卡业务,卡券由单位发放到员工手上,员工在微信端绑定后消费抵扣。 操作:本页按福利方案定义卡面额、有效期与抵扣规则(订单满额可用、单笔上限积分)→ 单位发放后,员工消费抵扣情况通过订单查询与会员相关报表核对。

场景 4:调整积分抵扣规则 ​

背景:积分抵现比例要下调。 操作:列表搜卡标题 → 打开编辑 → 改 积分与抵扣 组的使用积分、抵扣金额、订单满额可用 → 保存 → 在客户端重新推送微信。

六、权限控制与前置条件 ​

  • 本页无独立 ERP 菜单权限映射项(Django 新增页面),有页面访问权限即可操作;菜单可见性跟随 O2O业务 分组,看不到分组时联系实施人员确认模块是否开通。
  • 前置条件:O2O业务已开通(见 O2O业务总览);卡面图片先备好可访问的 Url。
  • 卡模板要在顾客卡包生效,还需客户端完成微信卡券推送;货架售卖还需配置并发布微信礼品卡货架。

七、常见问题 ​

1. 保存时提示「卡标题不能为空」 ​

  • 原因:卡标题是必填名称字段;
  • 处理:在基础信息组补填卡标题再保存。

2. 删除时提示「号码已经上传不能删除!」 ​

  • 原因:这张卡已上传自定义卡号,系统禁止删除;
  • 处理:不要删除,改为停止投放;确需清理时联系实施人员评估。

3. 微信卡券ID 一直是空的 ​

  • 原因:卡模板尚未推送到微信平台,本页不提供推送按钮;
  • 处理:到客户端微信礼品卡窗口执行推送,回写后本页只读展示。

4. 礼品卡ID 能自己指定或修改吗 ​

  • 原因:编号由系统统一发号,保存后只读;
  • 处理:新增时不必手工编号,保存后以系统分配的编号为准。

5. 改了卡面,顾客卡包里没变化 ​

  • 原因:本页只改 ERP 侧模板,微信侧卡面要重新推送才更新;
  • 处理:在客户端重新执行推送,再让顾客刷新卡包查看。

附:本文档变更记录 ​

日期变更
2026-11-18初稿