ZH
VPN 面板

Xboard 和 V2Board 加密货币支付

适用于 Xboard 和 V2Board VPN 及代理面板的支付插件。结账时客户进入 SnapEX Pay 页面,使用 TRC20、ERC20 或 BEP20 上的 USDT(或 SnapEX 针对该金额提供的其他方式)付款,签名 Webhook 到达后订单自动开通。无需运行钱包、节点或自托管网关;资金进入您的 SnapEX Pay 商户余额。

下载模块

免费。版本 1.2.0。

功能

  • 原生 Xboard 插件(可从后台插件管理器安装),另附适用于 V2Board 和旧版 Xboard 的即插即用类 app/Payments/SnapexPay.php。
  • 正确的金额单位:面板以分为单位的总额会以十进制 USD 金额发送,非 USD 店铺可选设置汇率。
  • 签名 Webhook(HMAC-SHA256,5 分钟窗口);账单会从 SnapEX Pay API 重新读取,只有状态为 paid 时订单才会被标记为已支付。
  • 再次点击支付会复用同一张账单;如果已过期,则为同一订单打开新的账单。支付方式处于正式模式时,测试账单永远不会开通订单。
  • 支付时限被限制在面板自身的订单超时之内,因此客户无法为面板已取消的订单付款。纯 PHP 和 cURL,无额外依赖。

安装

  1. Xboard:后台 → Plugins → 上传下载的 ZIP → Install → 启用 "SnapEX Pay"。(或解压后将文件夹放入面板,命名为 plugins/Snapexpay/ — 名称区分大小写 — 然后在 Plugins 中安装。)
  2. V2Board 或旧版 Xboard:将压缩包中的 app/Payments/SnapexPay.php 复制到面板中,如果使用 OPcache,请重启 PHP-FPM 或 Octane;在 V2Board 中确保已设置 Site URL(app_url)。
  3. Payment configuration → Add payment method → 网关 SnapexPay。填入来自 SnapEX Pay 后台的 API 密钥(权限 invoices.read、invoices.write)。
  4. 复制面板为该支付方式显示的 notify URL,在 SnapEX Pay 后台将其添加为 Webhook 端点,并将其 whsec_… 密钥填入 Webhook secret。
  5. 如果价格不是 USD,请设置 "USD per 1 shop currency"(例如 CNY 为 0.14)。保存并测试一次付款。

设置

API keySnapEX Pay 后台 → API keys,权限 invoices.read 和 invoices.write。
Webhook secretWebhook 端点的 whsec_… 密钥。没有有效签名,任何订单都不会被标记为已支付。
Network fee paid bymerchant:客户准确支付订单总额。customer:网络费用加在其上。
Payment window, minutesXboard 默认 60(最大 120),V2Board 默认 20(最大 30)— 低于面板自身的订单超时。
USD per 1 shop currencyUSD 价格填 1;例如 CNY 填 0.14。

分步配置指南 →

常见问题

支持 V2Board 吗?

支持。Xboard 使用原生插件;V2Board 和旧版 Xboard 使用即插即用类 app/Payments/SnapexPay.php,设置相同。

我的价格是人民币或其他币种。

设置 "USD per 1 shop currency":金额为 total / 100 × usd_rate,例如 CNY 为 0.14。

客户点击两次支付会怎样?

复用同一张账单;如果已过期,则为同一订单打开新的账单。

为什么支付时限有限制?

Xboard 在 2 小时后取消未付订单,V2Board 在 30 分钟后取消,因此时限被限制在此之下,客户无法为已取消的订单付款。

为什么需要 HTTPS?

SnapEX Pay 只向公网 HTTPS URL 投递 Webhook,订单在 Webhook 到达时开通。

准备好接收加密货币了吗?

创建商户账户,获取 API 密钥并连接模块。每笔支付 1%,无月费。