目标:构建一个统一的订单支付中台,支持多个内部工具/系统(例如数字人项目)接入支付功能(微信支付、支付宝)。实现订单统一管理、资金对账、分账、发票标记、报表导出等功能,方便追踪每个项目的收支情况。技术栈(前端):
-
React 18+ + Vite -
Tailwind CSS -
推荐:TypeScript、TanStack Query(数据 fetching)、Zustand 、React Router v6、Ant、Recharts 图表)
核心价值:
-
多项目(多租户)隔离:每个项目独立 Project ID,订单归属项目。 -
标准化 API:其他系统通过 HTTP 接口推送订单/支付回调。 -
资金透明:用户支付金额、入账金额、手续费、分账、结余清晰可见。 -
扩展性:支持发票标记、点数消耗场景。
用户角色与权限
- 超级管理员
管理所有项目、用户、报表、全局配置。 - 项目管理员
查看/管理自己项目的订单、报表。 - 财务/运营
查看资金对账、分账、导出报表。 - API 调用方
通过接口推送订单,无界面。
3. 核心功能模块
3.1 项目管理
-
新建项目:名称、描述、负责人、联系方式等 → 自动生成唯一Project ID。 -
项目列表:搜索、筛选、状态(活跃/停用)。 -
项目详情:关联订单统计、累计收入、当前结余等。
3.2 订单管理
-
订单列表:支持按项目、支付渠道(微信/支付宝)、状态(待支付、支付成功、失败、退款)、时间范围筛选。 -
订单详情: -
订单号、Project ID、外部系统订单ID、用户ID、金额(用户支付金额)。 -
实际入账金额、手续费(微信/支付宝费率配置)、分账明细。 -
支付时间、回调状态、支付凭证。 -
发票标记:手动标记“已开票”/“无需发票”,记录发票信息。 -
订单创建:支持手动录入(后台)和 API 推送。 -
状态同步:接收支付成功/失败回调,更新订单状态并返回响应。
3.3 支付渠道与配置
-
支持微信支付、支付宝。 -
渠道配置:商户号、AppID、密钥、费率(支持不同项目不同费率)。 -
支付回调处理:标准 webhook 接口。 -
测试模式与生产模式切换。
3.4 分账功能(合伙人分账)
-
订单分账规则:按比例、固定金额、自定义规则。 -
分账记录:每次订单的分账明细(合伙人ID、金额、状态)。 -
合伙人管理:添加合伙人、设置分账比例/规则。
3.5 资金对账与报表
-
资金总览仪表盘:总收入、入账金额、总手续费、净结余、按项目/渠道饼图、趋势图。 -
明细对账:用户支付 vs 系统入账 vs 手续费 vs 分账 vs 结余。 -
报表导出: -
支持 Excel/CSV(订单列表、资金明细、项目汇总)。 -
按时间、项目、渠道筛选。 -
每日/月度对账单生成。
3.6 其他通用功能
-
用户/权限管理(RBAC)。 -
操作日志、审计。 -
通知(站内信支付成功)。 -
数据导入导出、搜索、分页、筛选。 -
暗黑模式、响应式布局。
3.7. 非功能需求
-
安全性:JWT 认证、数据加密、防止重复支付。 -
性能:支持高并发订单查询,数据库索引。 -
可扩展性:易于添加新支付渠道。 -
部署:Vite 构建静态资源,前端可独立部署。 -
数据持久化:配套后端(Node.js)+PostgreSQL + Redis。
4. API 接口(供其他项目调用)使用 RESTful + Webhook:
- 创建订单
POST /api/ordersBody: { projectId, externalOrderId, amount, description, userId, notifyUrl, returnUrl, … } Response: 支付参数(QR code / JSAPI 参数等)。 - 支付回调
(平台主动回调其他系统,或提供查询接口)。 - 查询订单
GET /api/orders/{orderId} - 退款
提供 OpenAPI/Swagger 文档。支持签名验证和 IP 白名单安全。示例场景(数字人项目):
-
用户充值 → 调用 API 创建订单 → 支付成功 → 系统增加用户点数 → 标记是否开发票 → 消耗点数记录(可选关联)。
5. 页面结构
-
登录页 
-
仪表盘 
-
项目管理 
-
订单列表 + 详情 

-
分账管理 
-
API 文档 
-
用户 & 设置 

https://github.com/wechatpay-apiv3/wechatpay-skills微信支付全产品接入指引,支持 JSAPI、Native、H5、App、付款码 等各种场景。
npx skills add https://github.com/wechatpay-apiv3/wechatpay-skills --yes
https://www.modelscope.cn/skills/PantherAng/alipay-payment-integration/
npx skills add ./skills/alipay-payment-integration --yes
© 版权声明
文章版权归作者所有,未经允许请勿转载。








