财务系统对接
把 WHMCS 或智简魔方接到 CDN：客户在财务系统下单、续费、停用、升降级时自动开户、开套餐、停服、续期，并支持免密登录控制台和用量回传。
能解决什么问题
IDC 商的客户都在 WHMCS 或智简魔方里下单付款，CDN 账号却要在另一个后台手工开。财务系统对接把两边连起来：客户在财务系统里下单、续费、停用、升降级时，CDN 侧自动开户、开套餐、停服、续期、改套餐；客户在财务系统点按钮即可免密进入 CDN 控制台，财务系统也能显示流量用量。
两种接法，可以同时用：
| 接法 | 密钥在哪里生成 | 能管谁 |
|---|---|---|
| 代理商在平台上转售 | 用户端“代理商 → 财务对接” | 只管这个代理商名下的客户，开通按批发价从预付余额扣费 |
| 自建主控直接对接 | 管理端“系统管理 → 财务对接” | 管这个主控上的直客 |
怎么开通与启用
财务系统对接是商业版的官方免费插件，在插件商店获取后生效；社区版不包含。
- 在“财务对接”页下载 PHP 模块（WHMCS、智简魔方老版、智简魔方 V10 业务系统），以 WHMCS 为例，解压到 WHMCS 根目录的
modules/servers/。 - 点“新建密钥”，填财务系统服务器的出口 IP，输入二次验证码，保存弹出的 key_id 与 secret。
- 在 WHMCS “系统设置 → 服务器 → 添加”，模块选 CDNCA，填接口地址、key_id 与 secret，点“测试连接”。
主要设置
| 设置 | 说明 |
|---|---|
| IP 白名单 | 财务系统服务器的出口 IP，至少 1 条、最多 32 条，不支持 /0 |
| 过期时间 | 可选，留空表示永不过期 |
| 轮换 | 旧 secret 立即失效，需要在财务系统里换成新的 |
| 吊销 | 无法恢复，财务系统立即无法调用；已开通的客户与订阅不受影响 |
| 对接日志 | 每次调用记一行，保留 90 天 |
典型用法
- IDC 商把 CDN 作为一个产品上架到 WHMCS：客户付款后自动开通，到期未续自动停服。
- 既在平台当代理商、又有自建主控：WHMCS 里配两个“服务器”，分别用两把密钥。
限制与注意事项
- secret 只在创建时显示一次，遗失只能轮换。
- 撤销模块后对接接口全部拒绝调用，已开通的客户与订阅保留。
- 代理商接法需要平台管理员启用插件，并且该用户是有效的代理商。