码支付 V2: 码支付[mpay]是一款便捷的在线收款工具，使用webman框架开发，支持个人免签收款，三方支付聚合码收款，能通过API对接主流收款服务商平台

外部业务系统 / 商城 / 发卡系统
        |
        | ePay V1/V2 / Open API
        v
MPAY Webman 后端
        |
        |-- 管理后台 API：商户、插件、通道、路由、订单、资金、系统配置
        |-- 商户后台 API：商户资料、API 凭证、订单、退款、清算、流水
        |-- 收银台 API：支付上下文、确认支付、身份授权、支付状态
        |-- 支付运行时：业务单、支付单、路由、插件调用、查单、回调、通知
        |-- Redis Queue：通知、退款、转账、清算、网页流水监听
        |
        v
第三方支付 / 官方 API / 个人收款监听 / 网页流水监听

商户系统发起支付
  -> 校验商户状态和签名
  -> 创建业务单 ma_biz_order
  -> 创建支付单 ma_pay_order
  -> 按商户分组和支付方式解析路由
  -> 轮询组选择支付通道
  -> 加载支付插件和插件配置
  -> 插件返回二维码、跳转链接、HTML、JSAPI 参数或身份授权地址
  -> 上游回调或主动查单推进支付状态
  -> 创建商户通知任务
  -> 平台代收场景生成清算单并入账

app/command/       命令行任务、迁移、测试和联调命令
app/common/        基类、常量、工具、中间件、支付插件、SDK
app/http/          admin、mer、api 控制器、中间件和参数校验
app/model/         数据模型
app/process/       Webman 自定义进程
app/queue/         Redis Queue 消费者
app/repository/    仓库层
app/route/         显式路由
app/service/       支付、商户、资金、文件、安装、系统配置等服务
config/            Webman 配置、业务配置、进程配置、队列配置
database/          迁移、种子和完整 DDL
public/            静态资源目录
runtime/           运行日志、缓存、PID、上传文件等运行时目录
support/           Webman 支撑代码
tools/             辅助工具，例如 receipt_watcher

app/              后端业务源码
config/           配置文件
database/         数据库迁移、种子和完整 DDL
public/           首页、安装页、接口文档页和静态资源
runtime/          运行时目录
support/          Webman 支撑代码
vendor/           Composer 依赖
.env.example      环境变量示例
composer.json     Composer 配置
composer.lock     Composer 锁定文件
webman            Webman 命令入口
windows.php       Windows 开发启动入口
start.php         Webman 启动入口

https://gitee.com/technical-laohu/mpay_v2_webman/releases

/www/wwwroot/pay.example.com

runtime/
public/storage/

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

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

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

http://127.0.0.1:8787

http://你的域名/install

http://127.0.0.1:8787/install

php webman restart

cd /www/wwwroot/项目目录
php webman fix-disable-functions

# 如果解除不成功，可以使用下面脚本再试一遍
curl -Ss https://www.workerman.net/webman/fix-disable-functions | php

php webman start -d

# ePay V1 兼容入口：/submit.php /mapi.php /api.php
location ~ ^/(submit|mapi|api).php$ {
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_http_version 1.1;
    proxy_set_header Connection "";

    proxy_pass http://127.0.0.1:8787/$1;
}

# 静态文件优先由 Nginx 处理，不存在再交给 Webman
location / {
    try_files $uri $uri/ @webman;
}

# Webman 动态请求
location @webman {
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_http_version 1.1;
    proxy_set_header Connection "";

    proxy_pass http://127.0.0.1:8787;
}

# 拒绝访问其它 PHP 文件
location ~ .php$ {
    return 404;
}

# 允许访问 .well-known 目录
location ^~ /.well-known/ {
    allow all;
}

# 拒绝访问其它以 . 开头的文件或目录
location ~ /. {
    return 404;
}

php webman restart -d

# 启动 Webman 工作进程，默认 DEBUG 模式（前台运行）
php webman start
# 启动 Webman 工作进程，以 DAEMON 模式启动（后台运行）
php webman start -d

# 停止 Webman 工作进程
php webman stop
# 平滑停止，等待当前请求处理完成后再退出
php webman stop -g

# 无停机重载代码，适用于代码更新后热加载。
php webman reload
# 平滑重载，等待当前请求处理完成后再重载
php webman reload -g

# 重启 Webman 工作进程
php webman restart
# 重启后以 DAEMON 模式运行（后台运行）
php webman restart -d
# 平滑停止后再重启
php webman restart -g

# 查看工作进程运行状态
php webman status
# 显示详情（实时状态）
php webman status -d

# Windows 开发环境启动
php windows.php

# 数据库迁移
php webman migrate
php webman migrate:status

# 系统配置默认值同步
php webman system:config-sync

# 商户通知重试
php webman payment:notify-retry

# 支付链路烟雾测试
php webman mpay:test --all

# P0 核心检查
php webman mpay:p0-check

# ePay V1 兼容接口测试
php webman epay:mapi

# ePay V2 初始化联调密钥
php webman epay:v2-bootstrap

# ePay V2 API 烟雾测试
php webman epay:v2-api

# ePay V1/V2 mock 全链路测试
php webman epay:mock-chain

curl -X POST "http://127.0.0.1:8787/api/pay/create" 
  -H "Content-Type: application/json" 
  -d '{
    "pid": 1001,
    "type": "alipay",
    "out_trade_no": "T202605190001",
    "notify_url": "https://merchant.example.com/pay/notify",
    "return_url": "https://merchant.example.com/pay/return",
    "name": "测试订单",
    "money": "9.90",
    "clientip": "127.0.0.1",
    "timestamp": "1779179000",
    "sign_type": "RSA",
    "sign": "..."
  }'

app/common/payment

商户
  -> 商户分组
  -> 路由绑定
  -> 轮询组
  -> 轮询组通道编排
  -> 支付通道
  -> 插件配置
  -> 支付插件

支付成功
  -> 创建商户通知任务
  -> 生成待清算单
  -> 清算入账后增加商户可提现余额
  -> 写入资金流水

支付资金直接进入商户自己的上游账户
  -> 平台只处理服务费冻结、扣除或释放
  -> 不生成平台代收清算入账

# ePay V1 兼容入口：/submit.php /mapi.php /api.php
location ~ ^/(submit|mapi|api).php$ {
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_http_version 1.1;
    proxy_set_header Connection "";

    proxy_pass http://127.0.0.1:8787/$1;
}

# 静态文件优先由 Nginx 处理，不存在再交给 Webman
location / {
    try_files $uri $uri/ @webman;
}

# Webman 动态请求
location @webman {
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_http_version 1.1;
    proxy_set_header Connection "";

    proxy_pass http://127.0.0.1:8787;
}

# 拒绝访问其它 PHP 文件
location ~ .php$ {
    return 404;
}

# 允许访问 .well-known 目录
location ^~ /.well-known/ {
    allow all;
}

# 拒绝访问其它以 . 开头的文件或目录
location ~ /. {
    return 404;
}