Qiu-Pay

无需营业执照的开源支付方案适用于个人开发者 / 小团队 / 独立站

🚫 不需要企业资质 🚫 不需要签约支付接口 🚫 不需要手续费平台

通过支付宝账单检测实现自动确认支付，Qiu-Pay 不是支付接口，而是支付确认方案。

🖼️ 界面展示

演示网站：qiupay.cn

仪表盘仪表盘统计订单管理

Qiu-Pay

❓ 为什么不用传统聚合支付？

| 对比项 | 传统聚合支付 | Qiu-Pay | |--------|-------------|---------| | 需要营业执照 | ✅ 必须 | ❌ 不需要 | | 需要签约支付接口 | ✅ | ❌ | | 手续费 | 有 | 无 | | 适合个人开发者 | ❌ | ✅ | | 部署复杂度 | 高 | 低 | | 成本 | 高 | 几乎 0 |

👨‍💻 适用场景

独立开发者收款
小程序收款
SaaS 项目内购
个人网站支付
无法申请商户号的项目

✨ 功能特性

🔍 支付宝账单检测，自动确认支付状态
👥 多商户管理，独立凭证和密钥
💲 订单金额尾数自动调整，避免同金额冲突
🔔 异步回调通知，支持自动重试（最多 5 次）
📊 管理后台：仪表盘、商户管理、订单管理、系统设置、使用文档

🛠 技术栈

| 层级 | 技术 | |------|------| | 后端 | Python / FastAPI / SQLite | | 前端 | Vue 3 / Element Plus / TypeScript | | 部署 | Docker / Docker Compose |

⚡ 5分钟搭建支付系统

Docker 启动
上传收款码
创建商户
开始收款

🚀 Docker 部署（推荐）

mkdir qiupay && cd qiupay

创建 .env 文件：

# 管理员账号（务必修改默认密码）
ADMIN_USERNAME=admin
ADMINPASSWORD=yoursecure_password
JWT 密钥（务必修改为随机字符串）
JWT_SECRET=your-random-secret-key
后端配置
BACKEND_HOST=0.0.0.0
BACKEND_PORT=8000

创建 docker-compose.yml：

services:
  qiupay:
    image: qiusheng26/qiu-pay:latest
    container_name: qiupay
    restart: unless-stopped
    ports:
      - "${BACKENDPORT:-8000}:${BACKENDPORT:-8000}"
    volumes:
      - ./data:/app/data
    env_file:
      - .env

启动服务：

docker compose up -d

访问 http://你的服务器IP:8000 进入管理后台。

🔧 开发部署

克隆项目：

git clone https://github.com/leoxie2006/qiu-pay.git
cd qiupay

安装后端依赖（需要 Python 3.12+）：

pip install -r requirements.txt

pyzbar 依赖系统库 zbar，Linux 下需先安装：apt install libzbar0

复制并编辑环境变量：

cp .env.example .env

将 CORS_ENABLED 设为 1 以支持前后端分离开发。

启动后端：

uvicorn app.main:app --reload --host localhost --port 8000

安装并启动前端（需要 Node.js 20+）：

cd frontend
npm install
npm run dev

前端默认运行在 http://localhost:5173，API 请求会自动代理到后端。

运行测试：

pytest

⚙️ 环境变量

| 变量 | 默认值 | 说明 | |------|--------|------| | DB_PATH | data/qiupay.db | 数据库文件路径 | | ADMIN_USERNAME | admin | 管理员用户名 | | ADMIN_PASSWORD | admin123 | 管理员密码 | | JWT_SECRET | - | JWT 签名密钥 | | BACKEND_HOST | localhost | 后端监听地址 | | BACKEND_PORT | 8000 | 后端监听端口 | | CORS_ENABLED | 0 | 是否启用 CORS | | CORS_ORIGINS | http://localhost:5173 | 允许的跨域来源 | | FRONTEND_HOST | localhost | 前端开发服务器地址 | | FRONTEND_PORT | 5173 | 前端开发服务器端口 |