电商插件
WHMCS 网关
安装并配置官方 WHMCS 支付网关,支持原生 OAuth、DPoP 绑定令牌、托管 MakePay 结账和签名回调。
概述
MakePay WHMCS 网关为 WHMCS 发票加入托管加密支付,支持原生 OAuth、DPoP 绑定令牌、托管 MakePay 结账和签名回调。
开始之前
- WHMCS 使用 HTTPS。
- PHP 启用 OpenSSL。
- 拥有安装网关模块和管理支付网关的管理员权限。
- MakeCrypto 公司已配置 MakePay 结算。
安装网关
下载官方 ZIP:
https://plugins.makecrypto.io/downloads/whmcs/latest.zip
上传到 WHMCS 根目录后,在支付网关设置中启用 MakePay。
使用 OAuth 连接
在网关配置中点击 Connect MakePay,登录 MakeCrypto,选择公司并批准访问。返回 WHMCS 后确认连接和 Webhook secret。
配置 MakePay
设置显示名称、结算币种、支付链接过期时间、回调 URL 和手动 API key 回退字段。普通安装使用连接模式。
结账流程
客户在 WHMCS 发票上选择 MakePay,网关创建支付链接并跳转到托管结账。签名回调会把支付结果同步回发票。
发票状态
成功付款会把发票标记为 paid。失败、取消、过期或退款会按 WHMCS 规则记录失败或撤销。其他状态保持 unpaid/pending。
安全说明
保护 OAuth 令牌、API secret 和 Webhook secret。限制 WHMCS 管理后台访问,并在 MakeCrypto 中撤销不再使用的连接。
故障排查
如果回调失败,请确认 WHMCS 系统 URL、网关回调 URL 和公网 HTTPS 都正确。检查 MakeCrypto Webhook 日志、WHMCS gateway log 和安全规则。