易支付V2 - 帮助文档

插件说明

易支付 V2（RSA） 支付通道。支持在插件配置中自定义同步 / 异步支付模式，以及异步下的优先参数（扫码 / 跳转链接）。

默认推荐支付平台：https://pay.ithxs.com（接口地址可直接填写此地址；也可对接其它兼容易支付 V2 的网关）。

使用步骤

打开推荐平台 https://pay.ithxs.com 注册/登录，获取商户 ID、平台公钥、商户私钥。
安装并启用本插件后，打开：站点配置 → 支付配置，选择「易支付V2」。
接口地址填写 https://pay.ithxs.com，再按 QQ / 微信 / 支付宝分别填写商户参数（可只配需要的方式）。
将对应支付方式通道切换为本插件标识 epayV2。
用小额订单验证：下单 → 付款 → 异步回调入账。

配置项说明

字段	说明
接口地址	易支付 V2 网关根地址。默认推荐 `https://pay.ithxs.com`（不要末尾多余路径）
商户ID	网关分配的 PID
平台公钥	用于回调验签。可带 PEM 头，也可只贴 Base64 正文
商户私钥	用于发起下单签名。切勿与平台公钥填反
支付模式	填数字：`1`=异步统一下单（推荐）；`2`=同步跳转网关收银台
优先参数	仅异步有效：`1`=优先本站扫码；`2`=优先打开付款链接。缺一边会自动回退

同步 vs 异步

1 异步：服务端请求 /api/pay/mapi，按优先参数展示二维码或打开付款链接。
2 同步：浏览器 auto-submit POST 到 /api/pay/submit，由网关出收银台。
入账以异步 notify 为准；同步 return 会再次走同一履约逻辑（幂等，不重复发货）。

支付方式 type

alipay 支付宝 / wxpay 微信 / qqpay QQ 钱包
由站点支付配置的通道开关决定是否开放；与 sync/async 正交。
本插件不是微信/支付宝官方直连，仍走易支付 type 参数。

安全与幂等

V2 回调：RSA 验签 + 金额一致 + timestamp 不超过 300 秒；不会把查单当作入账门槛。
同一订单多次 notify / return 只履约一次（文件锁 + Pay::PaySuccess）。
密钥仅保存在本站配置，勿泄露商户私钥。

回调地址

异步：{域名}/includes/CallBack.php?uis=3HsDepayV2
同步：{域名}/includes/CallBack.php?uis=4HsDepayV2

钩子与冲突

本插件为支付接口插件，通过 typeS 1~4 接入，不绑定业务改价钩子。
同一支付方式（如支付宝）同时只能选用一个支付插件通道；与其它支付插件不并存生效。
授权：本地插件，无云端授权依赖，不存在授权宽限问题。