> ## 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.

# 持卡人验证（个人详情 / KYC）

> 持卡人身份验证（KYC/实名）页，填法定姓名/出生日期/国籍/居住地址等个人详情，并按系统要求再上传证件、自拍或完成人脸验证，提交后由团队审核。

## 这是什么

这是商户后台发卡模块的**持卡人身份验证页**（页面标题「个人详情」）。持卡人在这里填写身份信息完成实名验证——出于合规安全要求，卡片需在身份通过验证后才能使用。系统会根据要求，决定你需要填写个人信息、是否需要上传证件与自拍、或完成人脸验证：最简的只填个人详情与居住地址；较严的还要上传证件与自拍；最严的要完成人脸验证。填完提交后由团队审核，审核结果决定卡片是否可用。

> 需要哪一级验证由系统按卡片产品要求判定，持卡人本人无法选择。页面右上角「✕」关闭并返回卡片列表。

## 操作步骤

**基础流程（所有情况都要填）：**

1. 进入「个人详情」页，页面顶部说明「出于安全目的，我们需要这些信息。一经我们团队验证，您将立即可使用您的新卡。」
2. 在「您的个人详情」下按**政府签发证件上的内容**准确填写：法定名、法定姓、电话号码（含区号，默认 65）、出生日期（格式 YYYY-MM-DD）、国籍。
3. 填「居住地址」（持卡人居住的地址）：国家、城市、地址第 1 行、邮政编码为必填；省/州、地址第 2 行可选。

**若系统要求上传证件：**

4. 在「身份证件」区选择「证件类型」（身份证 / 护照 / 驾驶执照），填「证件号码」（最长 50 字符）与「证件到期日」（须晚于今天）。
5. 「上传您的身份证件」：点击或拖放上传，最多 5 个文件、每个 ≤ 10MB，支持 JPG/JPEG/PNG/PDF；要求「正反面 / 清晰可见 / 未过期」。
6. 「自拍照」：拍摄或上传一张清晰自拍用于身份验证，仅允许一张（JPG/JPEG/PNG，最大 10MB）。
7. 点右下角「**提交详情**」。成功提示「个人详情已成功提交！」并跳回卡片列表；失败提示「提交失败。请重试。」

**若系统要求人脸验证（分两步）：**

4. 填完个人详情与居住地址后，点右下角「**下一步**」。
5. 进入「身份验证」步骤，按「完成人脸验证以最终完成您的身份认证流程。」的指引，在页内完成人脸/证件核验。
6. 人脸验证完成后，点「**提交**」（完成前提交按钮不可用）。可用「返回」回到第一步修改。
7. 若系统判定无需再走人脸核验，会直接显示「身份验证已完成」，并提示「无需额外验证」或「您的验证正在审核中」。

## 字段与状态含义

**个人详情字段**：

| 字段   | 必填 | 说明                            |
| ---- | -- | ----------------------------- |
| 法定名  | 是  | 政府证件上的名                       |
| 法定姓  | 是  | 政府证件上的姓                       |
| 电话号码 | 是  | 含区号（默认 65）                    |
| 出生日期 | 是  | 格式 YYYY-MM-DD；年龄须在 18–100 岁之间 |
| 国籍   | 是  | 下拉选择                          |

**居住地址字段**：

| 字段      | 必填 | 说明 |
| ------- | -- | -- |
| 国家      | 是  |    |
| 城市      | 是  |    |
| 地址第 1 行 | 是  |    |
| 邮政编码    | 是  |    |
| 省/州     | 否  | 可选 |
| 地址第 2 行 | 否  | 可选 |

**身份证件字段（需要上传证件时出现）**：

| 字段     | 说明                                               |
| ------ | ------------------------------------------------ |
| 证件类型   | 身份证 / 护照 / 驾驶执照                                  |
| 证件号码   | 最长 50 字符                                         |
| 证件到期日  | 必须晚于今天                                           |
| 身份证件文件 | 最多 5 个，每个 ≤ 10MB，JPG/JPEG/PNG/PDF；要求正反面/清晰可见/未过期 |
| 自拍照    | 仅 1 张，JPG/JPEG/PNG，最大 10MB                       |

**其他文件（其他文件区）**：仅在审核要求补充材料时出现，用于按要求上传补充验证文件（同样最多 5 个、每个 ≤ 10MB）。

**页面状态/提示**：

| 现象                       | 含义                             |
| ------------------------ | ------------------------------ |
| 顶部黄色「需要更多信息」提示条 + 一段说明   | 审核方要求补充信息，说明文字为审核备注，按提示补齐后重新提交 |
| 「身份验证已完成」+「无需额外验证」       | 系统判定无需再做人脸核验，验证已通过             |
| 「身份验证已完成」+「您的验证正在审核中」    | 已提交，正在审核中                      |
| 「网络请求失败。请稍后重试！」/「请稍后重试。」 | 人脸验证启动或加载失败，点「返回」重试            |

## 边界与常见处理

* **提交按钮是灰的、点不动**：个人详情/地址必填项未填全；若要求上传证件，还需选证件类型、填证件号码与到期日、上传证件和自拍；若要求人脸验证，需先完成人脸验证。
* **出生日期报错**：格式必须是 YYYY-MM-DD，且年龄在 18–100 岁之间，否则提示格式或日期无效。
* **证件到期日报错**：到期日必须晚于今天，已过期的证件不接受。
* **上传文件失败/被拒**：只支持 JPG、JPEG、PNG、PDF，单个 ≤ 10MB，证件最多 5 个；格式或大小不符会提示「不支持的文件格式」「文件过大」「最多允许 5 个文件」。
* **自拍传不上/提示只能一张**：自拍仅允许一张，需先删除已上传的再传新的；自拍只收图片（JPG/JPEG/PNG）。
* **顶部出现黄色「需要更多信息」**：审核被打回并要求补料，按备注补齐信息/文件后重新提交。
* **人脸验证加载失败或报「网络请求失败」**：点「返回」回到上一步，稍后重试。

## 常见问法（Q→A）

* **Q：持卡人怎么做实名/身份验证？** A：进入「个人详情」页，按证件填法定姓名、出生日期、国籍、居住地址；再按系统要求上传证件+自拍或完成人脸验证，最后提交等审核。
* **Q：验证要填哪些信息？** A：法定名、法定姓、电话号码（含区号）、出生日期、国籍，以及居住地址（国家/城市/地址第 1 行/邮政编码必填）。
* **Q：要上传什么证件？** A：如系统要求上传，需选证件类型（身份证/护照/驾驶执照）、填证件号码与到期日、上传证件正反面并拍一张自拍。
* **Q：证件/自拍能传什么格式、多大？** A：JPG、JPEG、PNG、PDF，单个不超过 10MB；证件最多 5 个，自拍仅 1 张（自拍只收 JPG/JPEG/PNG）。
* **Q：出生日期怎么填？为什么报错？** A：格式用 YYYY-MM-DD，且年龄要在 18–100 岁之间。
* **Q：证件到期日填了却报错？** A：到期日必须晚于今天，过期证件不接受。
* **Q：什么是人脸验证 / 为什么让我刷脸？** A：如系统要求，会让你完成人脸验证，完成后才能提交；若系统判定无需再核验会直接显示「身份验证已完成」。
* **Q：提交后显示"您的验证正在审核中"要等多久？** A：说明已提交、正在审核中。具体时效属账户实时状态，请以审核结果通知为准。
* **Q：顶部弹出黄色"需要更多信息"是什么意思？** A：审核方要求补充信息，黄条里的文字是审核备注，按提示补齐后重新提交。
* **Q：提交按钮点不了怎么办？** A：先确认必填项都填了；若要求上传证件要传完证件和自拍，若要求人脸验证要先完成人脸验证，提交按钮才会可用。
* **Q：验证过了卡就能用了吗？** A：页面说明「一经我们团队验证，您将立即可使用您的新卡」，即验证通过后卡片可用；卡片本身状态请在「卡片」列表查看。