跳到主要内容

商户管理

商户管理是后台系统的核心功能之一，用于管理平台上的商户（也称为"平台"），包括商户资料维护、服务配置和渠道开通。

功能概述​

商户管理主要包括以下功能：

  • 商户列表查看：查看所有商户的基本信息和状态
  • 新增商户：创建新的商户账号
  • 编辑商户：修改商户资料和配置
  • 渠道管理：为商户开通和配置支付渠道
  • 服务配置：设置商户可用的服务和费率
  • 余额查看：查看商户在各渠道的余额情况
  • 金钥管理：重置商户 API 金钥
  • 白名单管理：配置商户的 IP 白名单

页面说明​

商户列表页面​

路径：Business → Platforms

主要字段：

字段说明
商户编号唯一标识符，格式如 PF0001
商户名称商户的显示名称
UU收款模式USDT 收款模式：金额匹配 / 专属地址
已开通渠道该商户已配置的支付渠道数量
调试模式是否开启调试模式（每日 00:00 自动关闭）
人民币换u点差CNY→USDT 汇率点差（基点）
u换人民币点差USDT→CNY 汇率点差（基点）
货币自动转换是否开启自动货币转换
审核代付代付审核模式：关闭/手动审核/自动审核
上级代理所属代理商编号

筛选功能​

  • 商户筛选：可按商户编号和名称搜索
  • 代理筛选：可按代理编号筛选商户

[!TIP] 使用筛选功能可以快速定位特定商户，支持模糊搜索。

主要操作​

1. 新增商户​

点击页面右上角的「新增商户」按钮，填写以下信息：

必填字段：

  • 商户编号（唯一，建议格式：PF + 数字）
  • 商户名称
  • 电子邮箱（用于接收 API 金钥）
  • 上级代理（可选）

配置项：

  • UU收款模式
  • 调试模式
  • 货币换算点差
  • 自动转换类型
  • 审核代付模式

[!IMPORTANT] 商户编号一旦创建不可修改，请谨慎填写。创建成功后，系统会自动生成 API 金钥并发送到指定邮箱。

2. 修改商户资料​

点击商户列表中的「修改」按钮，可以编辑商户的配置信息：

  • 商户名称
  • 电子邮箱
  • 各项配置参数

3. 查看已开通渠道​

点击「已开通渠道」列的数字按钮，会弹出该商户的渠道列表：

渠道信息包括：

  • 渠道名称
  • 渠道类型（收款/付款）
  • 渠道状态（正常/禁用）
  • 余额
  • 冻结余额
  • 在途金额（如启用 T+模式）
  • 费率配置

渠道操作：

  • 调整冻结余额
  • 修改费率
  • 启用/禁用渠道

[!NOTE] 可以通过「显示零余额渠道」开关控制是否显示余额为 0 的渠道。

4. 重置金钥​

点击「重置金钥」按钮可以重新生成商户的 API 金钥：

  1. 系统会弹出确认对话框
  2. 确认后，旧金钥立即失效
  3. 新金钥会发送到商户邮箱

[!WARNING] 重置金钥后，使用旧金钥的 API 调用将全部失败。请确保商户已做好更新准备。

5. 删除商户​

点击「删除」按钮可以删除商户：

[!CAUTION] 删除操作不可恢复！请确保：

  • 该商户没有未完成的订单
  • 所有渠道余额已清零
  • 已通知商户停止使用 API

商户服务配置​

展开商户列表的折叠行可以查看该商户已开通的服务：

服务信息：

  • 服务编号（如 SVC0001）
  • 服务名称
  • 费率类型：固定费用 / 千分比费率
  • 费率数值

白名单管理​

路径：Business → PlatformsWhiteList

用于配置商户的 IP 白名单，只有白名单内的 IP 可以调用 API。

操作：

  • 新增 IP 白名单
  • 修改白名单规则
  • 删除白名单

[!TIP] 设置白名单可以提高 API 安全性，建议所有生产环境商户都配置白名单。

常见问题​

Q: 商户调试模式有什么用？​

A: 开启调试模式后，API 返回错误时会包含更详细的错误信息，包括签名验证的详细说明。主要用于商户集成调试阶段。为安全考虑，系统会在每日 00:00 自动关闭调试模式。

Q: UU收款模式的区别是什么？​

A:

  • 金额匹配：使用金额匹配的方式确认收款（适用于金额唯一性的场景）
  • 专属地址：为每笔订单生成专属的收款地址（安全性更高）

Q: 如何查看商户的渠道余额？​

A: 点击「已开通渠道」查看详细列表，每个渠道会显示当前余额、冻结余额和在途余额。

Q: 费率配置在哪里修改？​

A: 在商户的渠道列表中，点击对应渠道的修改按钮，可以调整该渠道的费率配置。

相关页面​