更新文档

This commit is contained in:
技术老胡 2024-12-05 11:44:47 +08:00
parent 6d0e7ce296
commit 2cd77c824c
16 changed files with 79 additions and 3 deletions

2
.env
View File

@ -1,4 +1,4 @@
APP_DEBUG = true APP_DEBUG = false
DB_TYPE = mysql DB_TYPE = mysql
DB_HOST = 127.0.0.1 DB_HOST = 127.0.0.1

View File

@ -185,18 +185,90 @@
### 安装插件 ### 安装插件
程序默认安装有**微信支付**`wxpay`、**支付宝**`alipay`、**收钱吧**`sqbpay`三个插件,基本能满足大家的日常收款需求。
如果需要其他收银平台插件,可以在插件中心自行安装,插件中心没有的,也可以联系作者定制开发。
### 添加账号 ### 添加账号
除**微信支付**`wxpay`、**支付宝**`alipay`之外,所有的收款平台均为聚合码收款平台
以**收钱吧**`sqbpay`为例,添加账号时,需要填写**收钱吧**商户管理中心的**登陆账号**和**登陆密码**,需要使用时,插件会自动在后台登陆账号并查询相关订单流水信息。
![](assets/20241205_102856_image.png)
![](assets/20241205_103718_image.png)
**监听模式**说明,分为`单次监听`和`连续监听`
![](assets/20241205_104101_image.png)
`单次监听`是在收银台页面,用户扫码支付成功后,需要手动点击**确认支付**,后台才会登陆查询该账号的收款流水情况,**点击一次,查询一次,不点击,则不会查询**,降低密集查询可能导致的账户风控
![](assets/20241205_104306_image.png)
`连续监听`是在创建订单之后,在订单有效期内且订单未完成状态时,插件会一直连续不断的查询账户流水详情,直到过期或者成功收款,用户不需要主动点击确认
![](assets/20241205_105844_image.png)
> 使用哪种监听模式,视应用场景自行选择,一般选择**连续监听**即可,如果日常订单比较密集,可以选择**单次监听**,或多添加几个账号,减少密集查询风控
### 添加收款码 ### 添加收款码
点击可以查看当前账号的所有收款码
![](assets/20241205_110432_image.png)
点击**添加收款码**后,可以正常填写二维码信息
**终端编号**需要填写当前收款码在收银服务商系统内的编码,有的可以直接在收款二维码解析的**链接里找到**,有的需要**登陆商户管理中心**,去订单详情里查询才能知道
具体各个平台的终端编号如何获取,可以去**程序后端控制台主页**的`项目文档`查看
![](assets/20241205_110508_image.png)
![](assets/20241205_111720_image.png)
收款样式有两个选项`付款链接`和`图片地址`,根据实际情况选择
**付款链接:** 将二维码的内容解析成字符串保存,使用时再生成二维码
**图片地址:** 上传二维码图片到服务器或引用http远程图片地址
> 一般的**聚合收款码都解析成文字保存**即可,前端展示时会重新生成二维码,无法解析的就上传图片
### 🚀️ 设置监听 ### 🚀️ 设置监听
#### 订单监听 #### 宝塔任务计划
#### 账号收款监听 等会儿需要在这里设置任务监听
![](assets/20241205_112415_image.png)
#### 新订单监听
一个站点只需要设置一个定时任务,每次访问都会查询一次数据库,并生成新订单数据缓存
![](assets/20241205_112033_image.png)
![](assets/20241205_112517_image.png)
#### 账号监听
**每个账号都需要单独设置一个定时任务**,每次访问都会检索新订单缓存数据,如果存在该账户的新订单,插件就会去查询服务商后台的订单流水,并通知相关收款处理程序
![](assets/20241205_112116_image.png)
![](assets/20241205_113629_image.png)
### 支付测试 ### 支付测试
只开启一个账号,然后点击`支付测试`,正常支付后,观察是否成功回调,如果不能回调请重新检查配置,或再次详细查看**程序后端控制台主页**的`项目文档`
![](assets/20241205_113835_image.png)
--- ---
## ❤️ 微信/支付宝使用 ## ❤️ 微信/支付宝使用
@ -224,6 +296,7 @@
收款样式有两个选项`付款链接`和`图片地址`,根据实际情况选择 收款样式有两个选项`付款链接`和`图片地址`,根据实际情况选择
**付款链接:** 将二维码的内容解析成字符串保存,使用时再生成二维码 **付款链接:** 将二维码的内容解析成字符串保存,使用时再生成二维码
**图片地址:** 上传二维码图片到服务器或引用http远程图片地址 **图片地址:** 上传二维码图片到服务器或引用http远程图片地址
> `赞赏码`等收款方式,采用的不是标准二维码编码格式,不能解析成文字保存,只能展示图片,建议一般**二维码都解析成文字保存**,前端展示时会根据内容自动再生成二维码,无法解析的就上传图片 > `赞赏码`等收款方式,采用的不是标准二维码编码格式,不能解析成文字保存,只能展示图片,建议一般**二维码都解析成文字保存**,前端展示时会根据内容自动再生成二维码,无法解析的就上传图片
@ -320,6 +393,9 @@
# 补充说明 # 补充说明
* 该软件仅适用于个人线上免签收款,避免人工审核确认收款的繁琐步骤。请勿用于诈骗、黑灰产业,如有此类行为,后果自负。
* 插件中心目前还在开发中不支持在线安装插件如果有购买插件或定制其他收银平台插件的需求可以联系作者Wechat:K103516
# 页面展示 # 页面展示
![首页](assets/20241203_153935_image.png) ![首页](assets/20241203_153935_image.png)

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 175 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB