---
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. 用户输入卡号 结果卡已经是被经销商录入的