用户手册 — 分销商门户（Reseller Portal）
P2P 转账平台 · 中文版
关于截图的说明： 本手册中的所有截图均为英文（与系统实际抓取的界面一致）。因此，界面上的菜单名与按钮名保留英文，方便您与实际画面一一对应；说明文字则为中文。
分销商门户（Reseller Portal）面向将商户引入 P2P 平台并从其使用中赚取差价的商业合作伙伴。作为分销商，您创建并管理一组商户、设定他们支付的费率、与下级代理分享您的利润、定制品牌体验，并跟踪您的收入——而这一切都无需触及商户底层的支付流程。
本手册以操作者优先为原则。技术主题——配置您自己的支付网关和凭证核验服务商——放在附录 A。
目录
- 开始之前 — 分销商模型
- 1. 登录
- 2. 仪表盘（Dashboard）
- 3. 您的商户
- 4. 费率（Fees）
- 5. 收入分成（MDR）
- 6. 报表（Reports）
- 7. 员工（Staff）
- 8. 品牌与白标
- 附录 A — 服务商凭据
- 附录 B — 术语表
本版本说明： 少数页面所记录的能力取决于您的环境——分销商仪表盘是占位页面，分销商级支付网关位于功能开关（feature flag）之后。两者在出现之处均已清楚标注。
开始之前 — 分销商模型
分销商是什么。 在商业上您位于商户之上，但您有意地不与他们硬性绑定。您与商户之间的联系是一条带日期的分配关系（dated assignment），而非硬性挂钩——因此商户可以被重新分配或迁移，而丝毫不影响其支付。
您如何盈利 — 费率瀑布（fee waterfall）。 可以把它想象成批发买入使用量再转售出去：
- 平台设定基准费率（base rate）——既是下限，也是平台自己的分成。
- 您设定商户的费率，该费率绝不能低于基准。
- 差额——商户费率 − 平台基准 = 您的差价（spread）——就是您的毛利。
- 您可以将差价的一部分分享给 MDR 下级用户（MDR sub-users）（您自己的下级代理）。
- 扣除他们的分成后剩下的，就是您的净利。
费用有两种，各自独立设定：PAYIN（对充值计费）和 PAYOUT（对提现计费）。
谁能做什么 — 分销商角色：
| 权限 | OWNER | STAFF | MDR |
|---|---|---|---|
| 查看商户与报表 | ✅ | ✅ | ✅ (仅限其分成的商户) |
| 设定费率 · 管理分组 | ✅ | ✅ | — |
| 创建商户 · 管理商户员工与网关 | ✅ | ✅ | — |
| 管理 MDR 下级用户及其分成 | ✅ | ✅ | — |
| 品牌 · 分销商员工 · 服务商凭据 | ✅ | ✅ | — |
- OWNER 与 STAFF 权力对等——STAFF 拥有与 OWNER 相同的权限。（由管理员创建的最初创始所有者受到保护：共同所有者无法将其锁定在外。）
- MDR 是只读的下级代理，仅能看到其获得分成的商户。
1. 登录
/reseller/login 的分销商登录界面。每次登录、每位分销商用户都需两步：
- 在
/reseller/login输入邮箱 + 密码。 - 输入身份验证器应用中的 6 位验证码。
首次登录？ 首次登录（使用管理员或所有者签发的临时密码）将运行初始设置（onboarding）：设置永久密码（至少 12 个字符，含字母和数字），扫描 TOTP 二维码，并确认一次验证码。
2. 仪表盘（Dashboard）
您登录后的落地页。
⚠️ 开发中： 仪表盘目前只是一个简单的欢迎页。日常工作在 Merchants、Reports 和 Revenue sharing 中进行。
3. 您的商户
Merchants 是您的商户组合。每行显示商户的 slug 与名称、状态、当前 PAYIN/PAYOUT 费率，以及本月至今的使用量与费用。点击某行可打开其详情页。
创建商户
如果您被设置为运营者，Create merchant 允许您自行入驻商户。填写唯一的 slug、显示名和 webhook URL，设定 PAYIN/PAYOUT 费率（表单会显示平台下限，且不允许低于它），并接受 DPA。成功后，商户的 API 密钥和 HMAC 密钥仅显示一次——请立即复制并交给商户。若未接受 DPA，商户将以暂停状态开始；否则立即生效。
商户详情
商户页面汇集了关于该商户的一切：使用报表（usage report）（天 / 周 / 月，GMT+7）、其费率计划历史（fee-schedule history）、其子商户，以及——面向获授权用户的——Set fee 表单。如果您是运营者，还可在此注册该商户的支付网关，并邀请其后台员工。
4. 费率（Fees）
设定商户的费率
在商户详情页，Set fee 用于从选定日期起更改 PAYIN 和/或 PAYOUT 费率。费率以基点（basis points，显示为 %）输入，并以平台基准为下限——试图低于它，表单会拒绝更改并显示该下限。费率更改是仅追加（append-only）的历史：每次更改都会写入一条新的带日期记录，且仅影响自其生效日期起的使用量。
分组（Groups）
Groups 让您一次管理多个商户。创建分组，添加或移除成员，然后一步对每位成员应用批量费率（bulk fee）（每位仍以平台基准为下限）。直接在某商户上设定的费率会覆盖其分组费率。
5. 收入分成（MDR）
这是您与下级代理分享差价的方式。
MDR 下级用户（MDR sub-users）
MDR users 是您的下级代理。用邮箱和显示名创建一个——系统会显示一次性临时密码供交接。您可在此重置下级用户的凭据或将其停用。
分配分成
MDR sharing 是您向下级用户授予您差价百分比之处——按商户或按分组、按费用类型（PAYIN/PAYOUT）、从选定日期起。有一条硬性规则：某商户上所有分成之和不得超过您的差价——若您尝试超过，系统会阻止。将分成设为 0 即可移除。下方的概览按下级用户对分成进行分组，并显示各自本月至今的收入。
My sharing（面向下级用户）
My sharing 是下级用户自己的视图：他们赚取分成的商户、其分成 % 以及本月至今的收入。它是只读的——只有所有者才能更改分成。
6. 报表（Reports）
Report 是您在某日期范围（GMT+7）内的收入摘要。头部卡片显示总使用量、商户费用总额、平台收入总额，以及——最重要的数字——您的分销商毛利（reseller gross）。一张按商户的表格进行明细拆分。（您下级代理的分成显示在 MDR sharing 页面，按商户列出。）
7. 员工（Staff）
Staff 是所有者添加共同所有者（RESELLER_STAFF）之处——他们拥有与您相同的权力。用邮箱和显示名创建一个（显示一次性临时密码），之后可重置或停用。创始所有者受到保护，共同所有者无法修改。
8. 品牌与白标
Branding 让体验成为您的。上传徽标（logo）并设置主色与强调色（primary and accent colours）（附实时预览）。您的品牌将贯穿至：您商户的托管收银页、其后台 UI，以及一个带您品牌的公开 API 文档页（其 URL 在此显示）。若有任何缺失，将使用平台默认值——品牌设置从不会让页面出错。
附录 A — 服务商凭据（运营者 / ops）
如果您以运营者（operator）身份运作，可以提供您自己的支付通道与凭证核验，您的商户会自动继承（除非某商户自有）。
分销商支付网关
注册您分销商级的支付网关凭据（API 密钥、密钥、base URL）。分配给您的每个商户都会通过它路由充值，除非该商户自有网关。您可以测试（test）连接，并启用或停用该凭据。密钥经加密存储，从不显示。
⚠️ 开发中： 该分销商级网关位于功能开关（feature flag）之后，在您的环境中可能默认关闭。
分销商凭证核验服务商
注册您自己的凭证核验服务商（例如 PromptPay 或 TrueWallet）。您的商户会继承它用于核验充值凭证，遵循解析顺序 商户 → 分销商 → 平台。启用前请先测试（test）；注册一个新的会将此前生效的服务商轮换下线。
附录 B — 术语表
- MDR — Merchant Discount Rate（商户折扣率）；在此指您向商户收取的费率以及您赚取的利润。
- Spread（差价） — 商户费率减去平台基准；即您的毛利。
- PAYIN / PAYOUT — 费用类型，分别对充值 / 提现计费。
- MDR sub-user（MDR 下级用户） — 您向其授予差价分成的下级代理。
- Group（分组） — 您一并管理并统一设定费率的一组商户。
- Assignment（分配关系） — 您与商户之间带日期的联系（并非硬性挂钩）。