主机计费系统
Paymenter 加密货币支付
适用于开源主机计费面板 Paymenter 的网关扩展。客户在未支付的账单上选择 SnapEX Pay，使用 TRC20、ERC20 或 BEP20 上的 USDT，或 SnapEX Pay 页面提供的其他币种付款。签名 Webhook 记录付款，Paymenter 账单变为 Paid。
免费。版本 1.1.0。
功能
- 原生 Paymenter v1 网关扩展，显示在 Admin → Gateways 中。
- Webhook 通过 HMAC-SHA256 和 5 分钟窗口校验，记录任何付款前都会从 SnapEX Pay API 读取账单。
- 付款只记录一次：重复的 Webhook 不会添加第二笔交易。入账金额与账单金额完全一致，使用账单币种。
- 每个 Paymenter 站点只结算自己的账单（它们以
APP_URL的哈希值标记）。 - 测试模式下测试账单无需真实资金即可确认；网关处于正式模式时测试付款会被忽略。不以 USD 计费的店铺可设置固定 USD 汇率。
安装
- 解压压缩包，将其文件夹放入 Paymenter，命名为
extensions/Gateways/SnapexPay/（使SnapexPay.php和routes.php位于其中；名称必须与类名一致）。使用 Docker 镜像时，路径为/app/extensions/Gateways/SnapexPay。 - 如果网关没有显示，运行
composer dump-autoload -o和php artisan optimize:clear。 - 在 Paymenter 中进入 Admin → Gateways → New，选择 SnapEX Pay，填入来自 SnapEX Pay 后台的 API 密钥（权限
invoices.read、invoices.write）。 - 在后台 → Developers 将 Webhook URL 设为
https://<your-paymenter>/extensions/snapexpay/webhook，并将whsec_…密钥（仅在首次保存 URL 时显示一次）填入 Webhook secret。 - 将 Environment 设为
test，支付一张账单并在 SnapEX Pay 页面确认测试付款；账单应变为 Paid。然后切换回live。
设置
| API key | 来自 SnapEX Pay 后台 → API keys，权限 invoices.read 和 invoices.write。 |
|---|---|
| Webhook secret | Webhook 端点的 whsec_… 密钥。未签名或签名错误的 Webhook 会被拒绝。 |
| Network fee paid by | merchant：客户支付账单金额，手续费从您的到账金额中扣除。customer：SnapEX Pay 手续费和网络费用加在其上。 |
| Payment window, minutes | 1–1440，默认 60。 |
| USD per 1 invoice currency | 如果 Paymenter 以 USD 计费，填 1；EUR 按 1.08 USD 计时填 1.08。 |
| Environment | live 或 test。 |
| Partner ID | 可选：为您配置此模块的集成商的 Partner ID（SnapEX Pay 推荐计划）。如果是您自己安装，请留空。 |
| API URL | 保持不变。 |
常见问题
Admin → Gateways 中没有该网关。
检查路径 extensions/Gateways/SnapexPay/SnapexPay.php（区分大小写）以及 Web 服务器能否读取，然后运行 composer dump-autoload -o && php artisan optimize:clear。
客户已付款，但账单仍未支付。
在 SnapEX Pay 后台检查 Webhook 投递情况。400 invalid signature 表示密钥不匹配或服务器时钟不准；not_paid 表示当时付款尚未确认，invoice.paid Webhook 到达时账单会被结算。
客户付款少于账单金额。
部分支付的账单不会自动入账。请在 SnapEX Pay 后台检查付款，并在 Paymenter 中手动添加交易。
多个 Paymenter 站点可以共用一个 SnapEX Pay 账户吗？
每个站点只结算自己的账单（它们以 APP_URL 的哈希值标记），但一个 SnapEX Pay 账户只有一个 Webhook URL，而扩展只通过 Webhook 记录付款。因此只有被设为 Webhook 的站点能自动记录付款。
准备好接收加密货币了吗？
创建商户账户，获取 API 密钥并连接模块。每笔支付 1%，无月费。