分销商设置指南 — 端到端入驻一个商户

P2P 转账平台 · 中文版

关于截图的说明： 本手册中的所有截图均为英文（与系统实际抓取的界面一致）。因此，界面上的菜单名与按钮名保留英文，方便您与实际画面一一对应；说明文字则为中文。

一份面向分销商运营者（reseller operator）的分步指南，用于建立一个新商户：创建商户、为其所有者提供登录账号，并接通资金通道（凭证核验、支付网关、银行账户）。

⚠️ 正在开发中： 凭证核验服务商与支付网关页面仍在完善中——字段标签可能与此处所示略有出入。

目录

• 开始之前
• 1. 创建商户
• 2. 创建商户所有者账号
• 3. 设置凭证核验服务商（分销商级）
• 4. 设置支付网关
• 5. 设置银行账户（分销商级）
• 快速参考

开始之前

1. 您需要运营者授权（operator grant）。 全部五项操作都要求您的分销商已由平台管理员开启 “can create merchants”（可创建商户） 授权。若无此授权，这些页面会显示 "You are not permitted to… Ask an administrator to enable this for your reseller." 请让管理员开启（admin → Resellers → 您的分销商 → 切换 Can create merchants）。

2. 谁能做什么：

3. 通道如何选择（继承）。 对于凭证核验、支付网关和银行账户中的每一项，商户若有自己的设置则用自己的，否则用您的（分销商级），再否则用平台默认：

商户 → 分销商 → 平台

因此，把分销商级（第 3、4a、5 步）设置一次，您拥有的每个商户都会继承——或在某个商户需要自有通道时按商户覆盖（第 4b 步）。

4. 功能开关（feature flag）。 您的分销商级支付网关（第 4a 步）和银行账户（第 5 步）只有在 FEATURE_RESELLER_GATEWAY_TIER 为 ON 时才会进入实时充值路由（多数环境默认 OFF）。凭证服务商层（第 3 步）无论如何都是生效的。

1. 创建商户

创建商户、将其分配给您、设定其费率，并把它的 API 凭据交给您。

位置： 分销商门户 → Merchants → Create merchant

步骤：

1. Slug — 商户的唯一标识。3–64 个字符：小写字母、数字和连字符（例如 acme-store）。
2. Display name — 商户的可读名称（例如 Acme Store）。
3. Webhook URL (HTTPS) — 平台将向其 POST 结算事件的地址。必须为 https://。
4. Pay-in rate (%) — 商户支付的充值费率。表单实时显示您的下限与利润："Platform base 0.50% · your margin 1.00%"。您不能低于平台基准——过低的费率会以红色显示 "Below your platform base of 0.20% — raise this rate"。
5. Pay-out rate (%) — 提现费率，同样的下限规则。
6. 接受 DPA — 勾选 "I accept the platform Data Processing Agreement on behalf of this merchant." 只有您接受后，商户才会上线（Active）；否则将创建为暂停（Suspended）。
7. 点击 Create merchant（所有字段有效后启用）。

结果： 商户的 API 密钥（sen_live_…）与 HMAC 密钥仅显示一次——请立即复制并安全交给商户；此后不再显示。商户虽已创建，但在拥有支付通道前无法交易（见第 4 步）。

常见问题：

• 费率被拒 → 您的费率低于平台基准；请提高。
• Slug 已被占用 → 换一个 slug。
• "Not permitted" → 未开启运营者授权（见“开始之前”）。

2. 创建商户所有者账号

为商户提供第一个后台登录账号（Merchant Owner），之后其可自行邀请运营者和查看者。

位置： 分销商门户 → Merchants → 打开该商户 → Back-office staff 区域

步骤：

1. 从您的 Merchants 列表打开该商户，滚动至 Back-office staff。
2. 在 Add a staff login 下填写： - Email — 所有者的登录邮箱。 - Name — 姓名（例如 John Fulton）。 - Role — 选择 Owner (full access)（也可选 Operator、Viewer）。
3. 点击 Create login。

结果： 一个临时密码仅显示一次——复制并交给所有者（他们在首次登录时设置永久密码并绑定 2FA）。此后所有者会出现在员工列表中，并带有 Reset credentials 操作，以备其丢失访问权限（会签发新的临时密码、清除其 2FA 并结束其会话）。

常见问题：

• 邮箱已被使用 → 该邮箱在此商户下已有员工账号。
• "Not permitted" → 此为 OWNER 专属，且需要运营者授权。

3. 设置凭证核验服务商（分销商级）

注册您的凭证核验服务商密钥；您拥有的、没有自己配置的每个商户都会继承它。

位置： 分销商门户 → Slip providers

步骤：

1. 在 Provision your slip-verify provider key 中，选择 Provider（例如 EasySlip、MockBank、HippoPay）。
2. 输入 API key（加密存储，不再显示）。
3. 可选填 Base URL（留空则使用服务商的标准端点）。
4. 点击 Provision。此步骤会一次性轮换掉此前生效的密钥。
5. 在表格中点击 Test 以验证连接——粘贴一个真实的 QR payload（可选填预期金额）并 Run test；您会看到成功与延迟，或服务商的错误。
6. 用 Activate / Deactivate 控制哪个密钥生效。若无生效密钥，您的商户会回落到平台默认。

结果： 每个分销商一个生效服务商，被您所有没有自己配置的商户继承。

常见问题：

• "Not permitted" → 需要 MANAGE_SLIP_PROVIDERS 加运营者授权。

4. 设置支付网关

支付网关是让商户能够接收充值的东西。您可以在分销商级（您所有商户继承）或按商户（仅一个）设置。

4a. 分销商级 — 您所有商户继承

位置： 分销商门户 → Payment gateways

步骤：

1. 在 Provision your payment-gateway account 中，输入 API key 与 API secret（均加密存储，不再显示）。
2. 可选添加 Label（例如 Primary account）与 Base URL。
3. 点击 Provision（轮换掉此前生效的凭据）。
4. 在该行点击 Test 以检查连通性——您会看到网关余额与延迟，或错误。
5. 用 Activate / Deactivate 控制哪个凭据生效。

⚠️ 别忘了功能开关： 分销商级网关只有在 FEATURE_RESELLER_GATEWAY_TIER 为 ON 时才会进入实时充值路由。

4b. 按商户 — 仅此商户

位置： 分销商门户 → Merchants → 打开该商户 → Payment gateway 区域（见第 2 步的截图——右栏："Register the payment rail so this merchant can accept deposits."）

步骤：

1. 打开该商户。在 Payment gateway 中，留意其状态（"No payment gateway registered yet — this merchant cannot take payments until one is added."）。
2. 在 Register a PGWAY gateway 下，输入 API key、API secret，以及可选的 Label 和 Base URL。
3. 点击 Register。
4. 用现有行上的 Activate / Deactivate 控制生效凭据。

结果： 注册第一个网关后，该商户即可交易。没有自有网关的商户会回落到您的分销商级网关（若已启用），再到平台。

常见问题：

• "Not permitted" → 按商户为 OWNER 专属；两个层级都需要运营者授权。

5. 设置银行账户（分销商级）

向您的分销商资金池添加一个银行账户；经您分销商通道路由的充值可落入此处。

位置： 分销商门户 → Bank accounts

步骤：

1. 在 Add your bank account 中，选择 Bank（泰国银行列表，例如 Kasikornbank / KBANK）。
2. 输入 Account holder name（例如贵公司名称）。
3. 输入 Account number（数字，6–32 个字符）。
4. 点击 Add account。您的账户会立即被核验（vouched）并加入您的资金池。
5. 用 Activate / Deactivate 将账户纳入或排除出路由（级联会在生效账户间轮询，并跳过停用账户）。

⚠️ 功能开关： 这些账户只有在 FEATURE_RESELLER_GATEWAY_TIER 为 ON 时，才通过级联的分销商环节接收充值。

结果： 经核验的分销商自有银行账户；保存后始终只显示后四位。允许多个账户（没有“仅一个生效”的限制——各账户可独立切换）。

常见问题：

• 重复 → 该银行加账号已在您的资金池中。
• "Not permitted" → 需要充值通道运营者权限加运营者授权。

快速参考

全部六项都需要： 分销商状态为 ACTIVE 加平台授权 can create merchants。分销商级网关（4a）与银行账户（5）还需 FEATURE_RESELLER_GATEWAY_TIER 为 ON 才能影响实时路由。