跳到主要内容

渠道管理概览

渠道管理功能用于管理平台的支付渠道，包括渠道配置、余额管理和服务绑定。

功能概述​

渠道管理主要包括以下功能：

  • 渠道列表：查看所有支付渠道
  • 渠道配置：编辑渠道参数和限额
  • 渠道服务：管理渠道支持的服务类型
  • 余额管理：查看渠道余额和变动记录
  • 渠道状态：启用/禁用渠道

页面说明​

渠道列表页面​

路径：Channel → ChannelList

主要字段：

字段说明
渠道 ID唯一标识符
渠道名称渠道的显示名称
渠道类型上游渠道提供商类型
货币支持的货币类型（CNY, USDT, VND 等）
余额当前可用余额
状态正常/禁用

主要功能​

1. 渠道列表（ChannelList）​

查看所有已配置的支付渠道。

主要信息：

  • 渠道基本信息
  • 当前余额状态
  • 渠道运行状态

操作：

  • 编辑渠道配置
  • 启用/禁用渠道
  • 查看渠道详情

2. 渠道服务（ChannelService）​

路径：Channel → ChannelService

管理渠道支持的服务类型。

功能：

  • 查看渠道支持的服务列表
  • 添加新服务到渠道
  • 编辑服务配置
  • 移除服务

服务绑定逻辑：

  • 一个渠道可以支持多个服务
  • 一个服务可以绑定多个渠道
  • 商户通过服务 ID 调用，系统自动路由到可用渠道

[!NOTE] 服务绑定决定了商户可以使用哪些渠道。只有绑定了对应服务的渠道才能处理该服务的订单。

3. 渠道详情（ChannelDetail）​

查看单个渠道的详细信息：

包含内容：

  • 渠道基本配置
  • API 配置信息
  • 限额设置
  • 费率配置
  • 余额状态

4. 渠道余额记录（ChannelBalanceRecord）​

路径：Channel → ChannelBalanceRecord

查看渠道的余额变动历史。

记录信息：

  • 变动时间
  • 变动类型（收款/付款/调整/补单等）
  • 变动金额
  • 变动前后余额
  • 关联订单号
  • 备注说明

筛选功能：

  • 按时间范围筛选
  • 按变动类型筛选
  • 按渠道筛选

[!TIP] 渠道余额记录可以帮助追踪资金流向，排查余额异常问题。

渠道类型说明​

收款渠道​

用于处理收款（代收）业务的渠道。

特点：

  • 接收客户支付
  • 余额增加
  • 需要对接上游收款接口

付款渠道​

用于处理付款（代付）业务的渠道。

特点：

  • 向用户付款
  • 余额减少
  • 需要对接上游付款接口

双向渠道​

同时支持收款和付款的渠道。

渠道状态管理​

状态类型​

1. 正常（Status = 1）

  • 渠道正常运行
  • 可以处理订单

2. 禁用（Status = 0）

  • 渠道暂停使用
  • 不会分配新订单
  • 已有订单可继续处理

禁用场景​

建议在以下情况禁用渠道：

  • 渠道维护升级
  • 余额不足无法付款
  • 上游渠道故障
  • 费率调整期间

[!WARNING] 禁用渠道前，请确认该渠道没有大量进行中的订单，避免影响业务。

渠道限额设置​

限额类型​

收款限额：

  • 单笔最低金额（payment_lower_bound）
  • 单笔最高金额（payment_upper_bound）

付款限额：

  • 单笔最低金额（payout_lower_bound）
  • 单笔最高金额（payout_upper_bound）

限额规则​

  • 限额以「分」为单位存储，显示时除以 100
  • 0 表示不限制
  • 订单金额必须在限额范围内才能使用该渠道

示例：

payment_lower_bound = 10000  -> 最低 100 元
payment_upper_bound = 5000000 -> 最高 50,000 元

编辑渠道配置​

点击渠道列表的「编辑」按钮可以修改：

基本信息：

  • 渠道名称
  • 渠道描述

限额设置：

  • 收款/付款单笔限额

API 配置：

  • API 密钥
  • 回调地址
  • 其他渠道特定配置

费率配置：

  • 渠道成本费率
  • 费率类型

[!CAUTION] 修改 API 配置可能导致渠道调用失败，请在测试环境验证后再应用到生产环境。

常见问题​

Q: 如何判断渠道是否正常工作？​

A: 可以通过以下方式检查：

  1. 查看渠道状态是否为「正常」
  2. 查看最近的订单记录
  3. 查看渠道余额变动记录
  4. 使用运营工具创建测试订单

Q: 渠道余额不足怎么办？​

A:

  1. 联系上游渠道补充余额
  2. 暂时禁用该渠道，避免订单失败
  3. 调整商户的渠道路由策略

Q: 如何为渠道添加新服务？​

A: 进入「渠道服务」页面，选择渠道和要添加的服务，创建服务绑定关系。

Q: 渠道编辑后多久生效？​

A: 配置修改立即生效，影响后续创建的新订单。

相关页面​