xinyin025/mpay
1
0
Fork 0
mirror of https://gitee.com/technical-laohu/mpay.git synced 2025-11-15 07:03:44 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

更新文档

Browse Source
This commit is contained in:
技术老胡
2025-02-19 12:18:20 +08:00
parent aaf0fd96e7
commit 43932ec0d9
3 changed files with 574 additions and 174 deletions
Download Patch File Download Diff File Expand all files Collapse all files

185
README.md
View File

@@ -1,138 +1,139 @@
# 码支付
<p align="center">
<div align="center">
<a href="https://gitee.com/technical-laohu/mpay">
<img src="assets/20241129_120237_logo.jpg" alt="mpay" width=40% />
</a>
</div>
<div align="center">
<a href="https://gitee.com/technical-laohu/mpay" target="_blank">项目主页</a> ｜
<a href="https://gitee.com/technical-laohu/mpay/releases" target="_blank">源码下载</a> ｜
<a href="https://f0bmwzqjtq2.feishu.cn/docx/HBVrdrsACo36bzxUCSPcjOBNnyb" target="_blank">使用文档</a> ｜
<a href="https://f0bmwzqjtq2.feishu.cn/docx/FtphdDA10oBfPyxNEEZc5mgJnqf" target="_blank">常见问题</a> ｜
<a href="https://f0bmwzqjtq2.feishu.cn/docx/OjlwdPunLoGjL0xodMUcS0xFngX" target="_blank">学习交流</a> ｜
<a href="https://f0bmwzqjtq2.feishu.cn/docx/PjwOdvBeZoQEHUxF2ZScTjHOnKb" target="_blank">赞赏作者</a>
</div>
<br />
<div align="center">
😎免签约、🧩多通道、🛜不掉线 - 专注于个人在线收款💴
</div>
</p>
![logo](assets/20241129_120237_logo.jpg)
## ✨ 项目介绍
**码支付[mpay]是一款便捷收款工具，专注于个人免签收款，通过普通收款码即可实现收款通知自动回调，支持绝大多数商城系统**
# 项目地址
| gitee | github |
| <p align="center">gitee</p> | <p align="center">github</p> |
| :----------: | :------------: |
|[![](assets/20241122_113208_gitee.png)](https://gitee.com/technical-laohu/mpay)|[![](assets/20241122_113331_github.png)](https://github.com/techhaha/mpay)|
| <a href="https://gitee.com/technical-laohu/mpay"><img src="assets/20241122_113208_gitee.png" alt="mpay" width=160 /></a>|<a href="https://github.com/techhaha/mpay"><img src="assets/20241122_113331_github.png" alt="mpay" width=160 /></a>|
点以上图标进入项目页面，可查看最新发行版
# 项目说明
## ⚙️ 工具特性
## 原因
- 开源程序，个人免费使用，不断更新
- 支持第四方收款服务商聚合码收款，免挂机、不掉线
- 支持微信、支付宝个人账户收款，免签约
- 采用易支付接口标准开发，兼容市面上大部分商城系统
- 在H5环境中，能正常长按识别扫码支付
- 支持多平台、多账号、多通道，灵活配置，收款轮询
## ✨ 演示站点
访问 [在线演示](http://demo.stspwsc.com/) 快速体验。
## 📊 项目说明
### 🎈 原因
之前在工作之余，尝试过很多副业项目，基本都是跟互联网相关的。例如使用**Wordpress和zibll主题**建资源站点，用**微擎**和**微课堂V2**卖课程，使用**异次元发卡**和**独角数卡**程序卖代理的**微信营销软件**，其中遇到的让我最头痛的问题就是收款问题。
正规官方渠道，如微信支付宝申请相关支付接口，必须要签约，且有营业执照等相关资质，这对于只想搞想副业的我实在是没必要，也麻烦，后期的事情也多。于是在网上找到了一些解决方案来解决我的在线收款问题。
---
## 方案
### 🪄 方案
市场也有很多针对此类需求的平台，也有不少合适的解决方案
### 虎皮椒/迅虎/蓝兔支付
#### 虎皮椒/迅虎/蓝兔支付
这些平台都是微信支付宝等官方平台的支付服务商，能签约个人商户，实现在线收款，一些API支付接口可以直接调用，跟官方自己申请的几乎差不多。
优点是跟官方申请的支付接口差不多，N+1到账
缺点就是审核比较严，动不动投诉封商户号，一些羊毛党就爱整你，你是一点办法没有，另外开户基本都要交开户费，50-200不等，且还需要额外收取手续费。
### 彩虹易支付
#### 彩虹易支付
彩虹易支付是一套收款程序，有专门的公司或平台用这套程序搭建一个收款平台，使用自己的微信或支付宝等官方账户来进行收款，你自己注商户号，运营方提供代收款服务，然后给你打款结算。
优点是审核不严，处理比较灵活，适合个人，技术支持比较好，注册可使用（有些需要注册费）
缺点就是平台容易卷款跑路，也没有什么有效监管，钱收不回来就亏大了（这也是最大的问题）
### 源支付/V免签
#### 源支付/V免签
源支付也是一套收款程序，有个人版和商户版，市面上能搜到的大部分都是商户版，可以入驻，使用自己的个人微信支付宝二维码收款。
V免签是一款开源免费适用于个人收款使用的收款程序，原理同源支付类似。
程序的设计思路主要是通过在手机或电脑上安装消息监听软件，用来监听获取微信和支付宝的收款到账通知来实现的支付成功回调的。**方法很实用，本程序也添加了该功能插件，免费**。
![](assets/20241210_112331_e8d2c4043a3c57ad887aef92df1c253.png)
只是这种思路，有一些小问题：
## ✨ 开发思路
* 平台容易因为资质问题导致关站；
* 收取的手续费价格偏高；
* 个人码在微信H5环境无法长按识别付款，只能通过PC端，相机扫码付款。
* 挂机监听容易掉线，导致收款通知无法回调
### 🎯 服务商聚合码
### 🚀️ 码支付(mpay)
**本程序暂只提供个人版，开源免费使用。**
码支付是在源支付的设计思路基础上进行的改进，利用第四方**聚合收款码**来进行收款，保证收款稳定和便捷不掉线。
聚合收款码个人可以申请，不需求相关资质，不用申请API接口，收银服务平台众多且实力雄厚（如拉卡拉、收钱吧等），不怕跑路。
特点如下：
* 免监听，不需要手机或电脑挂机监听消息，即可实现支付回调，只需要设置一个定时任务就行
* 支持微信、支付宝、云闪付的H5环境，能正常长按识别扫码支付，域名防红
* 个人搭建的收款系统，收款稳定，安全可控，不需要额外手续费
* 支持多平台(聚合码服务商)，多账号(聚合码商户)，多渠道(门店码/店员码/桌号码等)，降低异地线上收款风控风险
---
## 思路
<img src="assets/20241210_112301_6f2fef2a7aaee96790eb86f90e3b107.png" width=70% />
码支付说到底就是通过二维码来进行收款，日常使用的除了微信支付宝生成的二维码外，还有一类二维码是由收款服务商提供的，它能通过一张收款二维码，同时支持**微信**、**支付宝**、**云闪付**等多渠道付款，一般称为**聚合收款码**。
![聚合收款码](assets/20241128_164241_image.png)
<img src="assets/20241128_164241_image.png" width=50% />
这类收款码扫码之后需要用户自己输入指定金额来进行付款，然后查看收款通知，确认是否到账，最后确认订单支付成功。
就像你去店子里买一瓶水，你扫二维码进去付款界面，就生成了一个订单，你付款成功之后，商店老板会去查看一下商户后台流水，确认订单是否支付成功，这是一个人工审核的过程。
![商户后台订单流水](assets/20241128_164817_image.png)
<img src="assets/20241128_164817_image.png" width=70% />
那么码支付的作用，就是让人工审核变成自动审核的，当用户通过网站购买商品的时候，码支付会生成一个订单并展示收银台界面，用户再扫码进入聚合码付款页面。
![码支付收银台](assets/20241128_164952_image.png)
<img src="assets/20241128_164952_image.png" width=60% />
![用户付款](assets/20241128_171356_image.png)
<img src="assets/20241128_171356_image.png" width=32% />
同一时间，**码支付后台会自动通过账号密码登陆聚合码服务平台的管理后台**，并通过API接口，循环查询最近的收款明细，通过比对金额和时间，确认是否付款到账，最后确认成功收款。
![收款成功](assets/20241128_165320_image.png)
<img src="assets/20241128_165320_image.png" width=70% />
当用户付款成功，并且后台检测到收款成功消息后，收钱台就会提示收款成功，并最终确认收款。
![](assets/20241210_112301_6f2fef2a7aaee96790eb86f90e3b107.png)
> 只有存在新订单时，且该订单与当前收款账号一致时，码支付后台才会主动登陆该账号，查询收款流水，减少频繁查询导致的可能风险
> 另外，在账号设置里也有两个模式可选，`单次监听`和`连续监听`，根据业务场景可以自行选择，具体使用，下面有介绍
# 开源声明
### 🪁 微信、支付宝收款码
## 演示站点
<img src="assets/20241210_112331_e8d2c4043a3c57ad887aef92df1c253.png" width=70% />
[码支付](http://demo.stspwsc.com/) http://demo.stspwsc.com/
普通的个人收款码，大多使用微信/支付宝来进行收款，依赖于微信/支付宝平台的推送服务和系统通知机制，就可以获取到收款金额的通知信息，从而可以实现支付回调，自动确认收款。
目前主流的方式也是这种，来实现自动收款，简单方便，不过有一些小问题：
- 微信/支付宝的收款通知推送，需要软件挂机进行监听，否则无法确认收款
- 监听软件因手机或PC系统的不同，可能会出现各种监听不稳定的问题
- 微信个人码因升级，在微信H5环境里无法长按识别付款
## 内置插件
码支付收款管理系统开源免费使用，支付插件有**免费**和**付费**版本，按需使用购买
1. **微信**插件`wxpay`默认安装，支持`赞赏码`、`个人码|经营码|商家码`，2个通道，需挂机监听
2. **支付宝**插件`alipay`默认安装，支持`收钱码`、`经营码`，2个通道，需挂机监听
3. **收钱吧**聚合码插件`sqbpay`默认安装，无需挂机，设置定时任务即可
## 技术架构
## 📦 技术架构
使用`Thinkphp8`框架，PHP版本 > 8.0（推荐8.2），前端UI使用`Layui 2.9`+`PearAdmin`后台
## 🧰 内置插件
码支付收款工具开源免费使用，插件中心的插件列表有**免费版**和**付费版**版，按需使用购买
1. **微信**插件`wxpay`默认安装，支持`赞赏码`、`个人码`、`经营码`、`商家码`，需挂机监听
2. **支付宝**插件`alipay`默认安装，支持`收钱码`、`经营码`，需挂机监听
3. **收钱吧**聚合码插件`sqbpay`默认安装，无需挂机，设置定时任务即可监听回调
---
# 安装和使用
## 全新安装
## 📝 安装说明
以下演示基于**云服务器**环境+**宝塔面板**安装，云服务器购买可以去阿里云、腾讯云等平台，宝塔面板安装教程参考[宝塔面板安装教程](https://www.bt.cn/new/download.html)
### 🚀️ 源码下载
**点击下载 [码支付 v1版本](https://gitee.com/technical-laohu/mpay/releases)**
**更多版本请关注发行版更新记录**
### 安装配置
以**宝塔面板**示例，其他服务器管理面板可以参考
@@ -182,7 +183,8 @@ V免签是一款开源免费适用于个人收款使用的收款程序，原理
---
## ❤️ 聚合码使用
## ❤️ 聚合码收款
如果本身就有聚合码收钱码最好，没有就需要提前去各收银服务商申请，申请也不复杂
@@ -285,7 +287,7 @@ V免签是一款开源免费适用于个人收款使用的收款程序，原理
---
## ❤️ 微信/支付宝使用
## ❤️ 微信/支付宝收款
微信/支付宝生成的收款码，需要挂机监听收款消息，基本情况上面有介绍，因为使用广泛，所以也单独添加进来，可以实现正常收款回调
@@ -430,42 +432,15 @@ V免签是一款开源免费适用于个人收款使用的收款程序，原理
7. PC监听和手机监听，只需要开启一个即可，不要同时开启，会出现重复通知，导致订单异常。
---
# 补充说明
## 🔎 补充说明
* 该软件仅适用于个人线上免签收款，避免人工审核确认收款的繁琐步骤。请勿用于诈骗、黑灰产业，如有此类行为，后果自负。
* 插件中心目前还在开发中，不支持在线安装插件，如果有购买插件或定制其他收银平台插件的需求，可以联系作者，Wechat:**K103516**
- **码支付**是一个**个人免费使用**的收款工具，**码支付**的**源码**是开源的，你可以根据自己的实际情况进行修改，也可以自行开发，有任何问题，可以社区交流
- 该软件仅适用于个人线上免签收款，避免人工审核确认收款的繁琐步骤。实际使用中请勿用于诈骗、黑灰产业，如有此类行为，一经发现直接举报
- 插件中心目前还在开发中，不支持在线安装插件，如果有购买插件或定制其他收银平台插件的需求，可以联系作者，Wechat:**K103516**
# 页面展示
![首页](assets/20241203_153935_image.png)
![安装](assets/20241203_154034_image.png)
![登陆](assets/20241203_154108_image.png)
![后端控制台](assets/20241203_154141_image.png)
![订单管理](assets/20241203_154218_image.png)
![账号管理](assets/20241203_154307_image.png)
![插件管理](assets/20241203_154420_image.png)
![用户中心](assets/20241203_154505_image.png)
![添加账号](assets/20241203_154755_image.png)
![收款码](assets/20241203_154918_image.png)
![订单详情](assets/20241203_155123_image.png)
# 学习交流社群
## 📬 学习交流
社群答疑、插件定制、技术交流，添加微信拉群，请备注：**码支付**
@@ -473,12 +448,11 @@ V免签是一款开源免费适用于个人收款使用的收款程序，原理
<img src="assets/wxqrcode.png" width=50% />
## 感谢赞助
## 💰 赞赏作者
<img src="assets/20250217_111408_1739762042428.jpg" width=35% />
|姓名 | 金额 |
|---|---|
| 知汇学社 | 100 |
@@ -488,9 +462,6 @@ V免签是一款开源免费适用于个人收款使用的收款程序，原理
| 零零 | 200 |
| 子染 | 88 |
## 友情链接
1. [腾飞博客，专业WP子比主题美化定制](https://calfbxtoi72.feishu.cn/docx/DA3ddthzOolQ16xDgeOcHA36nrg)
## 🔗 友情链接
1. [腾飞博客，专业WP子比主题美化定制](https://calfbxtoi72.feishu.cn/docx/DA3ddthzOolQ16xDgeOcHA36nrg)