> ## 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. 点右上角「**添加角色**」，打开「创建角色」全屏页。
3. 在左侧「**角色详情**」区填「**角色名称**」（必填，例如「财务经理」「查看者」）；「**描述**」可选，用一句话说明这个角色的用途。
4. 在右侧「**权限**」区，按模块逐块勾选权限。每个模块是一张卡片，卡片内按资源分行，每行是一组动作复选框（如「查看」「编辑」）。勾一个复选框即授予该项权限。
5. 需要快速勾选时有两个「**全选**」，作用范围不同：每张模块卡片右上角的「**全选**」只勾上**这一个模块**内你可授予的权限；页面右上角的「**全选**」勾上**所有模块**的全部可授予权限，旁边的「**清除**」清空（自动包含的基础权限会保留）。
6. 底部会实时显示当前「角色」名与「**已选 N 项**」。核对无误后点右下角「**创建角色**」。成功后提示「**角色创建成功！**」并返回团队页。

编辑一个已有角色：

1. 在「设置 > 团队 > 角色」列表里，找到目标角色，点其「**编辑角色**」。
2. 页面会载入该角色现有的名称、描述与已选权限（左上角另显示只读的「**角色 ID**」）。
3. 改名称、描述或增删权限勾选。
4. 点右下角「**保存更改**」，成功后提示「**角色更新成功！**」。角色权限的变更会在相关成员**下次登录时**对其生效。

> 右上角「✕」或「取消」直接关闭返回团队页，未保存的内容不保留。新建/编辑角色需要相应的角色管理权限，没有权限时看不到「添加角色」「编辑角色」入口。

## 字段与状态含义

**左侧「角色详情」：**

| 字段    | 含义（商户视角）               | 备注              |
| ----- | ---------------------- | --------------- |
| 角色名称  | 这个角色的名字，会显示在成员列表和分配角色时 | 必填，最长 255 字符    |
| 描述    | 一句话说明角色用途              | 可选，最长 500 字符    |
| 角色 ID | 角色的唯一标识                | 仅编辑角色页显示，只读、不可改 |

**右侧「权限」：** 权限按**模块**分组成卡片，每张卡片是一个业务领域，卡片内按**资源**分行，每行是一组**动作**复选框。**实际显示哪些模块、每个模块里有哪些资源和动作，都由你账户已开通的产品决定**，不同账户看到的清单不一定相同。下表是可能出现的模块示例（括号内为卡片标题下那行灰色小字说明），并非固定的完整清单：

| 模块   | 卡片说明（屏上一句话）               |
| ---- | ------------------------- |
| 收单   | 收款、退款、争议和结算管理             |
| 钱包   | 余额、转账和外汇操作                |
| 全球账户 | 全球账户与余额管理                 |
| 付款   | 发起并管理付款和收款人               |
| 币种兑换 | 执行币种转换并管理外汇               |
| 持卡人  | 管理持卡人及其资料                 |
| 卡片   | 卡片发行、卡片项目和持卡人操作           |
| 数字资产 | 数字资产出入金操作                 |
| 财资   | 财资产品、持仓和订单                |
| 开发者  | API 密钥、Webhook 和 OAuth 应用 |
| 设置   | 企业资料、团队、角色及其他设置           |

**动作复选框含义**（每个资源行上出现的勾选项，具体有哪些按资源不同）：

| 动作  | 含义               |
| --- | ---------------- |
| 查看  | 可查看该资源           |
| 编辑  | 可创建/编辑该资源        |
| 发起  | 可发起该操作（如发起转账、付款） |
| 关闭  | 可执行关闭类操作（如关闭账户）  |
| 取消  | 可执行取消类操作         |
| 导出  | 可导出（如导出报告、交易明细）  |
| 管理  | 可对该资源做管理级操作      |
| 持卡人 | 持卡人相关操作          |

**几个特殊状态：**

* **持卡人的「查看/编辑」默认已勾且不可取消**——这是每个角色都会自动带上的基础权限，属于「基础权限会自动包含」的一部分。
* **灰色、勾不动的复选框**：你自己没有该项权限，就无法把它授予别人（账户 Owner 不受此限）。你只能授予自己拥有的权限。
* **底部「已选 N 项」**：当前这个角色勾选的权限总数。

## 边界与常见处理

* **看不到「添加角色」/「编辑角色」入口**：多为没有角色管理权限，需让账户管理员或 Owner 分配权限。
* **点「创建角色」没反应 / 提示要填角色名称**：角色名称必填，先在左侧填「角色名称」。
* **担心「权限一项都没选」保存不了**：通常不用担心——每个角色都会自动带上「持卡人」的查看和编辑两项基础权限且不可取消，权限集始终非空，你只需在此基础上按需增加即可。
* **某些权限的复选框是灰的、勾不动**：那是你本人不具备的权限，无法授予他人；需要更高权限的成员或 Owner 来授予。
* **持卡人的查看/编辑取消不了**：这是自动包含的基础权限，所有角色都带，属正常。
* **直接用网址打开或刷新「编辑角色」页后跳回了团队页**：编辑角色需从角色列表点「编辑角色」进入，不能直接用网址访问或刷新；回到「设置 > 团队 > 角色」重新点进即可。
* **改了角色权限，成员却还没变化**：角色变更在相关成员**下次登录时**才生效。
* **保存失败**：会提示「创建角色失败」「更新角色失败」或网络错误，稍后重试；反复失败请联系支持。

## 常见问法（Q→A）

* **Q：怎么新建一个角色？** A：设置 > 团队 > 角色标签，右上角「添加角色」，填角色名称和描述，在右侧按模块勾选权限，点「创建角色」。
* **Q：在哪里改一个角色的权限？** A：设置 > 团队 > 角色列表里，对该角色点「编辑角色」，增删权限勾选后点「保存更改」。
* **Q：角色名称是必填的吗？描述呢？** A：角色名称必填（最长 255 字符）；描述可选（最长 500 字符）。
* **Q：权限是怎么组织的？怎么勾？** A：按模块分成卡片，卡片内按资源分行，每行有「查看/编辑」等动作复选框，勾上即授予。
* **Q：怎么一次把一个模块的权限都勾上？** A：点该模块卡片右上角的「全选」，它只勾上这一个模块内你可授予的权限；想一次勾上所有模块的权限，用页面右上角的「全选」，清空用「清除」。
* **Q：为什么有些权限的勾选框是灰的、点不动？** A：那是你自己没有的权限，你只能授予自己拥有的权限（账户 Owner 除外）。
* **Q：持卡人的查看/编辑为什么取消不掉？** A：这是每个角色自动包含的基础权限，属正常，不能取消。
* **Q：能创建角色但一项权限都不选吗？** A：不会出现「一项都没有」的情况——每个角色都自动带上「持卡人」的查看和编辑两项基础权限，且不能取消，所以权限集始终非空。你在此基础上按需增加其他权限即可。
* **Q：改了角色权限，成员什么时候生效？** A：在相关成员下次登录时生效。
* **Q：编辑角色页刷新后跑回团队页了怎么办？** A：编辑角色要从角色列表点「编辑角色」进入，不能直接用网址打开或刷新；回列表重新点进即可。
* **Q：能看到哪些模块的权限？** A：取决于你账户已开通的产品，常见有收单、全球账户、付款、币种兑换、持卡人、卡片、数字资产、财资、开发者、设置等。
* **Q：角色 ID 能改吗？** A：不能，角色 ID 只在编辑角色页只读显示。