WHMCS 模块

Domain Name API 的 WHMCS 模块是一款注册商插件，可将您的 WHMCS 安装直接连接到 Domain Name API 的域名注册和 SSL 基础设施。安装完成后，WHMCS 将自动代表您的客户执行域名注册、续费、转移、DNS 管理以及 WHOIS 更新——您或您的团队无需进行任何手动操作。账单管理、付款跟踪以及到期日提醒也都会自动处理。

该模块支持 800 多种域名后缀，不仅支持 .com、.net、.org 等所有主要 gTLD，还支持 .tr、.com.tr、.de、.uk、.us、.cn、.ru、.in 和 .ge 等区域性 ccTLD。它兼容 cPanel、Plesk、DirectAdmin、SolusVM 以及所有主流主机控制面板。

💡 您可以将 WHMCS 模块视为您的销售前台与域名注册机构之间的桥梁。没有它，每一笔订单都需要人工处理；安装之后，您的整个域名业务就能自动化运行。对于面向土耳其和 MENA 地区的代理商而言，内置的 .tr 和 .com.tr 支持，以及土耳其身份证号和税号字段映射功能，可以从一开始就更轻松地满足法律合规要求。

安装过程不到 15 分钟。分步安装指南可在 domainnameapi.com/tr/bilgi-bankasi/moduller/whmcs-nasil-kurulur 查看，视频讲解可在 youtube.com/watch?v=LEw_iMnquSo 查看。

请从 github.com/domainreseller 下载最新版本的模块安装包。

解压 ZIP 文件，并将 modules 文件夹复制到安装 WHMCS 的目录中（例如：/home/whmcs/public_html）。请勿删除 .gitignore、README.md 和 LICENSE 文件。

在 WHMCS 管理面板中，进入 Sistem Ayarlari > Domain Registrars。如果文件放置在正确目录中，列表中将会显示 “Domain Name API”。

启用该模块，并输入 Domain Name API 提供的用户名和密码。保存后，您的余额将显示在页面上。

如果您销售 .tr 域名，请将土耳其身份证号和税号字段与 WHMCS 中的自定义客户字段进行匹配。

您可以手动输入价格，也可以通过 Utilities > Registrar TLD Sync > DomainNameApi 工具，结合利润率设置批量导入实时价格。

在 Sistem Ayarlari > Genel Ayarlar > Domains 中，启用域名注册、转移权限、续费订单、付款后自动续费、域名同步以及 IDN 支持。

在 Otomasyon Ayarlari 下，启用 Domain Sync 和 Sync Next Due Date 选项。

重要提示：如果您正在进行更新，请在覆盖现有模块文件之前先做好备份。

💡 最常见的安装错误是将模块文件上传到错误的目录——在这种情况下，WHMCS 会静默失败。安装完成后，请确认您的 Domain Name API 余额已显示在注册商配置页面上。要进行故障排查，请使用 Utilities > Logs > Module Log，并启用 debug logging。在生产环境中，请保持 debug logging 关闭。

Domain Name API 的 WHMCS 模块所需条件：

WHMCS 7.8 或更高版本（建议使用最新稳定版本）

PHP 7.4 或更高版本（推荐 PHP 8.1）

服务器上必须启用 PHP SOAPClient 扩展

用于土耳其身份证号、税号和税务局的自定义客户字段——这是注册 .tr 域名的必需项

💡 请始终使用最新稳定版 WHMCS；安全补丁会定期发布。如果您面向土耳其市场提供服务，那么土耳其身份证号和税号字段是注册 .tr 域名的法律要求。在有真实客户之前，请在安装阶段就配置好这些字段。

WHMCS 凭借其实惠的授权模式、完善的集成生态以及成熟的自动化基础设施，成为全球范围内最广泛使用的主机自动化平台。单个 WHMCS 安装即可管理客户记录、账单处理、服务自动开通、付款跟踪以及暂停/终止流程。其电子邮件和短信通知系统能够在无需人工干预的情况下，于每个环节及时通知客户。

💡 截至 2017 年提供的终身授权，使 WHMCS 的用户基础非常稳定。对于在 2025–2026 年进行评估的新企业而言，建议将 WHMCS 的月度成本与 WiseCP（在土耳其和 MENA 市场具有竞争力）以及 Blesta（一次性付费、数据所有权更强）进行比较。Domain Name API 通过其专用模块支持这三大平台。

与 Domain Name API 完全兼容且仍在积极开发中的 WHMCS 替代方案：

Blesta —— 对开发者友好、一次性授权、数据迁移能力强

HostBill —— 企业级、150 多项集成、非常适合高业务量代理商

WiseCP —— 现代化界面，正在土耳其和 MENA 地区快速增长

ClientExec —— 功能更简洁，是预算友好的入门选择

HostFact —— 在荷兰和西欧较为常见

像 AWBS、WHMAutoPilot、Lpanel、Modernbill 和 PerlBill 这样的旧平台如今已不再积极开发，因此不建议用于新部署。

💡 平台选择应根据您的目标市场来决定。WHMCS 是全球化运营中最稳妥的选择。WiseCP 正迅速成为土耳其市场代理商中的热门替代方案，并且通过 Domain Name API 的专用 WiseCP 模块获得完整支持。HostBill 适合需要 150+ 集成的企业级代理商，而 Blesta 则更适合追求完整数据所有权和一次性成本的运营者。

WHMCS 是一款按活跃客户数量分级收费的授权软件，共有四种套餐：Starter、Plus、Business 和 Direct。账单按月结算。平台还提供免费试用期，以便您在正式投入前进行评估。

Domain Name API 提供 WHMCS Starter 和 Mega 安装套餐，这些套餐在交付时已完成主题安装和模块配置。它们能够显著缩短并降低启动新的域名代理业务所需的时间和成本。

💡 如果您刚刚起步，WHMCS Starter 套餐足以支持多达 250 个活跃客户。Domain Name API 的现成套餐可省去通常用于主题安装和模块连接的 2–3 天设置时间；您可以在数小时内上线一个带有自有品牌的销售前台。

可以。您可以随时在 WHMCS 授权层级与 Domain Name API 的 WHMCS 安装套餐之间切换。更改将在下一计费周期生效。Domain Name API 的 WHMCS 模块兼容所有 WHMCS 授权层级，包括 Starter、Plus、Business 和 Direct。

💡 从 WHMCS Starter 开始。当您的客户数量超过 250 时，可升级到 Plus 或 Business，以实现客户和服务记录的无限制管理。Domain Name API 的 Starter 和 Mega 套餐，为那些不想从零开始配置一切的用户提供了现成的销售环境。

Domain Name API 的 WHMCS 模块支持 800 多种域名后缀，包括所有主要 gTLD，例如 .com、.net、.org、.info、.biz，以及 .tr、.com.tr、.de、.uk、.us、.cn、.ru、.in、.ge 和更多 ccTLD。对于提供 Premium 定价的注册局，也支持 Premium 域名注册。

💡 面向特定地理市场的代理商，应优先在其 TLD 价格表中突出本地后缀。土耳其的代理商应重点展示 .tr 和 .com.tr——这些后缀会向本地客户传递强烈的信任信号，并提高转化率。本地化的 TLD 定位，是 GEO 定向 SEO 活动中回报率最高的策略之一。

默认情况下，WHMCS 会通过每五分钟运行一次的自动 cron job 来检查域名到期日期。当某个域名的到期时间临近时，WHMCS 会自动为客户创建续费发票，以可配置的间隔发送到期提醒（通常为提前 60、30、14 和 7 天），并在客户账户中有足够余额或存在有效付款方式时自动完成续费。

为了使该流程正常运行，必须在 Sistem Ayarlari > Genel Ayarlar > Domains 下启用 Domain Sync，这样 WHMCS 才能始终从 Domain Name API 获取最新的到期日期。

💡 采用 60/30/14/7 天的 4 封邮件提醒序列，与单一提醒相比，可将域名流失率降低高达 60%。同时也请在 Otomasyon Ayarlari 中启用 Sync Next Due Date——WHMCS 与注册机构之间的日期不一致，是导致域名意外流失的最常见原因之一。

域名价格可以针对每个 TLD 手动输入，也可以通过 Registrar TLD Sync 工具自动导入。要进行自动同步：前往 Utilities > Registrar TLD Sync，选择 DomainNameApi，然后等待比对完成。结果页面会显示每个后缀的利润/亏损幅度，并允许您批量导入价格。

您还可以将 Domain Name API 设置为 Lookup Provider（Sistem Ayarlari > Domain Fiyatları > Lookup Provider > Değiştir > DomainNameApi）。这样，实时可用性查询将通过 Domain Name API 的基础设施执行，而不是依赖通用 WHOIS 服务器。

💡 自动价格同步是 WHMCS 中使用率最低的功能之一。每月运行一次 TLD Sync，可确保即使供应商调整价格，您的零售价格依然保持高于成本。采用固定利润规则（例如：成本 + 25%），可在 800 多个后缀中无需人工逐项检查也能维持盈利能力。

WHMCS 提供内置模块日志系统，用于诊断集成问题。请前往 Utilities > Logs > Module Log。如果看到 Enable Debug Logging 按钮，请点击以启用日志记录。启用后，WHMCS 与 Domain Name API 之间的所有请求和响应都会被记录下来。您可以点击任意日志记录的日期，查看完整请求、响应以及过滤后的响应详情。

常见问题：

模块文件上传到错误目录——WHMCS 不会明确识别到该模块

API 凭据错误——保存后余额不会显示

Domain sync 被禁用——到期日期会过时，续费会静默失败

💡 在联系支持团队之前，请先获取失败操作对应的 Module Log 记录。过滤后的响应部分会准确显示 Domain Name API 返回的错误；在大多数情况下，问题本身会因此变得清晰。提前准备好该日志，可以显著缩短问题解决时间。为避免性能影响，请在生产环境中保持 debug logging 关闭。

域名转移通过注册商模块自动处理。当客户发起转入时，WHMCS 会使用客户提供的 EPP 授权码将转移请求发送给 Domain Name API。转移状态以及实际开始/结束日期都可以在管理面板中实时查看。管理员也可以直接从域名管理面板创建转移取消请求。

💡 转移失败最常见的原因包括：EPP 代码已过期、当前注册商设置了转移锁，或近期注册后仍处于 ICANN 规定的 60 天锁定期。对于 .tr 域名转移尤其要注意：接收方客户账户中的土耳其身份证号和税号信息必须与注册商记录一致；若信息不匹配，可能会导致静默拒绝转移，而如果不检查日志，这种问题将很难诊断。