MPAY V2 的核心目标是把支付系统里容易分散的能力统一起来：商户、支付方式、支付插件、插件配置、支付通道、轮询组、路由策略、业务单、支付单、回调通知、退款、清算和资金账户都由后端统一建模和管理。

它不是简单的支付接口转发程序，而是一套可二次开发的支付中台底座：

对平台方： 提供管理后台 API，用于维护商户、通道、插件、路由、订单、退款、清算和资金。
对商户方： 提供商户后台 API，用于查看订单、退款、清算、余额、流水和 API 凭证。
对接入方： 兼容 ePay V1/V2 协议，便于已有商城、发卡、资源站、业务系统快速接入。
对开发者： 提供统一支付插件契约，便于扩展官方 API 支付、个人收款监听、网页流水监听等通道。

服务器需要准备：

依赖 说明
PHP 最低 8.1，新部署推荐 8.2
MySQL 建议 5.7+ / 8.x
Redis 用于缓存、登录态、队列和运行时任务
程序依赖 发行版已包含 vendor，通常不需要在服务器单独安装依赖
PHP 扩展 必需 pdo_mysql、openssl、json、mbstring、redis、pcntl；建议 curl、fileinfo、event
Webman 是常驻内存服务，不依赖 PHP-FPM 或 OPcache 处理请求。请使用 php -v 和 php -m 检查 PHP CLI 的实际版本和扩展。

3. 设置目录权限
确保运行用户可以写入以下目录：

runtime/
public/storage/
安装程序会写入 .env、安装锁、日志、缓存和上传目录。若服务器权限较严格，请先确认站点目录对 Webman 运行用户可写。

4. 启动服务
Linux / macOS：

# 调试方式运行（用于开发调试，打印数据会显示在终端，终端关闭后webman服务也随之关闭）
php webman start

# 守护进程方式运行（用于正式环境，打印数据不会显示在终端，终端关闭后webman服务会持续运行）
php webman start -d

Windows 开发环境：

# 双击 windows.bat 或者终端运行 php windows.php 启动
php windows.php

默认监听地址：

http://127.0.0.1:8787
生产环境使用Linux系统，建议使用 Supervisor、systemd、宝塔守护进程等方式守护 Webman 进程，再通过 Nginx 或 Apache 反向代理访问。

5. 打开安装程序
浏览器访问：

http://你的域名/install
或本地访问：

http://127.0.0.1:8787/install
安装程序会引导填写：

站点名称和站点 URL。
MySQL 地址、端口、数据库名、账号和密码。
Redis 地址、端口、密码、缓存库和队列库。
管理员账号、管理员密码和 JWT 密钥。
安装程序会自动完成：

检测 PHP、目录权限、数据库和 Redis。
创建数据库，前提是数据库账号具备创建权限。
写入 .env 配置文件。
执行数据库迁移。
写入支付方式、系统配置、支付插件和管理员账号。
生成平台 ePay RSA 密钥。
写入安装锁。
安装完成后重启 Webman：

php webman restart