Files
usdt/docs/rental-income-settlement.md
T

4.4 KiB

供应商收益结算与提现付款

资金流程

履约成功且收入已确认 → 供应商或管理员勾选订单申请收益结算 → 独立管理员审核 → 待结算收益转入可用余额 → 供应商申请提现 → 冻结金额 → 管理员或Telegram审核 → 执行付款 → 人工登记并核验或自动扫描匹配 → 扣除冻结金额。

页面与权限

管理员:原“供应商结算”页面,先选网络及供应商账户,再勾选订单创建收益结算单;保留新单审核及旧单付款核对操作。

供应商:system/rentSettlement/user/index,菜单“我的收益结算”,默认路径为父目录下的 supplier-settlement。执行 sql/rent_supplier_settlement_menu.sql 后重新登录刷新权限。该脚本兼容rental/proxyRent目录,只授予PROXY_SUPPLIER本人查看和申请权限,不授予管理或审批权限。

两个页面共享订单选择器,过滤SUCCESS、CHARGED、净收益大于0且无有效结算占用的订单。申请中和已入账来源均不出现;拒绝释放后重新出现。金额以六位最小单位字符串精确求和,最终金额仍由服务端加锁计算。切换网络、账户、搜索或分页会清空勾选,避免提交不可见选择。支持订单号/接收地址搜索、分页、来源详情、错误重试与空状态引导。

  • GET /rental/settlements:本人结算分页,参数network/status/page;权限 rent:settlement:view。
  • GET /rental/settlements/candidates:本人可申请订单,参数network/keyword/page;权限 rent:settlement:apply。
  • POST /rental/settlements:本人勾选申请,正文order_ids;权限 rent:settlement:apply。不接受user_id指定归属。
  • GET /rental/settlements/{id}:本人结算详情及来源,权限 rent:settlement:view。
  • 管理员分页/详情分别为 /rental/manage/settlements 和 /rental/manage/settlements/{id},权限 rent:manage:list。
  • 管理员候选账户 /rental/manage/settlements/accounts 参数network/keyword;候选订单 /rental/manage/settlements/candidates 参数network/account/keyword/page,权限 rent:settlement:create。创建沿用 /rental/settlement。

结算仅做内部划转,提现才对应链上出款。沿用现有提现配置、权限和到账机制,供应商需具备 rent:withdraw:create 权限。

表与接口

  • rent_settlement.settlement_mode:新单固定 INTERNAL_TRANSFER,历史单为 LEGACY_PAYOUT,不接受前端指定模式。
  • rent_settlement_item:同一供应商账户、同网络订单净收益快照;每单只允许一次有效结算,拒绝后释放来源。
  • POST /rental/settlement:提交1至100个不重复的 order_ids,均须 SUCCESS 且 CHARGED。
  • POST /rental/settlement/{id}/approve:提交 reason,审批者不能是创建者;同事务验证明细和账户ACTIVE状态,以唯一流水 INCOME_SETTLE:{id} 增加可用、等额减少待结算。结果为 SETTLED 并记录 settled_at。重复审批不重复划转。
  • POST /rental/settlement/{id}/reject:其他管理员拒绝待审单,不修改资金,释放明细占位。
  • 新单禁止 pay/unknown/confirm,完成结算后不允许拒绝撤销。提现使用原 /rental/withdraw/create 等接口。

SETTLED后仍保留来源占位。沿用退款保护:被结算占用的来源不得直接冲正供应商收入或向其返还手续费;待审单可先拒绝后处理退款。已结算收益的后续冲正需独立资金追偿业务,不能从其他订单待结算收益中冒扣,此版本不开放该操作。

升级与旧单

停服备份后执行 sql/rent_income_settlement_migration.sql,再部署新后端和前端。脚本可重复执行,仅增加模式与入账时间字段,不更改余额和历史状态。不要在旧、新版本混跑时创建结算单。

所有历史单保持 LEGACY_PAYOUT,继续原审批、付款授权和交易核验,完成只扣待结算,不增加可用,防止重复提现。历史PENDING/APPROVED且明确未付款的单可先按原规则拒绝,再创建新收益结算单;PAYING/UNKNOWN不能自动拒绝或转换。不得直接改模式或删除明细绕过来源占位。

排查

按 settlementId 查创建、审批幂等、入账或拒绝日志。核对明细合计、来源订单净应收、账户状态及 rent_ledger 的 INCOME_SETTLE 记录。划转前后可用与待结算之和不变,冻结与平台手续费不变;提现另外记账。