2.2 KiB
2.2 KiB
/admin/api/withdraws — 提现审核台(审核/批量/对账族)
所属:Admin 子应用(前缀
/admin/api/withdraws) | 鉴权:读=admin,写=finance | 表 withdraw_order | ← 返回 API 索引列表见 admin-withdraws-list;单笔查单见 admin-withdraw-refresh;超时对账见 admin-withdraw-reconcile。本文覆盖其余审核台端点。
提现状态机:reviewing(发起即扣款待审)→ 通过 pending(微信转账在途)→ success/failed(失败退款);拒绝 rejected(退款)。#121 起按 withdraw_order.source 分账:退款/流水落 cash_transaction(coin_cash)或 invite_cash_transaction(invite_cash)。
端点
| 方法 + 路径 | 鉴权 | 说明 |
|---|---|---|
GET /admin/api/withdraws/summary |
admin | 审核台统计:各状态计数(待审/在途/成功/失败/拒绝) |
GET /admin/api/withdraws/health-check |
finance | 提现配置健康检查(证书/密钥路径/商户配置就位与否;暴露路径故限 finance+super) |
GET /admin/api/withdraws/ledger-check |
admin | 资金账本校验(#121):按 source 分账核对「提现单 ↔ 流水」金额闭环,邀请奖励金提现纳入对账 |
GET /admin/api/withdraws/{out_bill_no} |
admin | 提现单详情(审核台抽屉;用户维度联查另走 users/{id}/reward-stats + coin-records) |
POST /admin/api/withdraws/{out_bill_no}/approve |
finance | 审核通过 → 发起微信打款(reviewing→pending→查单归一化);带审计 |
POST /admin/api/withdraws/{out_bill_no}/reject |
finance | 审核拒绝 → 按 source 退款 + rejected;带审计 |
POST /admin/api/withdraws/bulk/refresh |
finance | 批量刷新查单(勾选多笔) |
POST /admin/api/withdraws/bulk/approve |
finance | 批量审核通过并打款 |
POST /admin/api/withdraws/bulk/reject |
finance | 批量审核拒绝并退款 |
说明
- 批量接口逐单处理、逐单落审计,单笔失败不中断整批(返回逐单结果)。
- 结果不明时先查单再定夺、绝不盲目退款(防退款后又到账),同 C 端口径。