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

# 商户 Portal 操作

> Waffo 商户 Portal 的账户与团队管理：为什么不同商户看到的菜单不一样、各角色能做什么、如何邀请和移除用户、登录安全与两步验证、界面语言，以及在哪里找到集成密钥。

本页介绍商户 Portal 中的账户、团队与访问权限管理。模块总览见
[商户 Portal](/docs/zh/essentials/merchant-portal)；公钥、通知 URL 和 IP 白名单见
[Portal 自助安全配置](/docs/zh/support/portal-security-config-faq)。

## 为什么我看不到结算、余额或争议 Tab？

导航的一部分由**你签约的业务范围**决定，而不是由你的角色决定——所以菜单缺失不是 Admin 能够授权补上的。

| 未签约 | Portal 中隐藏的内容 |
| - | - |
| 结算 | `Settlements` 及其全部子菜单、`Account → Balance`、`Account → Balance history`，以及首页的结算日历 |
| 提现 | `Account → Withdrawal history` 和 `Settings → Bank accounts` |
| 卡收单 | `Transactions` 下的 `Disputes` Tab |
| 多币种下单 | 列表页和分析页上的订单币种筛选 |

## 每个角色能做什么？

每个用户只有一个角色，选择角色时 Portal 会展示该角色的权限范围，便于你在邀请前确认。

| 权限 | Admin | General | Read-only | Dispute Manager |
| - | - | - | - | - |
| 查看交易 | ✓ | ✓ | ✓ | ✓ |
| 修改交易 | ✓ | ✓ | | |
| 查看结算 | ✓ | ✓ | ✓ | |
| 查看财务信息 | ✓ | ✓ | ✓ | |
| 发起提现 | ✓ | ✓ | | |
| 查看合同信息 | ✓ | ✓ | ✓ | |
| 管理争议 | ✓ | | | ✓ |
| 用户管理 | ✓ | | | |

另有一个独立的 **Dev** 角色拥有*查看集成信息*权限，因此 Dev 和 Admin 是仅有的两个能打开 Integration 页面的角色。成员列表位于 `Settings → Team`（原名 *Members*）；邀请按钮是 *Add user*。

## 怎么添加团队成员？邀请的有效期多长？

Super Admin 或 Admin 填写姓、名、邮箱和角色即可添加用户。账户会预先创建为 **Pending** 状态并发出激活邮件；激活链接有效期 **24 小时**，Pending 行会显示 **Resend** 操作。重发与其他账户邮件共用一个较短的每分钟上限——如果被拒绝，等一分钟再发一次即可（见
[Portal 登录、链接与账户状态](/docs/zh/support/portal-account-access-faq)）。
成员通过该链接自行设置密码——除非同一邮箱已在另一家商户下处于激活状态，此时激活只需确认即可。成员可按姓、名或邮箱搜索，你自己的那一行固定显示在最顶部。

有三个限制常让人意外：你不能编辑或删除**自己**；**Super Admin** 账户任何人都不能在 Portal 中编辑或删除；修改成员角色会**自动将该成员登出**——所以如果同事被意外登出，先查一下是否刚刚改了他们的角色。

## 密码规则是什么？

至少 **8 个非空白字符**，包含至少一个大写字母、一个小写字母和一个数字——允许但不要求包含符号——且不能与最近三次密码中的任意一个相同。密码必须每 **90 天**更换一次：超过该周期后首次登录时，Portal 会隐藏其他所有内容并强制进入密码更新页，你必须用新密码重新登录后才能使用 Portal。忘记密码的重置链接有效期 **30 分钟**，重置成功后会向账户邮箱发送一封确认邮件——如果不是你本人发起的，这就是提醒信号。

## 我的账户被锁了怎么办？怎么查看谁登录过？

短时间内多次输错密码会将账户锁定**一小时**并发送邮件通知。锁定期间登录会返回
*"Your account is temporarily locked. Please try again later."* 而不是密码错误提示；之后锁定会自动解除。

要审计访问记录，打开右上角用户菜单选择 **Login History**——可看到你账户最近 **90 天**的登录尝试，包含登录邮箱、时间、来源 IP 以及成功或失败。

## 怎么开启两步验证？

两步验证是**邮箱 OTP**，**默认关闭**。在 `Settings → Preference` 开启；开启时会走一轮 OTP 以确认邮箱可达，关闭则需要重新输入密码。之后登录时会显示 **OTP Verification** 对话框。验证码为 6 位数字，有效期 **10 分钟**；任何未过期的验证码都有效，所以如果后一封邮件先到，先前那封邮件里的验证码仍然可用，且 **Resend** 在短暂冷却结束前保持灰色。如果验证码始终收不到，Admin 可以在 Team 列表的 `2-Step Verification` 列为你关闭两步验证——这只作为邮件无法送达时的兜底手段。

这一列是**双向开关**，这也回答了另一个常见问题：Admin 也可以为尚未自行开启的成员**开启**两步验证。操作在该列按用户逐行进行；没有账户级别的策略可以强制所有人开启，也没有设置能阻止成员之后再自行关闭。Portal 标记为不可修改的行——你自己的行和超级管理员的行——开关是禁用的。

该设置属于**用户**而不是商户账户：如果你的邮箱注册在多家商户下，任意一家的 Admin 切换它都会影响全部商户，而你登录后可以自行覆盖。

## 我把 Portal 切成了中文，为什么邮件还是英文？

右上角的语言切换只控制**界面**，且保存在你的浏览器中。（切换器本身是按账户开放的，所以如果你没有这个切换器，说明 Portal 展示的是默认语言，而不是隐藏了某个你角色本应拥有的设置。）该选择只存在于当前浏览器，换浏览器、换设备或清除缓存后会重新回到默认值。

有两项内容遵循**各自**的语言设置而不是切换器：结算报表导出在 Customized Export 表单上带有 **Report Language** 选择器（English、中文、にほんご）；结算报表邮件订阅则按订阅各带一个 **Email Body Language**——见
[结算报表模块](/docs/zh/support/settlement-reports-export-faq)和
[报表投递与邮件订阅](/docs/zh/support/report-delivery-and-subscription-faq)。
其他系统邮件、API 错误信息以及交易和退款列表导出无论界面语言如何都是英文。

## 我在哪里找 API 密钥？为什么生产环境的密钥是打码的？

`Settings → Integration`（仅 Admin 和 Dev 角色可见）分为 sandbox 和 production 两个区块。每个值都有复制操作，区别在于默认展示的内容。

| 值 | Sandbox | Production |
| - | - | - |
| Merchant name、Merchant ID | 显示 | 显示 |
| Waffo Public Key | 显示 | 打码——点击 *show* 查看 |
| Merchant Public Key | 显示 | 打码——点击 *show* 查看 |
| Merchant Private Key | 显示 | 不列出 |
| API Key | 显示 | 打码——点击 *show* 查看 |

如果生产环境的 **Merchant Public Key** 显示为 `To be updated`，说明尚未登记生产环境公钥——如何提交和轮换见
[Portal 自助安全配置](/docs/zh/support/portal-security-config-faq)。

## 我从没开过验证码，为什么突然要我输验证码？

因为你所在商户账户的某位 Admin 为你的操作人账户开启了 **2-Step Verification**。你不需要做任何设置：由他人代为开启时会直接绑定**邮箱**方式，使用账户上已有的登录邮箱，所以下次登录就会显示 *Verification* 对话框，验证码已经在发往该邮箱的路上。

| Admin 切换开关时的状态 | 你会得到什么 |
| - | - |
| 两步验证原本关闭 | 现在开启，绑定到你的登录邮箱，从下次登录起生效 |
| 你此前已经自行开启 | 没有变化——对你已确认过的方式来说，这次切换是空操作 |

登录后你可以自行再关闭。开关位于**右上角用户菜单**，在你的姓名和角色旁边，关闭时需要输入账户密码——建议先与开启它的人沟通一致，因为关闭会移除这层额外保护。

## 为什么我某个操作人的 2-Step Verification 开关是灰色的？

该列在**角色不可编辑**的行上是禁用的——即 *Edit* 和 *Remove* 操作同样为灰色的那些行，包括所有者级别的角色。在操作人列表中无法更改这类人员的两步验证设置；他们要在自己的用户菜单中自行更改。

## 我换了手机收不到验证码，怎么办？

Portal 的验证码通过**邮件**发送到你账户的登录邮箱。不涉及手机号，也不涉及短信，所以换手机或换号码不会有任何影响——请从邮箱入手：

1. 检查 *Verification* 对话框中显示的邮箱地址，包括垃圾邮件文件夹。验证码有效期 10 分钟，任何未过期的验证码都有效，所以先前的邮件仍然可用。
2. 倒计时结束后使用 **Resend**。
3. 如果仍然收不到，按对话框提示*联系你的 Admin 寻求帮助*——Admin 可以在 `Settings` 下操作人列表的 `2-Step Verification` 列为你关闭两步验证。

自行关闭需要处于已登录状态，所以它无法帮你脱离已失去访问权的邮箱；Admin 兜底才可以。如果联系不上任何 Admin，请[联系支持](mailto:support@waffo.com)。

这些对话框背后的登录机制——challenge 响应、重发 token，以及每个开关调用的接口——见
[Portal 自助安全配置](/docs/zh/support/portal-security-config-faq)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.