佣金规则与提现
佣金规则与提现
佣金规则决定了代理商从客户消费中获取的分成比例。欣悦互通支持多级佣金体系，平台可灵活配置不同套餐、不同层级的佣金比例。代理商可在后台查看佣金流水并申请提现。
本篇介绍佣金规则管理、多级佣金计算、佣金流水查看、提现申请和结算状态转换五方面内容。
佣金规则管理
查看佣金规则
- 以平台管理员身份登录，进入「代理分销 → 佣金规则」。
- 列表展示规则名称、适用套餐、佣金比例、分级配置、状态。
- 支持按套餐筛选。
佣金规则列表通过 GET /api/agency/commission-rules 获取。
创建佣金规则
- 点击「新增规则」。
- 填写规则信息：
- 规则名称（便于识别）
- 适用套餐（可多选，或全部套餐）
- 计算方式（按订单金额百分比/固定金额）
- 佣金比例
- 分级配置（多级佣金比例）
- 点击「确定」保存。
系统调用 POST /api/agency/commission-rules 创建规则。
{
"name": "标准佣金方案",
"plans": ["basic", "pro", "enterprise"],
"calcType": "percentage",
"rates": [
{ "level": 1, "rate": 0.20 },
{ "level": 2, "rate": 0.10 },
{ "level": 3, "rate": 0.05 }
]
}
!TIP
- 建议为不同档位套餐设置不同佣金比例，高价套餐可设置更高比例激励代理商推广。
- 佣金规则修改后对新增订单生效，历史订单仍按原规则计算。
多级佣金计算
v12 升级后，支付成功后自动触发多级佣金计算，无需手动调用计算接口。系统在订单状态变更为「已支付」时，自动按代理商层级逐级分账：
- 一级代理获得对应比例佣金
- 二级代理获得对应比例佣金
- 三级代理获得对应比例佣金
多级佣金按代理商层级自动分配。例如客户 A 通过一级代理 B 的链接注册，B 又是上级代理 C 的下级，则客户 A 的订单佣金按如下方式分配：
- 一级代理 B 获得 20%
- 二级代理 C 获得 10%
- 三级代理（如有）获得 5%
佣金计算示例
假设客户订单金额为 1000 元，佣金规则为「20%-10%-5%」：
- 一级代理获得：1000 × 20% = 200 元
- 二级代理获得：1000 × 10% = 100 元
- 三级代理获得：1000 × 5% = 50 元
- 平台收入：1000 - 200 - 100 - 50 = 650 元
可通过 POST /api/agency/calculate-commission 预计算某订单的佣金分配：
POST /api/agency/calculate-commission HTTP/1.1
Content-Type: application/json
{
"orderId": "ORD20260624001",
"amount": 1000
}
返回结果包含各级代理的应得佣金明细。
!NOTE
- 佣金计算基于订单实付金额，不含优惠券抵扣部分。
- 退款订单会按原比例扣减各级代理的佣金。
佣金流水查看
- 代理商登录后台，进入「代理分销 → 佣金流水」。
- 列表展示：订单编号、客户名称、订单金额、佣金比例、佣金金额、状态、时间。
- 支持按时间范围、状态筛选。
佣金流水通过 GET /api/agency/commission-records 获取，状态包含：
- 待结算：订单已支付但未到结算周期
- 已结算：佣金已结算到代理商余额
- 已扣减：订单退款导致佣金扣减
!TIP
- 佣金流水默认按时间倒序展示。
- 佣金结算周期通常为订单支付后 T+7（7 天后结算），具体以协议为准。
提现申请和管理
申请提现
- 代理商进入「代理分销 → 提现管理」。
- 点击「申请提现」。
- 填写提现信息：
- 提现金额（不低于最低提现额度）
- 收款账户（银行卡/支付宝）
- 收款信息
- 点击「提交」发起申请。
系统调用 POST /api/agency/withdrawals 创建提现申请，提现金额从代理商余额中冻结。
提现状态说明
- 待审核：申请已提交，等待平台审核
- 审核通过：审核通过，等待打款
- 已打款：资金已转出
- 已驳回：审核未通过（信息有误或不符合规则）
- 已取消：代理商主动取消
!WARNING
- 提现申请提交后无法修改金额，如需调整请取消后重新申请。
- 提现到账时间通常为 1-3 个工作日，节假日顺延。
提现审核（v12 新增）
平台管理员可直接通过专用审核端点处理提现：
POST /api/agency/withdrawals/{id}/approve— 审核通过POST /api/agency/withdrawals/{id}/reject— 审核驳回（需填写驳回原因）
审核通过后佣金余额自动扣减，等待管理员确认打款。
查看提现记录
- 在提现管理页查看所有提现记录。
- 平台管理员可查看所有代理商的提现申请，并进行审核操作。
提现列表通过 GET /api/agency/withdrawals 获取。
结算账户管理（v12 新增）
代理商可管理自己的结算账户，用于接收佣金打款：
GET /api/agency/settlement-accounts— 查看结算账户列表POST /api/agency/settlement-accounts— 添加结算账户（支持银行卡/支付宝）
每个代理商可绑定多个结算账户，提现时可选择指定账户收款。
结算状态转换
平台管理员可手动推进提现的结算状态：
- 在提现列表中点击「审核」。
- 选择「通过」或「驳回」（驳回需填写原因）。
- 审核通过后，点击「确认打款」完成结算。
结算状态转换通过 POST /api/agency/transition-settlement 触发，系统校验前置状态合法性后更新。
合法的状态转换路径：
- 待审核 → 审核通过 / 已驳回
- 审核通过 → 已打款
- 待审核 → 已取消（代理商操作）
!NOTE
- 状态转换有严格的前置校验，避免非法跳转。
- 打款操作需谨慎，确认到账后再更新状态。