VPN 面板
Remnawave 加密货币支付
为您的 Remnawave VPN 面板接收 USDT。这个小型服务为套餐创建 SnapEX Pay 账单，并将客户引导到托管支付页面。SnapEX Pay 确认付款后，它会创建 Remnawave 用户或续期现有用户，并返回订阅 URL。它与您的面板一起在 Docker 中运行，您的商店后端或 Telegram 机器人通过带两个需认证端点的 HTTP API 控制它。
免费。版本 1.1.0。
功能
- 由 SnapEX Pay 托管的支付页面：TRON（TRC20）、Ethereum（ERC20）或 BNB Chain（BEP20）上的 USDT；当该金额有可用的兑换路径时会出现其他币种。
- 付款后创建 Remnawave 用户（ACTIVE，带到期时间、流量限制、可选的 Telegram ID 和内部 squad），或续期现有用户。续期会把套餐天数加到现在与当前到期时间中较晚的那个之上。
- Webhook 通过 HMAC-SHA256 和 5 分钟窗口校验；随后从 SnapEX Pay API 读取账单状态，只有已支付的账单才会开通用户。
- 幂等：同一个 Webhook 即使同时到达两次，用户也只开通一次。
- 套餐在一个环境变量中设置；数据是一个 SQLite 文件，无需外部数据库。
安装
- 在 Remnawave 中进入 Remnawave Settings → API Tokens 创建令牌（不是管理员登录的 JWT — 面板会拒绝将其用于 API 调用）。复制新用户应加入的内部 squad 的 UUID。
- 在 SnapEX Pay 商户后台创建一个具有
invoices.read和invoices.write权限的 API 密钥。 - 下载并解压压缩包，运行
cp .env.example .env，设置SNAPEX_API_KEY、REMNAWAVE_URL、REMNAWAVE_TOKEN、REMNAWAVE_SQUADS以及一个较长的随机API_TOKEN。 - 启动：
docker compose up -d，检查curl -s http://127.0.0.1:8080/health，并将其置于您的 HTTPS 反向代理之后。 - 在后台 → Developers 将 Webhook URL 设为
https://<your service>/webhook，将whsec_…密钥（仅在首次保存 URL 时显示一次）填入SNAPEX_WEBHOOK_SECRET并重启。 - 从您的后端或机器人调用
POST /v1/checkout，带上Authorization: Bearer <API_TOKEN>，把pay_url发给客户，并通过GET /v1/orders/{invoice_id}获取订阅 URL。
设置
| SNAPEX_API_KEY, SNAPEX_WEBHOOK_SECRET | 商户 API 密钥（invoices.read、invoices.write）和 Webhook 签名密钥（whsec_…）。 |
|---|---|
| SNAPEX_ENVIRONMENT, SNAPEX_FEE_ON | live 或 test（测试账单无需真实资金即可确认）；谁支付服务费 — merchant 或 customer。 |
| REMNAWAVE_URL, REMNAWAVE_TOKEN | 面板 URL（或在共享 Docker 网络中使用 http://remnawave:3000）和 Remnawave API 令牌。 |
| REMNAWAVE_SQUADS | 新用户的内部 squad UUID。没有 squad 的用户没有入站，其订阅将为空。 |
| API_TOKEN | 您的商店或机器人发送到 /v1/checkout 和 /v1/orders/… 的 Bearer 令牌。 |
| PLANS | id:days:usd:traffic_bytes，逗号分隔；0 字节 = 不限。 |
| SNAPEX_PARTNER_ID | 可选：为您配置此模块的集成商的 Partner ID（SnapEX Pay 推荐计划）。如果是您自己安装，请留空。 |
常见问题
支持哪些 Remnawave 版本？
Remnawave 2.2 或更高版本。
为什么新用户的订阅是空的？
没有内部 squad 的用户没有入站。请将新用户的 squad UUID 填入 REMNAWAVE_SQUADS；现有用户保留其 squad。
续期如何运作？
为现有用户名付款时，套餐天数会加到现在与用户当前到期时间中较晚的那个之上。流量限制设为新套餐的值。
一笔付款会创建两次用户吗？
不会。即使同一个 Webhook 同时到达两次，用户也只开通一次。
有现成的 Telegram 机器人吗？
有，一个独立的 SnapEX Pay Telegram 机器人，适用于 Marzban、3x-ui 和 Remnawave。如果您已有自己的机器人或商店，则适合使用本服务。
准备好接收加密货币了吗？
创建商户账户，获取 API 密钥并连接模块。每笔支付 1%，无月费。