mpay/README.md
技术老胡 40f07d9023 修复安装时模板引用报错问题,
添加二维码图片上传功能,可以支持远程图片地址和生成二维码图片。
2024-12-04 12:02:35 +08:00

233 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 码支付
![logo](assets/20241129_120237_logo.jpg)
**码支付[mpay]是一款便捷收款工具,专注于个人免签收款,通过普通收款码即可实现收款通知自动回调,支持绝大多数商城系统**
## 项目地址
| gitee | github |
| :----------: | :------------: |
|[![](assets/20241122_113208_gitee.png)](https://gitee.com/technical-laohu/mpay)|[![](assets/20241122_113331_github.png)](https://github.com/techhaha/mpay)|
点以上图标进入项目页面,可查看最新发行版
## 项目说明
### 原因
之前在工作之余,尝试过很多副业项目,基本都是跟互联网相关的。例如使用**Wordpress和zibll主题**建资源站点,用**微擎**和**微课堂V2**卖课程,使用**异次元发卡**和**独角数卡**程序卖代理的**微信营销软件**,其中遇到的让我最头痛的问题就是收款问题。
正规官方渠道,如微信支付宝申请相关支付接口,必须要签约,且有营业执照等相关资质,这对于只想搞想副业的我实在是没必要,也麻烦,后期的事情也多。于是在网上找到了一些解决方案来解决我的在线收款问题。
### 方案
市场也有很多针对此类需求的平台,也有不少合适的解决方案
#### 虎皮椒/迅虎/蓝兔支付
这些平台都是微信支付宝等官方平台的支付服务商能签约个人商户实现在线收款一些API支付接口可以直接调用跟官方自己申请的几乎差不多。
优点是跟官方申请的支付接口差不多N+1到账
缺点就是审核比较严动不动投诉封商户号一些羊毛党就爱整你你是一点办法没有另外开户基本都要交开户费50-200不等且还需要额外收取手续费。
#### 彩虹易支付
彩虹易支付是一套收款程序,有专门的公司或平台用这套程序搭建一个收款平台,使用自己的微信或支付宝等官方账户来进行收款,你自己注商户号,运营方提供代收款服务,然后给你打款结算。
优点是审核不严,处理比较灵活,适合个人,技术支持比较好,注册可使用(有些需要注册费)
缺点就是平台容易卷款跑路,也没有什么有效监管,钱收不回来就亏大了(这也是最大的问题)
#### 源支付
源支付也是一套收款程序,有个人版和商户版,市面上能搜到的大部分都是商户版,可以入驻,使用自己的个人微信支付宝二维码收款。
源支付程序的设计思路主要是通过在手机或电脑上安装消息监听软件,用来监听获取微信和支付宝的收款到账通知来实现的支付成功回调的。**方法很实用,本程序也添加了该功能插件,免费**。
只是这种思路,有一些小问题:
* 平台容易因为资质问题导致关站;
* 收取的手续费价格偏高;
* 个人码在微信H5环境无法长按识别付款只能通过PC端相机扫码付款。
#### 码支付(mpay)
**本程序暂只提供个人版,开源免费使用。**
码支付是在源支付的设计思路基础上进行的改进,利用第四方**聚合收款码**来进行收款保证收款稳定和便捷。聚合收款码个人可以申请不需求相关资质不用申请API接口收银服务平台众多且实力雄厚如拉卡拉、收钱吧等不怕跑路。
特点如下:
* 免监听,不需要手机或电脑挂机监听消息,即可实现支付回调,只需要设置一个定时任务就行
* 支持微信、支付宝、云闪付的H5环境能正常长按识别扫码支付域名防红
* 个人搭建的收款系统,收款稳定,安全可控,不需要额外手续费
* 支持多平台(聚合码服务商),多账号(聚合码商户),多渠道(门店码/店员码/桌号码等),降低异地线上收款风控风险
### 思路
码支付说到底就是通过二维码来进行收款,日常使用的除了微信支付宝生成的二维码外,还有一类二维码是由收款服务商提供的,它能通过一张收款二维码,同时支持**微信**、**支付宝**、**云闪付**等多渠道付款,一般称为**聚合收款码**。
![聚合收款码](assets/20241128_164241_image.png)
这类收款码扫码之后需要用户自己输入指定金额来进行付款,然后查看收款通知,确认是否到账,最后确认订单支付成功。
就像你去店子里买一瓶水,你扫二维码进去付款界面,就生成了一个订单,你付款成功之后,商店老板会去查看一下商户后台流水,确认订单是否支付成功,这是一个人工审核的过程。
![商户后台订单流水](assets/20241128_164817_image.png)
那么码支付的作用,就是让人工审核变成自动审核的,当用户通过网站购买商品的时候,码支付会生成一个订单并展示收银台界面,用户再扫码进入聚合码付款页面。
![码支付收银台](assets/20241128_164952_image.png)
![用户付款](assets/20241128_171356_image.png)
同一时间,**码支付后台会自动通过账号密码登陆聚合码服务平台的管理后台**并通过API接口循环查询最近的收款明细通过比对金额和时间确认是否付款到账最后确认成功收款。
![收款成功](assets/20241128_165320_image.png)
当用户付款成功,并且后台检测到收款成功消息后,收钱台就会提示收款成功,并最终确认收款。
> 只有存在新订单时,且该订单与当前收款账号一致时,码支付后台才会主动登陆该账号,查询收款流水,减少频繁查询导致的可能风险
> 另外,在账号设置里也有两个模式可选,`单次监听`和`连续监听`,根据业务场景可以自行选择,具体使用,下面有介绍
## 开源声明
### 内置插件
码支付收款管理系统开源免费使用,支付插件有**免费**和**付费**版本,按需使用购买
1. **微信**插件`wxpay`默认安装,支持`赞赏码`、`个人码|经营码|商家码`2个通道需挂机监听
2. **支付宝**插件`alipay`默认安装,支持`收钱码`、`经营码`2个通道需挂机监听
3. **收钱吧**聚合码插件`sqbpay`默认安装,无需挂机,设置定时任务即可
### 技术架构
使用`Thinkphp8`框架PHP版本 > 8.0推荐8.2前端UI使用`Layui 2.9`+`PearAdmin`后台
## 安装和使用
### 全新安装
以下演示基于**云服务器**环境+**宝塔面板**安装,云服务器购买可以去阿里云、腾讯云等平台,宝塔面板安装教程参考[宝塔面板安装教程](https://www.bt.cn/new/download.html)
#### 源码下载
点击下载 [码支付 v1.0.0版本](https://gitee.com/technical-laohu/mpay/releases/tag/v1.0.0)
更多版本请关注发行版更新记录
#### 安装配置
以**宝塔面板**示例,其他服务器管理面板可以参考
通过宝塔面板登陆管理后台新建PHP站点和数据库并确认创建
![](assets/20241203_161723_image.png)
在网站列表页面,点击创建的网站的根目录,进入文件管理
![](assets/20241203_162102_image.png)
文件夹里面有一些默认文件,不用管他
![](assets/20241203_162231_image.png)
点击上传文件,将源码压缩包上传到该文件夹,并解压到前文件夹
![](assets/20241203_162646_image.png)
**将`mpay`文件夹里面的所有文件,复制到当前根目录下**,返回网站列表管理页面
> 注意,压缩包文件打包的是一个名为`mpay`的文件夹,需要将代码文件夹里面的所有文件复制出来,放到创建的网站根目录下,
#### 运行目录&仿静态 配置
点击网站名,进入网站配置设置页面
![](assets/20241203_163259_image.png)
选择**网站目录**,运行目录选择`public`,保存
![](assets/20241203_164321_image.png)
选择**伪静态**,模版选择`thinkphp`,即可自动填写,保存
![](assets/20241203_163507_image.png)
#### 安装步骤
在浏览器输入`http://你的域名/install`,进入程序安装界面,按照提示进行填写提交
![](assets/20241203_165327_image.png)
数据库配置相关信息,在服务器管理面板里查找
![](assets/20241203_165507_image.png)
### 聚合码使用
如果本身就有聚合码收钱码最好,没有就需要提前去各收银服务商申请,申请也不复杂
#### 申请收款码
以下列出一些常见收款服务平台,可以按需申请,个人直接申请小微商户即可
| 平台 | 官网 |
|--------|--------------------------------------|
| 收钱吧 | https://www.shouqianba.com/ |
| 小Y经营 | https://xym.ysepay.com/ |
| 码钱 | https://m.hkrt.cn/ |
| 拉卡拉 | https://customer.lakala.com/ |
| 盛付通 | https://b.shengpay.com/ |
> 申请可以去官方平台注册账号等客服电话,或者在社群里询问(有很多人有代办资质),实在找不到的,可以去淘宝上的官方店买个二维码卡牌贴纸,然后询问客服如何开通账号就行,会有专员联系你开通。
#### 安装插件
#### 添加账号
#### 添加收款码
#### 设置监听
##### 订单监听
##### 账号收款监听
#### 支付测试
### 微信/支付宝使用
微信/支付宝生成的收款码,需要挂机监听收款消息,基本情况上面有介绍,因为使用广泛,所以也单独添加进来,可以实现正常收款回调
#### 添加账号
#### 添加收钱码
#### 挂机监听收款通知
##### 软件下软(安卓)
##### 功能配置
##### 收款通知测试
### 补充说明
### 页面展示
![首页](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)