> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 持卡人

> 商户后台「卡片 > 持卡人」页，查看/搜索/筛选名下所有持卡人及其验证状态、持卡数量，并从这里创建、编辑、导出持卡人。

## 这是什么

这是商户后台「**卡片**」模块下的 **持卡人** 页面（左侧导航「卡片」→ 顶部标签「持卡人」，页面副标题「开通与管理持卡人」）。持卡人是可以被分配卡片的人（如员工/团队成员），这一页用来查看名下所有持卡人、他们的**验证状态**和**持卡数量**，并创建新持卡人、编辑持卡人资料、导出持卡人清单。要给某人开卡前先在这里把人建好，或想查某个持卡人信息、看谁通过了验证时，就用这一页。

## 操作步骤

进入持卡人列表：

1. 左侧导航点击「**卡片**」。
2. 顶部选择「**持卡人**」标签（同级还有：总览、卡片、交易、Low balance）。
3. 用顶部「**状态 / 姓名 / 邮箱 / 日期范围**」筛选缩小范围。

添加持卡人：

1. 点右上角「**创建持卡人**」（需有持卡人写权限，否则不显示此按钮）。
2. 填**法定名**、**法定姓**、**工作邮箱**、**电话号码**（含国家代码）；**出生日期**可选。
3. 选**证件类型**（身份证 / 护照 / 驾驶证）并填**证件号码**。
4. 填**居住地址**（国家、省/州、城市、邮政编码、地址第 1 行、地址第 2 行）。
5. 填**寄送地址**（实体卡将寄送至此地址）；可勾选「**使用居住地址作为寄送地址**」直接复用。
6. 如需**雇主声明**，下载模板填好后上传。
7. 点「**确认**」提交，成功提示「创建持卡人成功！」。

编辑持卡人：点某行末尾的「**⋯**」菜单 →「**编辑持卡人**」（需写权限），修改资料后「更新」。

导出：点工具栏「**导出**」导出列表；或勾选若干行后点「**导出选中项**」导出所选（单次最多选 100 行）。

## 字段与状态含义

**列表列：**

| 列    | 含义（商户视角）                         |
| ---- | -------------------------------- |
| 持卡人  | 持卡人姓名 + 持卡人 ID（ID 行内可复制，过长会中间省略） |
| 邮箱   | 持卡人工作邮箱                          |
| 电话   | 持卡人电话（无则显示 `---`）                |
| 卡片   | 该持卡人名下卡片数量（无则显示 `---`）           |
| 状态   | 验证状态，见下                          |
| 创建时间 | 持卡人创建日期时间                        |

**顶部统计**：总计、已验证、待处理、失败（分别为持卡人总数及各验证状态计数）。

**验证状态：**

| 状态  | 含义                |
| --- | ----------------- |
| 已验证 | 持卡人身份已通过验证        |
| 待处理 | 验证处理中             |
| 失败  | 验证失败              |
| 已邀请 | 已发出邀请，对方尚未完成注册/验证 |
| 未完成 | 验证信息未填完           |

> 「失败」状态若带审核备注，鼠标悬停状态徽标会显示失败原因。

**创建持卡人表单字段：** 法定名、法定姓、工作邮箱、电话号码（+国家代码）、出生日期（可选）、证件类型（身份证/护照/驾驶证）、证件号码、居住地址（国家/省·州/城市/邮政编码/地址第 1 行/地址第 2 行）、寄送地址（实体卡寄送，可复用居住地址）、雇主声明（可下载模板）。

## 边界与常见处理

* **列表显示「暂无持卡人」**：还没有持卡人，提示「添加您的第一位持卡人以开始使用」，点「创建持卡人」新建。
* **筛选后「没有持卡人符合您的筛选条件」**：当前筛选无匹配，提示「请尝试调整筛选条件」，清空筛选再看。
* **看不到「创建持卡人」按钮或行内「⋯」菜单**：当前账号没有持卡人写权限，只读账号不显示这些操作。
* **电话/卡片数显示 `---`**：该字段暂无数据。
* **创建时提示「提交前需要替换雇主声明」**：需先下载雇主声明模板、填好并上传后才能提交。
* **上传文件报「文件大小不应超过 2MB」**：附件（如雇主声明）超过 2MB 上限，压缩后重传。
* **勾选导出提示已达上限**：单次最多选 100 行，超出需分批导出。

## 常见问法（Q→A）

* **Q：持卡人在哪里看？/ 怎么查所有持卡人？** A：左侧「卡片」→ 顶部「持卡人」标签，列表即名下全部持卡人。
* **Q：怎么加一个持卡人？/ 怎么邀请团队成员开卡？** A：持卡人页右上角「创建持卡人」，填姓名、工作邮箱、电话、证件和地址后确认。
* **Q：添加持卡人要填哪些信息？** A：法定姓名、工作邮箱、电话、证件类型和号码、居住地址、寄送地址；出生日期可选，实体卡需寄送地址。
* **Q：验证状态有哪些？分别什么意思？** A：已验证、待处理、失败、已邀请、未完成——分别对应持卡人 KYC/验证进度。
* **Q：持卡人状态显示「失败」怎么办？** A：验证失败，若有审核备注，悬停状态徽标可看失败原因；需按原因补充资料重试。
* **Q：怎么改持卡人资料？** A：在该行「⋯」菜单选「编辑持卡人」（需写权限）。
* **Q：怎么导出持卡人名单？** A：工具栏「导出」导全部，或勾选后「导出选中项」导所选（最多 100 行）。
* **Q：为什么我没有「创建持卡人」按钮？** A：当前账号缺少持卡人写权限，只读账号看不到创建/编辑入口。
* **Q：一个持卡人名下有几张卡在哪看？** A：列表「卡片」列显示该持卡人的持卡数量。
* **Q：怎么按姓名或邮箱找持卡人？** A：用顶部「姓名/邮箱」搜索框输入姓名或邮箱。