EasyPay Gateway v1.0.1

EasyPay Gateway v1.0.1

适用于 ZJMF-CBAP V10 的通用易支付 V1 聚合支付网关。支持可配置的 HTTPS 收银台、签名 POST 跳转、异步通知验签、金额与订单归属核对，以及重复通知幂等保护。

这是当前推荐使用的公开版本。

主要功能

• 支持聚合收银台及 alipay、wxpay、qqpay、bank、jdpay、paypal、douyinpay 固定通道。
• 使用唯一的 HTTPS POST 表单提交支付请求，不使用 GET 参数拼接。
• 支持 V10 data-v10-payment-mode="redirect" 支付能力合同。
• 不在插件内注入自动提交 JavaScript，并保留手动“前往收银台”按钮兼容旧主题。
• 回调入账前核对签名、商户、成功状态、金额、通道、临时订单和正式订单关系。
• 使用支付意图快照、数据库唯一索引和 MySQL 命名锁处理重复及并发通知。
• 同步返回只负责跳回订单页，不执行入账。
• install() 与 upgrade() 均可重复执行，不修改 V10 Core。

安装方法

1. 下载附件 easy_pay_gateway_1.0.1.zip。

2. 上传到 V10 服务器的 public/plugins/ 目录。

3. 在 public/plugins/ 内解压。

4. 确认入口文件位于：

   public/plugins/gateway/easy_pay_gateway/EasyPayGateway.php

5. 刷新 V10 后台插件页面。

6. 安装插件，填写支付配置并启用。

GitHub 自动生成的 Source code ZIP 和 TAR.GZ 不是 V10 插件安装包。

必填配置

• 易支付服务商提供的 HTTPS 收银台提交地址
• 数字商户 ID
• 商户密钥
• 当前 V10 站点可公网访问的 HTTPS 回调地址
• 聚合收银台或指定支付通道

仓库中的 example.com 地址仅用于演示，不能用于真实收款。

兼容性与安全说明

• 按本地 ZJMF-CBAP V10 10.4.6 源码合同开发，部署到其他版本前应在同版本副本验证。
• 保持 PHP 7.3 语法兼容，CI 同时覆盖 PHP 7.3、8.2 和 8.4。
• 仅支持 CNY。
• 易支付 V1 的 MD5 签名属于历史兼容协议，生产环境必须使用 HTTPS 和强随机商户密钥。
• 插件不声明自动退款能力。

SHA-256

b2ec4505a5c4ad2d1ca95140ac91135377057342e4988219e1b8d68bfe589e32  easy_pay_gateway_1.0.1.zip