支付宝会员
支付宝会员管的是顾客支付宝卡包里那张会员卡长什么样。门店的会员卡系列与卡类别在 ERP 里只有一份档案,这个窗口把其中一个系列映射成支付宝侧的会员卡模板:卡品牌、钱包端显示名称、核销码类型、卡面颜色与字体颜色、Logo 与背景图、要不要显示余额和积分,配完点【更新到支付宝服务器】提交,顾客在支付宝里领到的就是这张卡。
功能路径:系统菜单 → O2O业务 → 支付宝会员 → 支付宝会员。
本子模块默认不出现在菜单里,要先在支付宝管理用户特点勾上「启用支付宝会员管理模块(需重启软件)」并重启软件,【O2O业务】下才会多出【支付宝会员】这一组菜单。
一、功能概述
1. 解决什么问题
微信卡包和支付宝卡包是两套独立的会员卡模板,卡面要素、颜色取值、图片规格都不一样,不能拿微信那边配好的卡直接复用。这个窗口负责支付宝这一套:
- 指定哪个会员卡系列上支付宝卡包,以及该系列下默认发哪一类卡;
- 定义顾客在支付宝里看到的卡面:品牌名、钱包端名称、联系电话、会员特权说明、卡颜色与字体颜色、Logo 与背景图;
- 选择顾客出示什么码给门店扫:二维码、条形码,或两者的动态版本;
- 控制卡面上要不要显示余额与积分。
2. 数据从哪来
| 内容 | 来源 |
|---|---|
| 可选的会员卡系列 | 会员卡系列档案中勾了「是否支付宝会员卡」的那些 |
| 可选的会员卡类别 | 会员卡级别档案中属于所选系列的那些(选择窗口里列名叫「会员卡类别」) |
| 可选的 Logo 与背景图 | 本子模块上传图片里已导入并上传到支付宝的图片 |
| 模板本身 | 支付宝会员卡模板,窗口一次编辑一条 |
窗口打开时定位到已有的那条模板记录;表里还没有记录时,软件自动新建一条空白记录并把「是否显示余额」「是否显示积分」都置为不勾选,所以第一次打开看到的是一张空卡,不是出错。
3. 与相邻窗口的分工
- 卡系列与卡类别的档案在会员里建,本窗口只做选择和映射,不新建系列;
- 图片素材在本子模块的上传图片里维护,和微信那边用的微信图片资料管理是两套独立的图片库,互相选不到对方的图;
- 微信卡包里的会员卡在微信会员卡设置与投放里配,两边各配各的。
二、界面布局说明
窗口只有一个页签【支付宝会员】,顶部工具栏是【退出】和【帮助】两个按钮,没有左侧列表,也没有记录导航条——界面上一次只编辑一条模板记录。

页签【支付宝会员】
字段按界面从上到下、从左到右排列:
| 界面文字 | 输入方式 | 说明 |
|---|---|---|
| 会员卡系列 | 点框右侧【…】弹选择窗口 | 显示为「卡系列编号 卡系列名称」 |
| 默认卡类别 | 点框右侧【…】弹选择窗口 | 显示为「卡类别编号 卡类别名称」,必须先选系列 |
| 会员特权说明 | 多行文本框 | 顾客在卡详情页看到的权益文字,最长 1000 字符 |
| 卡品牌 | 文本框 | 最长 100 字符 |
| 钱包端名称 | 文本框 | 支付宝钱包里显示的名称,最长 10 字符 |
| 卡条码类型 | 下拉框 | 四个固定选项,见下文 |
| 联系电话 | 文本框 | 最长 30 字符 |
| 字体颜色 | 下拉框 + 右侧色块 | 14 个固定色号,只能选不能自定义 |
| 卡颜色 | 下拉框 + 右侧色块 | 同上,与字体颜色各自独立 |
| 是否显示余额 | 勾选框 | 默认不勾 |
| 是否显示积分 | 勾选框 | 默认不勾 |
| 卡片Logo | 点框右侧【…】弹图片选择窗口 | 存的是支付宝图片ID,不是本地路径 |
| 背景图片 | 点框右侧【…】弹图片选择窗口 | 同上 |
页签底部是【更新到支付宝服务器】按钮。
三个选择窗口
| 入口 | 窗口标题 | 列表列 | 列表为空时的提示 |
|---|---|---|---|
| 会员卡系列【…】 | 请选择任会员卡系列! | 会员卡系列 | 请先设置会员卡系列,或检查卡系列是否有勾选支付宝会员卡! |
| 默认卡类别【…】 | 请选择任会员卡类别! | 会员卡类别 | 请先设置会员卡类别! |
| 卡片Logo / 背景图片【…】 | 请选择图片! | 标题、文件名、图片ID | 请先设置支付宝图片! |
卡系列与卡类别两个框还支持输入过滤:在【会员卡系列】框里输入编号或名称的一部分后按回车,弹出的选择窗口会按输入内容过滤;【默认卡类别】框在输入过程中就会弹出选择窗口。
颜色色块
两个颜色下拉都是固定 14 项:Color010、Color020、Color030、Color040、Color050、Color060、Color070、Color080、Color081、Color082、Color090、Color100、Color101、Color102。选中后下拉右侧的色块立即变成对应颜色,可以照着挑;色号本身不是颜色名,认色块不认编号。
色块预览与卡面实际颜色可能红蓝相反。 软件把色号换算成提交给支付宝的颜色值时,红、蓝两个分量的取法与色块预览所用的取法正好互换:色块看着偏蓝的色号,提交后卡面上会偏红,反之亦然;偏绿、偏灰的色号受影响小。所以不要只照色块定色——先点【更新到支付宝服务器】,用手机在支付宝里领一张卡看实际卡面,颜色不符就换一个色号再更新一次。字体颜色与卡颜色两个下拉各自独立,但换算口径相同,两处都要按卡面复核。
三、业务操作步骤
步骤 1:开总开关并重启软件
到【设置系统特点】左侧选【业务数据 → 支付宝管理】,在【支付宝会员】页签勾上「启用支付宝会员管理模块(需重启软件)」,点工具栏【保存】,然后重启软件。重启后【O2O业务】下出现【支付宝会员】菜单,里面有两个入口:【支付宝会员】和【上传图片】。
步骤 2:给卡系列勾上支付宝会员卡
到会员卡系列,在要上支付宝卡包的那个系列上勾选「是否支付宝会员卡」并保存。这一列只在总开关打开后才显示;没勾的系列在本窗口的选择窗口里查不到。
步骤 3:先把图片传上去
进【上传图片】,新增一行、导入图片文件、点【上传图片】提交到支付宝,确认列表里「支付宝图片ID」列有值。图片规格见上传图片。这一步要在选图之前做完,否则选择窗口里「图片ID」列是空的,选了等于没选。
步骤 4:选会员卡系列
打开【支付宝会员】窗口,点【会员卡系列】框右侧【…】,在「请选择任会员卡系列!」窗口里双击目标系列。框里显示「编号 名称」,同时默认卡类别会被清空——换系列必须重选类别。
步骤 5:选默认卡类别
点【默认卡类别】框右侧【…】,在「请选择任会员卡类别!」窗口里双击该系列下的一个卡类别。顾客领卡时默认拿到这一类。
步骤 6:填卡面文字与颜色
依次填卡品牌、钱包端名称(注意 10 字符上限)、联系电话、会员特权说明;选卡条码类型;在两个颜色下拉里挑色号,看右侧色块初选(色块与卡面可能红蓝相反,最终按步骤 8 提交后的实际卡面定色);按需勾「是否显示余额」「是否显示积分」。
步骤 7:选 Logo 与背景图片
分别点【卡片Logo】和【背景图片】框右侧【…】,在「请选择图片!」窗口里按标题挑图。选完框里显示的是支付宝图片ID。只挑「图片ID」列有值的行。
步骤 8:更新到支付宝服务器
点【更新到支付宝服务器】。软件先保存本地改动,再把卡系列ID与默认卡类别ID提交给服务端,由服务端调支付宝接口创建模板。成功弹出服务端返回的说明文字;失败弹出「[错误码]错误说明」形式的报错,按错误码排查后重试。
按钮只在窗口里有记录时可用。本地改动在关窗口时也会保存,但关窗口不等于提交到支付宝,要让顾客看到新卡面必须点这个按钮。
四、字段详细说明
卡条码类型
下拉里是四个「中文名:英文值」形式的固定选项,英文值提交给支付宝,中文名给操作员看:
| 界面选项 | 提交值 | 含义 |
|---|---|---|
| 二维码:qrcode | qrcode | 静态二维码,卡面上印一个固定码 |
| 条形码:barcode | barcode | 静态条形码 |
| 动态二维码:dqrcode | dqrcode | 动态二维码,码值随时间变化 |
| 动态条形码:dbarcode | dbarcode | 动态条形码 |
静态码截图转发后仍然可用,动态码不行;对盗刷敏感的门店选动态版本。
字段长度上限
| 字段 | 上限 |
|---|---|
| 钱包端名称 | 10 字符 |
| 联系电话 | 30 字符 |
| 卡品牌 | 100 字符 |
| 会员特权说明 | 1000 字符 |
超出上限的部分存不进去,填长文案前先数字数。
两个显示开关
「是否显示余额」「是否显示积分」控制的是支付宝卡面上要不要露出这两个数字,不影响 ERP 里的储值与积分账务。新建记录时两项都是不勾,需要显示就手动勾上再更新。
五、典型使用场景
场景 1:门店第一次上支付宝卡包
背景:会员体系已经在 ERP 里跑通,现在要让顾客在支付宝里也能领卡。操作:开总开关并重启 → 给储值VIP系列勾「是否支付宝会员卡」 → 传 Logo 与背景图 → 打开本窗口选系列与默认卡类别 → 填卡面 → 更新到支付宝服务器 → 拿手机在支付宝里实际领一张卡看效果。
场景 2:换季换卡面
背景:门店要做节日主题卡面。操作:先在【上传图片】里导入并上传新的背景图 → 回本窗口点【背景图片】【…】选新图 → 点【更新到支付宝服务器】。已经领过卡的顾客卡面是否跟着变,以支付宝侧的模板更新规则为准,更新后拿一台已领卡的手机复核。
场景 3:顾客扫码核销失败
背景:门店扫顾客支付宝卡面上的码,收银端识别不了。操作:先确认本窗口【卡条码类型】选的是哪一种,再核对收银端支持的码制;静态码与动态码的识别方式不同,改完类型必须重新点【更新到支付宝服务器】,只改本地不提交不会生效。
六、权限控制与前置条件
- 总开关:未勾「启用支付宝会员管理模块(需重启软件)」时整个菜单不注册,重启后才出现;
- 卡系列前置:可选系列必须先在会员卡系列档案里勾「是否支付宝会员卡」,且该列只在总开关打开后可见;
- 卡类别前置:必须先选系列,系列为空时点【默认卡类别】的【…】没有任何反应,也不报错;
- 图片前置:Logo 与背景图必须先在【上传图片】里上传成功、拿到支付宝图片ID;
- 服务地址:提交走的是微信服务同一个服务端地址,在微信管理用户特点里配,属敏感信息,只在实施时由现场人员录入;
- 本子模块不做单独的模块授权判断,菜单出现即可用,能不能提交成功取决于服务端与支付宝商户侧的配置。
七、常见问题
1. 【O2O业务】下找不到【支付宝会员】
总开关没开或开了没重启。到【设置系统特点】→【业务数据 → 支付宝管理】→【支付宝会员】页签确认勾选已保存,然后重启软件。这个开关是全账套共用的,不是按操作员区分。
2. 选系列时提示「请先设置会员卡系列,或检查卡系列是否有勾选支付宝会员卡!」
两种原因:账套里还没有会员卡系列档案;或者有系列但都没勾「是否支付宝会员卡」。到会员卡系列窗口补档案并勾选。注意这一列本身也受总开关控制,开关没开时看不到这一列。
3. 换了会员卡系列,默认卡类别变空了
这是设计行为:卡类别隶属于系列,换系列后原来的类别不再属于新系列,软件主动清空避免配错。重新点【默认卡类别】的【…】选一次即可。
4. 点【默认卡类别】的【…】没反应,也不弹窗
当前会员卡系列还是空的。软件在系列ID为 0 时直接返回,不弹选择窗口也不提示。先选系列再选类别。
5. 选图时提示「请先设置支付宝图片!」
【上传图片】里一条记录都没有。先去导入并上传图片。注意支付宝图片库和微信图片库是分开的,微信那边传过的图在这里选不到。
6. 选了图片,顾客卡面上却没有图
选择窗口里那一行的「图片ID」列是空的——图片只导入了本地、还没点【上传图片】提交到支付宝。本窗口存的是支付宝图片ID,空值等于没配图。回【上传图片】把该行上传成功,再回来重选一次。
7. 点【更新到支付宝服务器】弹「[错误码]错误说明」
服务端调支付宝接口失败,方括号里是错误码、后面是服务端返回的说明。常见原因是卡系列或默认卡类别没选、图片ID 无效、支付宝商户侧的会员卡模板能力未开通。按错误码找实施人员核对商户侧配置,本地重复点按钮不会绕过这个错误。
8. 第一次打开窗口是一张空白卡
模板表里还没有记录,软件自动新建了一条空白记录,两个显示开关默认不勾。这是正常初始化,直接往下填就行。
9. 钱包端名称填不全
这个字段上限 10 字符,比卡品牌(100 字符)短得多。支付宝钱包里的显示位置本来就窄,用简称,全称放卡品牌。
10. 照着色块挑的颜色,顾客卡面上却是另一个色
色块预览与提交给支付宝的颜色值在红、蓝两个分量上取法相反,偏蓝与偏红的色号会互换观感,这是换算口径造成的,不是选错了色号。处理办法:以手机领卡看到的实际卡面为准,换一个色号再点【更新到支付宝服务器】,逐个试到满意为止;对颜色要求严格的品牌色,建议先小范围试一张卡确认色号,再批量推广。
附:与其他功能的关系
- 总开关与重启要求:支付宝管理用户特点
- 图片素材导入与上传:上传图片
- 卡系列档案与「是否支付宝会员卡」列:会员卡系列
- 卡类别档案(菜单名【会员卡级别】):会员卡级别
- 微信侧的同类配置:微信会员卡设置与投放
