异次元v3商城易支付对接 epusdt

1. 在 epusdt 后台获取 PID 和密钥

登录 https://你的epusdt域名/sign-in。

进入 支付管理，记下 PID 和 密钥。

2. 先配置异次元的易支付插件

异次元后台路径：支付管理 -> 支付插件 -> 易支付 -> 配置

这一页只填 epusdt 提供的接口参数，先把插件本身配好，再去新增支付方式。

• 支付网关：https://你的epusdt域名/payments/epay/v1/order/create-transaction
• 商户ID：epusdt 支付管理里的 PID
• 商户密钥：epusdt 支付管理里的 Secret
• MAPI：关闭

保存后不要手动再拼 submit.php 或 mapi.php，异次元插件会自动拼接请求地址。

3. 再新增异次元支付方式

异次元后台路径：支付管理 -> 支付接口 -> 添加支付

先选择插件：易支付(v1.0.5)

这一页控制的是异次元前台显示名称、显示类型和启用范围，按你自己的站点实际情况填写。

• 支付名称：按实际填写，例如 USDT-TRC20、TRX、加密货币支付
• 显示终端：一般选 通用，如果你站点区分 PC / H5 再按实际调整
• 支付类型：按前台展示需求选择，常见可选 支付宝、微信、QQ钱包
• 下单手续费：按实际填写，不收手续费就填 0
• 手续费模式：按实际选择，不确定先用 单笔固定
• 商品下单：需要商品支付就启用
• 会员充值：需要充值功能就启用
• 显示排序：按实际填写，数值越小越靠前

4. 如提示“重要参数缺失，请检查插件配置文件！”

修改文件：app/Pay/Epay/Impl/Pay.php

$version = isset($this->config['version']) ? (int)$this->config['version'] : 0;
$mapi = isset($this->config['mapi']) ? (int)$this->config['mapi'] : 0;

if (empty($this->config['url']) ||
    empty($this->config['pid']) ||
    ($version === 1 && (empty($this->config['private_key']) || empty($this->config['platform_public_key']))) ||
    ($version === 0 && empty($this->config['key']))) {
    throw new JSONException("重要参数缺失，请检查插件配置文件！");
}

只想临时解决，也可以在 app/Pay/Epay/Config/Config.php 手动加一行：

'version' => 0,

5. 回调地址

• 异次元发起订单时，会自动带上回调地址：https://你的站点域名/user/api/order/callback.Epay
• 这一项不是在插件配置页手动填写的，而是异次元下单时自动提交给 epusdt
• 同步返回会自动回到订单页

6. 保存后怎么测试

• 前台任选一个商品，选择你刚新增的支付方式发起支付
• 如果页面能正常跳到 https://你的epusdt域名/payments/epay/... 或直接进入 epusdt 收银台，说明配置正常
• 如果提示 重要参数缺失，请检查插件配置文件！，按第 4 步修复
• 如果能跳转但回调不成功，先检查你的站点域名是否能访问 /user/api/order/callback.Epay