AfterAales/source/_posts/实体卡相关.md

---

title: 实体卡相关 date: 2023-04-19 09:49:39

tags:

实体卡

实体卡相关规则

• 纯数字实体卡卡第一位不能为0 如果是0 则系统默认会去掉第一位

  例如 卡号为 0123456789 实际系统中存储为123456789

• 实体卡的唯一规则为 平台ID + 卡号

  即productAgentId + cardNo 系统唯一

系统录入卡/绑定卡

在系统绑定卡的方式从角色划分一共有三种 分别是代理商绑定、经销商绑定和用户个人绑定

代理商批量绑定卡

如果需要代理商拥有批量绑定卡功能，需要配置 代理商特性 【agent_card_management】

概述

代理商绑定卡的需求是【劲能电子】独特的需。劲能电子是代发卡线下充值模式，即代理商直接将卡绑定到自己的微信openId下， 然后将卡直接发给用户，用户需要充值的时候将钱通过线下转给发卡人，然后发卡人代充值。即用户本人不需要绑定卡，只需要 拿卡、刷卡、线下付款即可。

因此，此模式只需要代理商绑定一次卡之后即可，用户将卡拿到手之后，不需要再有额外的动作，只需要刷卡启动即可。同时，实际持卡人本人无法使用线上充值功能（实际的持卡人个人中心是看不到卡的，因为卡是绑定在代理商的openId名下）

功能使用

• 登录代理商后台
• 点击首页的【实体卡】模块（如看不见此模块，检查下该代理商特性是否配置【agent_card_management】）
• 绑定微信（此步骤非必须，如已经绑定了，则会直接跳过此步骤）
• 选择批量绑定实体卡
• 选择卡实际使用的经销商和地址（此步骤很关键，不能选错，否则无法正常使用）
• 直接上传卡号文件或者输入卡号即可

经销商录入实体卡

概述

经销商【录入】实体卡，此处用的是【录入】而非【绑定】，是因为经销商录入的实体卡大部分情况下，还是需要用户自行再绑定一次的，经销商只是将卡提前录入到系统中，此时卡的openId为【anonymous】。

经销商录入实体卡可以:

1. 简化用户绑卡 可以生成 绑卡二维码，用户微信直接扫码绑定
2. 提前介入卡管理

功能使用

• 登录经销商后台
• 点击实体卡管理
• 选择右上角录入
• 输入卡号和地址录入卡

用户绑定实体卡

概述

用户端绑定实体卡的目的为【充值】以及【查看消费】；绑定的过程实际上就是找到卡，并将卡打上用户openId的标记

用户绑定卡有两种方式

1. 微信扫码（需要经销商提前录入）
2. 输入卡号绑定（不需要提前录入）

微信扫码绑定

• 经销商提前录入卡
• 经销商将卡的二维码【经销商后台---实体卡管理---找到卡---二维码】发送用户
• 用户【微信扫一扫】 该二维码直接绑定

输入卡号绑定

• 用户登录个人中心
• 首页上方实体卡
• 添加卡

-- 输入卡号信息 点击查找 此时会出现两种情况

1. 用户输入的卡号提前被经销商录入了
    - 用户确认过绑定地址信息后 点击绑定即可完成 
2. 用户输入的是一张没有被录入的卡号
    - 点击下方扫码 扫描【设备的二维码】完成绑定卡

存在的已知问题

用户可能会对卡进行的操作

1. 2020-12月以前部分被用户绑定到数据库中的卡 可能没有groupId，此时无法充值 在充值界面充值会返回1003跳转到绑定卡的界面 访问接口 card/add 前端界面为 /user/addEntityCard
2. 用户输入卡号 结果卡已经是被经销商录入的