独角 Next 对接新版 epusdt（EPAY V1）完整教程

教程说明

这篇教程只讲一个场景： 独角 Next 已经部署好了，epusdt 也已经部署好了，现在要用「易支付 v1」方式把新版 epusdt 接进独角 Next，并且前台能正常跳到收银台。

以下内容按当前独角后台字段和现有 epusdt 实际兼容路径整理，直接照着填即可。

重点先记住：独角 Next 后台新增的是 易支付 v1 渠道，但 支付网关 要填你的 epusdt v1 兼容接口， 不要在后台手工写 **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 后台先新增支付渠道

1. 登录独角 Next 后台
2. 打开左侧 支付管理
3. 进入 支付渠道
4. 点击右上角 新增渠道
   

三、易支付 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 或其它系统配置页面。

四、前台测试时应该看到什么

1. 前台下一个测试订单

2. 支付方式里选择你刚刚新增的这个渠道

3. 提交后先跳到 epusdt 收银台第一页
   

4. 选择网络和币种后点击 确认

5. 页面生成实际应付币种、二维码和收款地址
   

如果这一步已经能正常看到二维码和地址，说明 支付网关 、 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 收银台。