跳到主要内容

后台多商户注册操作手册

· 阅读需 9 分钟
UtcPay 支持
UtcPay 支持
UtcPay 商务&支持团队

文档说明​

本文介绍如何通过 TronLink / MetaMask 的子钱包功能，使用 4 组助记词（3 组多签管理员 + 1 组财务）对应 4 个主钱包，管理多个商户账号，并完成以下操作：

  • 创建子钱包，分别用于各商户的多签管理员和财务地址
  • 注册新商户并配置多签管理员和财务钱包
  • 获取 API Key 供开发团队对接
核心思路

需要分别妥善保管 4 组助记词（3 组多签管理员 + 1 组财务）。其中每一组助记词都可以按不同派生路径管理多个地址（主钱包 + 多个子钱包），再通过 4 条分支共同完成多个商户的注册与管理。

补充说明：什么是 HD 钱包​

HD 钱包（Hierarchical Deterministic Wallet，分层确定性钱包）是一种基于助记词按固定规则分层派生地址的钱包模型。

  • 一组助记词可恢复该组下的全部账户与地址。
  • 同一组助记词可以持续派生并管理多个地址，不需要为每个新地址单独生成新助记词。
  • 主钱包与子钱包本质上是同一组助记词下不同派生路径的账户。
  • 只要派生路径一致，在不同设备中也能恢复出相同地址。

结合本文场景可这样理解：

  • 你会维护 4 组助记词，对应 4 个主钱包（3 个多签管理员 + 1 个财务）。
  • 每个商户都从这 4 个主钱包分别派生 1 个子钱包。
  • 因为每个地址都有确定的派生来源，所以多商户管理更清晰，权限隔离也更直观。
重点理解

“同一组助记词可管理多个地址”是 HD 钱包的基础能力。本文是在这个能力之上，采用 4 组助记词分别管理 4 条派生分支（3 组多签管理员 + 1 组财务），再由各分支为不同商户生成对应子钱包。

一、适用场景​

如果你需要为多个商户重复执行注册流程，同时希望降低助记词管理复杂度，这种做法会更适合：

  • 使用 4 个主钱包作为固定基础账户（3 个多签管理员主钱包 + 1 个财务主钱包）
  • 每注册一个新商户，就从这 4 个主钱包下分别派生 1 个子钱包
  • 其中 3 个子钱包作为该商户的多签管理员，1 个子钱包作为财务钱包

二、钱包结构与前置条件​

在注册新商户前，先确认钱包层级结构与必要参数。

钱包层级结构​

  • 第一层：4 组助记词（3 组多签管理员 + 1 组财务） 说明：每组助记词独立保管，分别对应 1 个主钱包
  • 第二层：3 个多签管理员主钱包 + 1 个财务主钱包 说明：由各自助记词分别派生，TRON 与 EVM 链均可使用
  • 第三层：子钱包 说明：每个主钱包各派生 1 个子钱包，3 个子钱包作为多签管理员，1 个子钱包作为财务钱包

示意流程：

注册前需要准备​

  • 多签管理员主钱包：3 个，分别由 3 组多签管理员助记词派生
  • 财务主钱包：1 个，由财务助记词派生
  • 每商户子钱包：4 个，分别来自上述 4 个主钱包
  • 注册码：需联系商务获取
  • 适用链：TRON 与 EVM 链流程一致
安全提醒
  • 管理员钱包和财务钱包拥有重要权限，必须妥善保管助记词与私钥。
  • 严禁将助记词或私钥泄露、共享给其他人。

三、创建管理员与财务子钱包地址​

参考文档：TronLink 钱包创建教程

操作思路如下：

  1. 切换到多签管理员主钱包 1，确认当前账户为主钱包 1。

    主钱包

  2. 在 TronLink 中进入添加钱包流程。

    切换钱包

    添加钱包

  3. 选择“创建子账户”，选择 TRON 链，并填写子钱包名称，例如“商户A多签管理员1”。

    生成子账户

    选择网络

    填写名称

  4. 创建完成后，复制该子钱包地址备用。

    点击创建

    复制地址

  5. 依次切换到多签管理员主钱包 2、3，以及财务主钱包，各自派生 1 个子钱包，分别命名为“商户A多签管理员2、3”及“商户A财务钱包”。

  6. 得到 4 个子钱包地址后，用它们注册商户 A。注册步骤参考下文。

    注册商户

  7. 商户注册成功后，切换到对应子账户登录后台。

    使用子账户登录

多商户复用方式

注册商户 B 时，同样从 3 个多签管理员主钱包和 1 个财务主钱包下各派生 1 个新子钱包，例如“商户B多签管理员1 ~ 3”及“商户B财务钱包”。每个商户使用独立的 4 个子钱包，彼此不要混用。

方式二：使用 MetaMask 创建子钱包（EVM 链）​

参考文档：MetaMask 官方入门教程

操作思路如下：

  1. 打开 MetaMask，切换到多签管理员主钱包 1。

    主钱包

  2. 点击“添加账户”或“创建新账户”，在主钱包 1 下派生 1 个子账户。

    添加账户

    添加成功

  3. 为子账户重命名，例如“商户A多签管理员1”，并复制地址备用。

    选择账户功能

    重命名

    保存命名

    点击收款

    复制地址

  4. 依次切换到多签管理员主钱包 2、3，以及财务主钱包，各派生 1 个子账户。

  5. 最终得到 4 个子账户地址，用于注册同一个商户。

命名建议

建议统一采用“商户名 + 管理员编号/财务” 的命名方式，例如“商户A多签管理员1”、“商户A财务钱包”，后续排查和权限管理会更清晰。

四、注册 UtcPay 管理员后台​

使用前面创建好的 3 个多签管理员子钱包和 1 个财务子钱包地址，前往注册入口完成商户注册。

注册入口（沙盒环境）：https://adm-sandbox.utcpay.com/signUp

注册步骤​

  1. 打开注册链接。

    注册表单

  2. 机构类型选择“标准版”。

  3. 区块链选择对应链，例如 TRON 或 ETH。

  4. 填写注册码。需联系商务获取。

  5. 填写 3 个多签管理员地址和 1 个财务钱包地址，也就是前面准备好的 4 个子钱包地址。

  6. 核对信息无误后点击“提交”。

  7. 等待 UtcPay 完成审批。

地址填写规则

同一商户的 3 个多签管理员地址和 1 个财务钱包地址必须分别来自 4 个不同的主钱包派生路径，避免将同一主钱包下的多个角色误当作独立身份。

五、登录管理员后台并获取 API Key​

1. 登录链管理员后台​

使用对应链的管理员钱包登录后台。

登录后台

  • 如果是 TRON 链管理员账号，区块链类型请选择 Tron
  • 如果是 EVM 链管理员账号，则选择对应 EVM 网络

2. 获取 API Key​

  1. 登录后进入“机构信息”页面。

  2. 点击“重置 API Key”。

    重置 API Key

  3. 复制 API Key 和 API Secret。

    复制 API Key 和 API Secret

  4. 将 API Key / API Secret 提供给开发团队，用于后续系统对接。

重要提示

API Secret 仅在重置时显示一次。请立即保存，否则只能再次重置。

六、开通其他链和币种​

商户注册成功后，可继续开通更多链和币种，参考以下文档：

配置建议

首次配置最大可提取额度时，建议参考现有商户的数据口径进行设置，保持多商户配置的一致性。