一个适用于Koishi框架的易支付工具插件,支持订单创建、查询、退款、分配等功能,集成微信支付和支付宝支付。
- ✅ 支付订单创建
- ✅ 订单状态查询
- ✅ 订单退款处理
- ✅ 订单分配功能
- ✅ 支付成功回调处理
- ✅ 多种支付方式支持(支付宝、微信支付、自定义)
- ✅ 数据库订单记录
- ✅ 安全的MD5签名验证
在Koishi管理界面中配置以下选项:
- 管理员QQ号: 具有订单查询和退款权限的QQ号
- 回调路由: 支付回调的路由前缀(默认:/paytool/callback/)
- 调试模式: 启用详细日志输出,便于问题排查
- 主动查询模式: 用于无法接收回调通知的环境,自动轮询订单状态
- 等待时长: 首次查询新订单需要等待的时间(默认:30秒)
- 轮询间隔: 每次查询订单后的等待时间(默认:30秒)
- 订单过期时间: 超过此时间将停止主动查询(默认:30分钟)
- 接口地址: 易支付平台的API地址 (如: https://your-epay-domain.com)
- 商户PID: 易支付商户唯一标识
- 商户密钥: 易支付商户密钥
- 商品名称: 订单中显示的商品名称(默认:金币)
- 支付方式配置: 自定义支付方式和显示名称(如:alipay -> 支付宝)
- 默认支付方式: 创建订单时的默认支付方式代码(如:wxpay)
- 回调通知地址: 完整的回调通知URL(默认:https://koishi.local/paytool/callback/)
- 跳转地址: 交易完成后浏览器跳转地址(可选,留空则不跳转)
所有指令均需要管理员权限。
pay.create <金额> [支付方式]
pay.query <订单号> # 查询指定订单
pay.query @用户 # 查询用户所有订单
pay.refund <订单号>
pay.provisioning <订单号> @用户
- 自动回调处理: 支付成功后自动更新订单状态
- 主动查询模式: 可配置自动轮询订单状态
- 订单归属: 支持将订单分配给指定用户
- 安全验证: MD5签名验证,管理员权限控制
如果您想为本项目贡献代码,请查看 贡献指南 了解:
项目使用 semantic-release 进行自动版本管理和发布。
MIT License