{"id":45779789,"url":"https://github.com/leoxie2006/qiu-pay","last_synced_at":"2026-03-01T13:00:43.653Z","repository":{"id":340539212,"uuid":"1164502824","full_name":"leoxie2006/qiu-pay","owner":"leoxie2006","description":"无需营业执照的开源支付方案 适用于个人开发者 / 小团队 / 独立站","archived":false,"fork":false,"pushed_at":"2026-02-27T16:37:02.000Z","size":2842,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-28T14:58:31.802Z","etag":null,"topics":["alipay","automation","docker","fastapi","fintech","invoice-detection","opensource","payment","payment-gateway","self-hosted"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leoxie2006.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-23T06:42:34.000Z","updated_at":"2026-02-27T16:37:06.000Z","dependencies_parsed_at":"2026-02-27T11:04:57.182Z","dependency_job_id":null,"html_url":"https://github.com/leoxie2006/qiu-pay","commit_stats":null,"previous_names":["leoxie2006/qiu-pay"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/leoxie2006/qiu-pay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leoxie2006%2Fqiu-pay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leoxie2006%2Fqiu-pay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leoxie2006%2Fqiu-pay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leoxie2006%2Fqiu-pay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leoxie2006","download_url":"https://codeload.github.com/leoxie2006/qiu-pay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leoxie2006%2Fqiu-pay/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29969700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T12:56:10.327Z","status":"ssl_error","status_checked_at":"2026-03-01T12:55:24.744Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alipay","automation","docker","fastapi","fintech","invoice-detection","opensource","payment","payment-gateway","self-hosted"],"created_at":"2026-02-26T10:59:50.918Z","updated_at":"2026-03-01T13:00:43.646Z","avatar_url":"https://github.com/leoxie2006.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e💰 Qiu-Pay\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n无需营业执照的开源支付方案  \n适用于个人开发者 / 小团队 / 独立站\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n🚫 不需要企业资质  \n🚫 不需要签约支付接口  \n🚫 不需要手续费平台\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n通过支付宝账单检测实现自动确认支付，Qiu-Pay 不是支付接口，而是支付确认方案。\n\u003c/p\u003e\n\n[![license](https://img.shields.io/github/license/leoxie2006/qiu-pay)](https://github.com/leoxie2006/qiu-pay/blob/main/LICENSE.md)\n[![release](https://img.shields.io/github/v/release/leoxie2006/qiu-pay)](https://github.com/leoxie2006/qiu-pay/releases)\n[![docker](https://img.shields.io/docker/pulls/qiusheng26/qiu-pay)](https://hub.docker.com/r/qiusheng26/qiu-pay)\n[![stars](https://img.shields.io/github/stars/leoxie2006/qiu-pay)](https://github.com/leoxie2006/qiu-pay)\n[![issues](https://img.shields.io/github/issues/leoxie2006/qiu-pay)](https://github.com/leoxie2006/qiu-pay/issues)\n\n\u003c/div\u003e\n\n---\n\n## ❓ 为什么不用传统聚合支付？\n\n| 对比项 | 传统聚合支付 | Qiu-Pay |\n|--------|-------------|---------|\n| 需要营业执照 | ✅ 必须 | ❌ 不需要 |\n| 需要签约支付接口 | ✅ | ❌ |\n| 手续费 | 有 | 无 |\n| 适合个人开发者 | ❌ | ✅ |\n| 部署复杂度 | 高 | 低 |\n| 成本 | 高 | 几乎 0 |\n\n## 👨‍💻 适用场景\n\n- 独立开发者收款\n- 小程序收款\n- SaaS 项目内购\n- 个人网站支付\n- 无法申请商户号的项目\n\n## ✨ 功能特性\n\n- 🔍 支付宝账单检测，自动确认支付状态\n- 👥 多商户管理，独立凭证和密钥\n- 💲 订单金额尾数自动调整，避免同金额冲突\n- 🔔 异步回调通知，支持自动重试（最多 5 次）\n- 📊 管理后台：仪表盘、商户管理、订单管理、系统设置、使用文档\n\n## 🛠 技术栈\n\n| 层级 | 技术 |\n|------|------|\n| 后端 | Python / FastAPI / SQLite |\n| 前端 | Vue 3 / Element Plus / TypeScript |\n| 部署 | Docker / Docker Compose |\n\n## ⚡ 5分钟搭建支付系统\n\n1. Docker 启动\n2. 上传收款码\n3. 创建商户\n4. 开始收款\n\n## 🚀 Docker 部署（推荐）\n\n1. 创建项目目录：\n\n```bash\nmkdir qiupay \u0026\u0026 cd qiupay\n```\n\n2. 创建 `.env` 文件：\n\n```env\n# 管理员账号（务必修改默认密码）\nADMIN_USERNAME=admin\nADMIN_PASSWORD=your_secure_password\n\n# JWT 密钥（务必修改为随机字符串）\nJWT_SECRET=your-random-secret-key\n\n# 后端配置\nBACKEND_HOST=0.0.0.0\nBACKEND_PORT=8000\n```\n\n3. 创建 `docker-compose.yml`：\n\n```yaml\nservices:\n  qiupay:\n    image: qiusheng26/qiu-pay:latest\n    container_name: qiupay\n    restart: unless-stopped\n    ports:\n      - \"${BACKEND_PORT:-8000}:${BACKEND_PORT:-8000}\"\n    volumes:\n      - ./data:/app/data\n    env_file:\n      - .env\n```\n\n4. 启动服务：\n\n```bash\ndocker compose up -d\n```\n\n5. 访问 `http://你的服务器IP:8000` 进入管理后台。\n\n## 🔧 开发部署\n\n1. 克隆项目：\n\n```bash\ngit clone https://github.com/leoxie2006/qiu-pay.git\ncd qiupay\n```\n\n2. 安装后端依赖（需要 Python 3.12+）：\n\n```bash\npip install -r requirements.txt\n```\n\n\u003e pyzbar 依赖系统库 zbar，Linux 下需先安装：`apt install libzbar0`\n\n3. 复制并编辑环境变量：\n\n```bash\ncp .env.example .env\n```\n\n将 `CORS_ENABLED` 设为 `1` 以支持前后端分离开发。\n\n4. 启动后端：\n\n```bash\nuvicorn app.main:app --reload --host localhost --port 8000\n```\n\n5. 安装并启动前端（需要 Node.js 20+）：\n\n```bash\ncd frontend\nnpm install\nnpm run dev\n```\n\n前端默认运行在 `http://localhost:5173`，API 请求会自动代理到后端。\n\n6. 运行测试：\n\n```bash\npytest\n```\n\n### 构建 Docker 镜像\n\n```bash\ndocker build -t qiusheng26/qiu-pay:latest .\ndocker push qiusheng26/qiu-pay:latest\n```\n\n## ⚙️ 环境变量\n\n| 变量 | 默认值 | 说明 |\n|------|--------|------|\n| DB_PATH | data/qiupay.db | 数据库文件路径 |\n| ADMIN_USERNAME | admin | 管理员用户名 |\n| ADMIN_PASSWORD | admin123 | 管理员密码 |\n| JWT_SECRET | - | JWT 签名密钥 |\n| BACKEND_HOST | localhost | 后端监听地址 |\n| BACKEND_PORT | 8000 | 后端监听端口 |\n| CORS_ENABLED | 0 | 是否启用 CORS |\n| CORS_ORIGINS | http://localhost:5173 | 允许的跨域来源 |\n| FRONTEND_HOST | localhost | 前端开发服务器地址 |\n| FRONTEND_PORT | 5173 | 前端开发服务器端口 |\n\n## 📖 快速开始\n\n1. 使用管理员账号登录后台\n2. 在「商户管理 → 凭证配置」中配置支付宝凭证\n3. 上传商家收款二维码\n4. 创建商户，获取商户 ID（pid）和密钥（key）\n5. 商户通过 API 发起支付请求\n\n详细操作步骤请查看管理后台的「使用文档」页面。\n\n## 📄 许可证\n\n[MIT License](https://github.com/leoxie2006/qiu-pay/blob/main/LICENSE.md)\n\n## ☕ 赞赏支持\n\n如果觉得项目对你有帮助，欢迎赞赏支持\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/leoxie2006/qiu-pay/main/docs/public/0.jpg\" width=\"300\" /\u003e\n\u003c/div\u003e\n\n## ⚠️ 合规声明\n\n本项目仅用于个人技术研究或收款确认场景，不提供资金清算、代收代付等支付服务。\n\n用户需遵守当地法律法规及支付宝相关协议，因不当使用产生的风险由使用者自行承担。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleoxie2006%2Fqiu-pay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleoxie2006%2Fqiu-pay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleoxie2006%2Fqiu-pay/lists"}