主机计费系统
WHMCS 加密货币支付
在 WHMCS 账单上接收加密货币。客户点击 Pay Now，在 SnapEX Pay 页面使用 TRON、Ethereum、BSC 等网络上的 USDT，或兑换为 USDT 的其他币种付款，账单在 WHMCS 中自动标记为已支付。
免费。版本 1.1.0。
功能
- 无需运行钱包或节点：资金进入您的 SnapEX Pay 商户余额。
- 账单通过三种独立方式标记为已支付：签名 Webhook、客户从支付页面返回，以及 WHMCS cron 运行时的后台检查（每笔待处理付款最多每 10 分钟检查一次，持续 5 天）。丢失的 Webhook 不会让已付账单停留在未支付状态，付款也不会被重复添加。
- 多币种 WHMCS：将 Convert To For Processing 设为 USD 后，账单仍按客户的币种记录。
- 部分付款不会自动入账：它们进入 Gateway Log 供您审核。配置 Webhook 后，SnapEX Pay 账单关闭后才到账的资金也会记录在那里。
- 测试模式：测试账单无需真实资金即可自动确认；开启期间只有已登录的管理员能看到支付按钮，其他客户看到的是“test mode”提示。
安装
- 将压缩包内容上传到 WHMCS 根目录并保持路径：
modules/gateways/snapexpay.php、modules/gateways/snapexpay/、modules/gateways/callback/snapexpay.php、includes/hooks/snapexpay.php。 - 在 WHMCS 后台打开 System Settings → Payment Gateways → All Payment Gateways，激活 SnapEX Pay (Crypto)。
- 在 SnapEX Pay 商户后台创建一个具有
invoices.read和invoices.write权限的 API 密钥，并填入 API key。 - Webhook（推荐）：在后台将 Webhook URL 设为
https://<your WHMCS>/modules/gateways/callback/snapexpay.php（准确地址显示在 WHMCS 字段下方），并将whsec_…密钥填入 Webhook secret。 - 如果您的 WHMCS 币种不是 USD，请将 Convert To For Processing 设为 USD。账单仍按客户的币种记录。
- 开启 Test mode，以管理员身份打开一张未支付账单，在 SnapEX Pay 页面用测试方式支付，检查其变为 Paid。然后关闭测试模式。
设置
| API key | 来自 SnapEX Pay 后台。 |
|---|---|
| Webhook secret | 后台 Webhook 设置中的 whsec_…。没有它，模块仍可通过返回页面和 cron 工作。 |
| Network fee paid by | Merchant：客户准确支付账单金额，手续费从您的到账金额中扣除。Client：SnapEX Pay 手续费和网络费用加在其上。 |
| Payment window, minutes | 支付页面的有效时长（1–1440，默认 60）。之后再次点击 Pay Now 会打开新的页面。 |
| Test mode | 测试账单；开启期间只有管理员能看到支付按钮。测试模式关闭后，测试付款会被忽略。 |
| Partner ID | 可选：为您配置此模块的集成商的 Partner ID（SnapEX Pay 推荐计划）。如果是您自己安装，请留空。 |
| API URL | 保持不变。 |
常见问题
如果 Webhook 没有到达会怎样？
账单仍会被标记为已支付：模块在客户从支付页面返回时以及 WHMCS cron 运行时也会检查付款（每笔待处理付款最多每 10 分钟一次，持续 5 天）。付款不会被重复添加。
我的 WHMCS 币种不是 USD，可以使用吗？
可以。在网关设置中将 Convert To For Processing 设为 USD；账单仍按客户的币种记录。
如果客户付款少于账单金额怎么办？
如果客户未及时补足，不会自动入账。Gateway Log 中会记录 "Partial payment — review and apply manually" 以及收到的金额。
如果资金在 SnapEX Pay 账单关闭后才到账怎么办？
它不会在 WHMCS 中自动入账。配置 Webhook 后，Gateway Log 中会记录一条；资金在您的 SnapEX Pay 余额中。
可以不用真实资金测试吗？
可以。开启 Test mode：测试账单会自动确认，开启期间只有已登录的管理员能看到支付按钮。
在哪里查看模块做了什么？
在 WHMCS 的 Billing → Gateway Log。付款的交易 ID 是 SnapEX Pay 账单 ID（inv_…）。
准备好接收加密货币了吗？
创建商户账户，获取 API 密钥并连接模块。每笔支付 1%，无月费。