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,无额外依赖。
安装
- Xboard:后台 → Plugins → 上传下载的 ZIP → Install → 启用 "SnapEX Pay"。(或解压后将文件夹放入面板,命名为
plugins/Snapexpay/— 名称区分大小写 — 然后在 Plugins 中安装。) - V2Board 或旧版 Xboard:将压缩包中的
app/Payments/SnapexPay.php复制到面板中,如果使用 OPcache,请重启 PHP-FPM 或 Octane;在 V2Board 中确保已设置 Site URL(app_url)。 - Payment configuration → Add payment method → 网关 SnapexPay。填入来自 SnapEX Pay 后台的 API 密钥(权限
invoices.read、invoices.write)。 - 复制面板为该支付方式显示的 notify URL,在 SnapEX Pay 后台将其添加为 Webhook 端点,并将其
whsec_…密钥填入 Webhook secret。 - 如果价格不是 USD,请设置 "USD per 1 shop currency"(例如 CNY 为
0.14)。保存并测试一次付款。
设置
| API key | SnapEX Pay 后台 → API keys,权限 invoices.read 和 invoices.write。 |
|---|---|
| Webhook secret | Webhook 端点的 whsec_… 密钥。没有有效签名,任何订单都不会被标记为已支付。 |
| Network fee paid by | merchant:客户准确支付订单总额。customer:网络费用加在其上。 |
| Payment window, minutes | Xboard 默认 60(最大 120),V2Board 默认 20(最大 30)— 低于面板自身的订单超时。 |
| USD per 1 shop currency | USD 价格填 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%,无月费。