建议统一成“收益结算 + 提现付款” 按建议的逻辑帮我实现。
This commit is contained in:
1 parent
1151dc2535
commit
be6ac23844
18 files changed
+352
-16
No files matched your search
@@ -2,6 +2,10 @@
|
||||
|
||||
## 业务与费用
|
||||
|
||||
同一网络、同一接收地址只能存在一笔待处理的地址上链订单,限制跨应用、跨用户生效。WAITING、EXECUTING、VERIFYING、MANUAL_REVIEW 均占用名额;只有 SUCCESS、FAILED、CANCELLED 释放。相同商户订单号及参数重试仍返回原单,不重复冻结。失败或取消后可重试,但仍须通过链上未激活校验。数据库唯一索引防止并发绕过检查。
|
||||
|
||||
已有数据库需先执行 `sql/rent_onchain_pending_migration.sql`;若有历史重复待处理订单,脚本拒绝升级,需人工核实交易和资金状态后处理,禁止直接删除或批量取消。
|
||||
|
||||
用户在“我的套餐”或“我的订单”中的“地址上链”卡片输入网络、接收地址及应用凭证,获取报价后确认。即使没有资源套餐,也能创建地址上链订单。供应商通过原有 rent_node 及已证明所有权的 rent_wallet 执行,不需要供应商创建 rent_app。
|
||||
|
||||
地址上链使用独立路径 `/api/rental/v1/address-onchain/quote`、`/create`、`/query`,订单类型由路径固定为 `ADDRESS_ONCHAIN`,请求可省略order_type;若提交只能为ADDRESS_ONCHAIN。原 `/api/rental/v1/quote`、`/create`、`/query` 仅处理 `RESOURCE_RENTAL`,拒绝混用订单类型。两者复用签名、应用归属、商户单号幂等、账务及回调机制。原地址上链接入方需同时更新请求URL和HMAC签名中的完整路径,不能用旧路径签名请求新接口;已有订单可通过新的query路径按原商户单号查询。
|
||||
|
||||
@@ -0,0 +1,28 @@
|
||||
# 供应商收益结算与提现付款
|
||||
|
||||
## 资金流程
|
||||
|
||||
履约成功且收入已确认 → 管理员创建收益结算单 → 另一管理员审核 → 待结算收益转入可用余额 → 供应商申请提现 → 冻结金额 → 管理员或Telegram审核 → 执行付款 → 人工登记并核验或自动扫描匹配 → 扣除冻结金额。
|
||||
|
||||
结算仅做内部划转,提现才对应链上出款。沿用现有提现配置、权限和到账机制,供应商需具备 `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` 记录。划转前后可用与待结算之和不变,冻结与平台手续费不变;提现另外记账。
|
||||
@@ -106,7 +106,7 @@ node --env-file=.env src/index.js
|
||||
|
||||
每天UTC02:00自动进行账账核对,发现差异只告警,不直接修复余额或释放未知本金。运营可在资金账户/流水页主动执行完整分页核对。
|
||||
|
||||
结算 `pay` 先持久化唯一 `payout_no` 及本次收款地址,再由人工付款;重试返回原授权,不产生新的付款。`confirm` 根据原授权收款地址、账户网络及精确USDT金额核对原交易日志。后端不自动对外出金。
|
||||
新结算单使用 `INTERNAL_TRANSFER` 模式,其他管理员 `approve` 后将供应商净收益从待结算转入可用余额,状态为 `SETTLED`,不执行链上付款。对外付款统一通过提现处理。`LEGACY_PAYOUT` 仅兼容升级前付款单,保留原授权和交易核验,不转入内部余额。见 `../rental-income-settlement.md`。
|
||||
|
||||
## 6. 外部商户签名接口
|
||||
|
||||
|
||||
Reference in new issue
Block a user