主机计费系统
Blesta 加密货币支付
在 Blesta 账单上接收加密货币。SnapEX Pay 是一个 non-merchant 网关：客户选择 SnapEX Pay (Crypto)，在 SnapEX Pay 页面使用 TRON、Ethereum、BSC 等网络上的 USDT，或兑换为 USDT 的其他币种付款，付款在 Blesta 中自动记录并应用到账单。
免费。版本 1.0.0。
功能
- 无需运行钱包或节点：资金进入您的 SnapEX Pay 商户余额。
- 付款通过签名 Webhook 记录，或在客户回到“付款已收到”页面时立即记录，以先发生者为准。两种情况下都会先从 SnapEX Pay API 重新读取账单：仅凭 Webhook 内容不会将任何账单标记为已支付，付款也不会被重复记录。
- 任意账单币种：非 USD 金额按 Blesta 已有的汇率换算为 USD，交易按账单币种记录。
- 部分付款不会自动应用：它们会成为一笔待处理（pending）交易供您审核。
- 测试模式：测试账单无需真实资金即可自动确认；开启期间只有以客户身份登录的员工能看到按钮，其他客户会被提示选择其他支付方式。
安装
- 将压缩包内容上传到 Blesta 根目录并保持路径
components/gateways/nonmerchant/snapex_pay/。 - 在 Blesta 后台打开 Settings → Payment Gateways → Available，找到 SnapEX Pay (Crypto) 并点击 Install。安装会创建一张表
snapex_pay_invoices。 - 在 SnapEX Pay 商户后台创建一个具有
invoices.read和invoices.write权限的 API 密钥，并填入 API key。 - Webhook（必需）：在后台添加 Webhook，URL 为
https://<your Blesta>/callback/gw/<company id>/snapex_pay/（准确地址显示在网关设置中），并将whsec_…密钥填入 Webhook secret。Blesta 没有为网关提供 cron，因此客户付款后未返回网站时，付款要靠 Webhook 送达。 - 如果您的账单不是 USD，请在 Settings → Company → Currencies 中添加 USD 并设置汇率（或让 Blesta 自动更新汇率）。勾选应提供该网关的币种。
- 开启 Test mode，从后台以客户身份登录客户区，在 SnapEX Pay 页面用测试方式支付一张账单，检查账单已支付。然后关闭测试模式。
设置
| API key | 来自 SnapEX Pay 后台。加密存储。 |
|---|---|
| Webhook secret | 后台 Webhook 设置中的 whsec_…。必填。加密存储。 |
| Network fee paid by | Merchant：客户准确支付账单金额。Client：手续费加在其上。 |
| Payment window, minutes | 支付页面的有效时长（1–1440，默认 60）。之后再次付款会打开新的页面。 |
| Test mode | 测试账单；开启期间只有员工能看到按钮。测试模式关闭后，测试付款会被忽略。 |
| Partner ID | 可选：为您配置此模块的集成商的 Partner ID（SnapEX Pay 推荐计划）。如果是您自己安装，请留空。 |
| API URL | 保持不变。 |
常见问题
为什么 Webhook 是必需的？
Blesta 没有为网关提供 cron。如果客户付款后没有返回网站，付款要通过签名 Webhook 送达 Blesta。客户返回时，付款会立即记录，且不会被重复记录。
我的账单不是 USD，可以使用吗？
可以。在 Settings → Company → Currencies 中添加 USD 并设置汇率。金额按 Blesta 的汇率换算，交易按账单币种记录。
账单支付后 Blesta 中会出现什么？
一笔按账单币种记录的已批准（approved）交易，应用到已支付的账单。交易 ID 是 SnapEX Pay 账单 ID（inv_…），客户会收到 Blesta 常规的“付款已收到”邮件。
如果客户付款少于账单金额怎么办？
如果客户未及时补足，会记录一笔待处理交易，消息中注明收到的金额，且不会应用到账单。请在该客户的交易中审核。
如果支付页面过期且未付款怎么办？
不会记录任何内容。如果资金在账单关闭后才到账，网关日志中会记录一条；资金在您的 SnapEX Pay 余额中。
在哪里查看模块做了什么？
在 Blesta 的 Tools → Logs → Gateway。
准备好接收加密货币了吗？
创建商户账户，获取 API 密钥并连接模块。每笔支付 1%，无月费。