独角 Next 对接新版 epusdt（EPAY V1）完整教程
教程说明
这篇教程只讲一个场景：独角 Next 已经部署好了，epusdt 也已经部署好了，现在要用「易支付 v1」方式把新版 epusdt 接进独角 Next，并且前台能正常跳到收银台。
以下内容按当前独角后台字段和现有 epusdt 实际兼容路径整理，直接照着填即可。
重点先记住：独角 Next 后台新增的是易支付 v1渠道，但支付网关要填你的epusdtv1 兼容接口，不要在后台手工写submit.php。
一、先确认 epusdt 侧前提
- epusdt 后台已经添加并启用了至少 1 个可用的
TRON收款地址 - epusdt 后台左侧
支付密钥页面已经创建并启用了可用支付密钥，并且你能拿到同一条记录里的PID和Secret .env里已经填写api_rate_url=https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api@latest/v1/currencies/
api_rate_url 不要留空。实测留空时，前台虽然能跳到收银台，但选择网络和币种后点击 确认 会直接报 rate calculation failed，无法生成实际收款金额和地址。
二、独角 Next 后台先新增支付渠道
- 登录独角 Next 后台
- 打开左侧
支付管理 - 进入
支付渠道 - 点击右上角
新增渠道
三、易支付 v1 这一块怎么填
核心思路：渠道类型选 易支付，但支付网关填的是 epusdt 的兼容接口。
- 版本：
v1 - 支付网关：
https://你的epusdt域名/payments/epay/v1/order/create-transaction - 商户ID：填 epusdt 后台左侧
支付密钥页面这条记录里的PID，这里应是纯数字 - 商户密钥：填同一条支付密钥记录里的
Secret，可点眼睛查看或点复制图标复制，不是.env里的api_auth_token - 通知地址：
https://你的独角API域名/api/v1/payments/callback - 同步地址：
https://你的独角前台域名/pay - 目标货币：
CNY - 汇率基数：留空即可
- 交互方式：建议选
跳转 - 启用：打开
注意 1：通知地址 和 同步地址 在独角后台不会自动生成，需要你自己手动填写。
注意 2：后台支付网关只填到 /payments/epay/v1/order/create-transaction 即可，不要手工补 /submit.php。实际支付链接里如果出现 submit.php，属于 epusdt 的兼容跳转路径，正常即可。
注意 3：你当前这套 GMPay / epusdt 后台里，这两个值就在左侧 支付密钥 页面，不在钱包地址、链、RPC 或其它系统配置页面。
四、前台测试时应该看到什么
- 前台下一个测试订单
- 支付方式里选择你刚刚新增的这个渠道
- 提交后先跳到 epusdt 收银台第一页
- 选择网络和币种后点击
确认 - 页面生成实际应付币种、二维码和收款地址
如果这一步已经能正常看到二维码和地址，说明 支付网关、PID/Secret、TRON 地址、api_rate_url 这几项已经跑通。接着再做一笔小额真实支付，确认独角订单能自动回调成功。
五、回调和返回页怎么理解
notify_url是给独角 Next 后端收回调的，不是给浏览器看的页面return_url是支付完成后浏览器跳回去的地址，建议固定填独角前台的/pay，不要只填首页- 如果你下的是游客订单，回跳后的展示逻辑属于独角 Next 自己的前台流程，不要把它和 epusdt 网关是否可用混在一起判断
六、最容易填错的地方
- 把支付网关写成根域名，或者手工补了
submit.php merchant_id没填支付密钥页面里的PID，或者填了非数字内容merchant_key填错成api_auth_token、旧 Secret，或者地址管理 / 链 / RPC 页面里的其它值notify_url/return_url留空，或者填成不是独角自己的地址api_rate_url留空，导致确认时报rate calculation failed- epusdt 里没有启用可用的
TRON收款地址
七、直接记住这一套
独角 Next 后台新增 易支付 v1 渠道时，后台实际要填的是 epusdt 的兼容接口：/payments/epay/v1/order/create-transaction。同一条 支付密钥 记录里的 PID 和 Secret 分别填到商户ID和商户密钥，notify_url 填独角 API 回调地址，return_url 填独角前台 /pay，前台就能正常跳到 epusdt 收银台。
