主机计费系统
BILLmanager 加密货币支付
在 BILLmanager 中接收加密货币。客户在充值或支付订单时选择 SnapEX Pay (crypto)，在 SnapEX Pay 页面使用 TRON、Ethereum、BSC 等网络上的 USDT，或兑换为 USDT 的其他币种付款，付款在 BILLmanager 中自动入账。
免费。版本 1.1.0。
功能
- 无需运行钱包或节点：资金进入您的 SnapEX Pay 商户余额。
- 付款通过三种独立方式入账：签名 Webhook、客户从支付页面返回，以及定期检查（
checkpay）。丢失的 Webhook 不会让已付款项无法入账，付款也不会被重复入账。 - 金额始终从 SnapEX Pay API 重新读取；仅凭 Webhook 内容不会入账任何款项。
- 部分付款不会自动入账：日志会提示您进行审核。
- 测试模式：测试账单无需真实资金即可自动确认，测试模式关闭后永不入账。
安装
- 在 BILLmanager 主机上以 root 身份执行：
tar xzf snapexpay-billmanager-1.1.0.tar.gz、cd snapexpay-billmanager-1.1.0、sh install.sh。它会将模块复制到/usr/local/mgr5，添加每 5 分钟运行的checkpaycron（/etc/cron.d/snapexpay）作为保障，并重启 BILLmanager。 - 在 SnapEX Pay 商户后台创建一个具有
invoices.read和invoices.write权限的 API 密钥。 - BILLmanager → Provider → Payment methods → Add → SnapEX Pay (crypto)。币种：USD。填入 API 密钥；保存时会向 SnapEX Pay 验证密钥。
- Webhook（推荐）：在后台将 Webhook URL 设为
https://<your billing domain>/mancgi/snapexpayresult，并将whsec_…密钥填入 Webhook secret。 - 使用其他币种付款的客户：BILLmanager 按其汇率将金额换算为支付方式的币种（USD），请保持 USD 汇率为最新。
- 先测试：建立一个开启 Test mode 的单独支付方式，仅对测试客户开放（Payment methods → 按客户组限制）。然后关闭测试模式或删除它。
设置
| API key | 来自 SnapEX Pay 后台。 |
|---|---|
| Webhook secret | 后台 Webhook 设置中的 whsec_…。没有它，付款仍会在客户返回时和定期检查时入账。 |
| Client pays the network fee | 关闭：客户准确支付付款金额，手续费从您的到账金额中扣除。开启：SnapEX Pay 手续费和网络费用加在其上。 |
| Payment window, minutes | SnapEX 支付页面的有效时长（1–1440，默认 60）。之后再次打开支付会创建新的页面。 |
| Test mode | 无需真实资金的测试账单。关闭后测试付款永不入账。 |
| API URL | 留空。 |
| Partner ID | 可选：为您配置此模块的集成商的 Partner ID（SnapEX Pay 推荐计划）。如果是您自己安装，请留空。 |
常见问题
支持哪些 BILLmanager 版本？
BILLmanager 6 的所有版本。模块只需要 BILLmanager 主机上带标准库的 python3 3.6+。
如果 Webhook 没有到达会怎样？
付款仍会在客户从支付页面返回时，或在每 5 分钟运行的定期检查时入账。付款不会被重复入账。
我的客户使用卢布或其他币种付款，可以使用吗？
可以。支付方式使用 USD，BILLmanager 按其汇率换算金额；请保持 USD 汇率为最新。
如果客户付款不足怎么办？
如果客户未及时补足，不会入账，日志中会显示 "closed with a PARTIAL payment (…) - review in SnapEX Pay and credit manually"。
如果客户没有按时付款怎么办？
付款保持 "In payment" 状态，客户可以再次尝试；在最后一张 SnapEX 账单过期一天后，付款会被取消。
如何卸载模块？
运行 sh install.sh --uninstall。付款历史保存在 var/snapexpay.sqlite。模块的所有操作都记录在 /usr/local/mgr5/var/pmsnapexpay.log。
准备好接收加密货币了吗？
创建商户账户，获取 API 密钥并连接模块。每笔支付 1%，无月费。