Mô-đun WHMCS

Mô-đun WHMCS của Domain Name API là một plugin registrar kết nối trực tiếp cài đặt WHMCS của bạn với hạ tầng đăng ký tên miền và SSL của Domain Name API. Sau khi được cài đặt, WHMCS sẽ tự động thực hiện đăng ký tên miền, gia hạn, chuyển nhượng, quản lý DNS và cập nhật WHOIS thay mặt cho khách hàng của bạn — bạn hoặc đội ngũ của bạn không cần phải thực hiện bất kỳ thao tác thủ công nào. Việc lập hóa đơn, theo dõi thanh toán và thông báo ngày hết hạn cũng được quản lý tự động.

Mô-đun này hỗ trợ hơn 800 phần mở rộng tên miền, bao gồm tất cả các gTLD lớn như .com, .net, .org, cũng như các ccTLD khu vực như .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in và .ge. Nó tương thích với cPanel, Plesk, DirectAdmin, SolusVM và tất cả các bảng điều khiển hosting lớn.

💡 Bạn có thể xem mô-đun WHMCS như cây cầu nối giữa cửa hàng của bạn và đơn vị đăng ký tên miền. Nếu không có nó, mỗi đơn hàng sẽ cần được xử lý thủ công; sau khi cài đặt, toàn bộ hoạt động kinh doanh tên miền của bạn sẽ vận hành ở chế độ tự động. Đối với các đại lý nhắm đến thị trường Thổ Nhĩ Kỳ và khu vực MENA, việc hỗ trợ sẵn cho .tr và .com.tr cùng với ánh xạ trường Số định danh công dân Thổ Nhĩ Kỳ và Mã số thuế giúp việc tuân thủ pháp lý trở nên dễ dàng ngay từ đầu.

Việc cài đặt mất chưa đến 15 phút. Hướng dẫn cài đặt từng bước có tại địa chỉ domainnameapi.com/tr/bilgi-bankasi/moduller/whmcs-nasil-kurulur, còn video hướng dẫn có tại địa chỉ youtube.com/watch?v=LEw_iMnquSo.

Tải gói mô-đun mới nhất từ địa chỉ github.com/domainreseller.

Mở tệp ZIP và sao chép thư mục modules vào thư mục nơi WHMCS được cài đặt (ví dụ: /home/whmcs/public_html). Đừng xóa các tệp .gitignore, README.md và LICENSE.

Trong bảng quản trị WHMCS, hãy vào mục Cài đặt hệ thống > Domain Registrars. Nếu các tệp đã được đặt đúng thư mục, 'Domain Name API' sẽ xuất hiện trong danh sách.

Kích hoạt mô-đun và nhập tên người dùng cùng mật khẩu do Domain Name API cung cấp. Sau khi lưu, số dư của bạn sẽ hiển thị trên màn hình.

Nếu bạn bán tên miền .tr, hãy ánh xạ các trường Số định danh công dân Thổ Nhĩ Kỳ và Mã số thuế với các trường khách hàng tùy chỉnh trong WHMCS.

Nhập giá thủ công hoặc dùng công cụ Utilities > Registrar TLD Sync > DomainNameApi để nhập hàng loạt giá trực tiếp kèm theo thiết lập biên lợi nhuận.

Từ mục Cài đặt hệ thống > Cài đặt chung > Domains, hãy kích hoạt đăng ký tên miền, quyền chuyển nhượng, đơn gia hạn, tự động gia hạn khi thanh toán, đồng bộ tên miền và hỗ trợ IDN.

Trong phần Cài đặt tự động hóa, hãy kích hoạt các tùy chọn Domain Sync và Sync Next Due Date.

Quan trọng: Nếu bạn đang cập nhật, hãy sao lưu các tệp mô-đun hiện có trước khi ghi đè lên chúng.

💡 Lỗi cài đặt phổ biến nhất là tải tệp mô-đun lên sai thư mục — trong trường hợp đó WHMCS sẽ âm thầm thất bại. Sau khi cài đặt, hãy xác minh rằng số dư Domain Name API của bạn hiển thị trên màn hình cấu hình registrar. Để khắc phục sự cố, hãy sử dụng mục Utilities > Logs > Module Log với debug logging được bật. Trong môi trường production, hãy giữ debug logging ở trạng thái tắt.

Những yêu cầu cần thiết cho mô-đun WHMCS của Domain Name API:

WHMCS 7.8 trở lên (khuyến nghị phiên bản ổn định mới nhất)

PHP 7.4 trở lên (khuyến nghị PHP 8.1)

Máy chủ phải bật tiện ích mở rộng PHP SOAPClient

Các trường khách hàng tùy chỉnh cho Số định danh công dân Thổ Nhĩ Kỳ, Mã số thuế và Cơ quan thuế — là bắt buộc đối với đăng ký tên miền .tr

💡 Luôn sử dụng phiên bản WHMCS ổn định mới nhất; các bản vá bảo mật được phát hành thường xuyên. Nếu bạn phục vụ thị trường Thổ Nhĩ Kỳ, các trường Số định danh công dân Thổ Nhĩ Kỳ và Mã số thuế là yêu cầu pháp lý đối với đăng ký .tr. Hãy định nghĩa các trường này ngay trong giai đoạn cài đặt trước khi bạn có khách hàng thực tế.

WHMCS là nền tảng tự động hóa hosting được sử dụng rộng rãi nhất trên toàn thế giới nhờ mô hình cấp phép hợp lý, hệ sinh thái tích hợp toàn diện và hạ tầng tự động hóa trưởng thành. Một cài đặt WHMCS duy nhất có thể quản lý hồ sơ khách hàng, lập hóa đơn, kích hoạt dịch vụ tự động, theo dõi thanh toán và các luồng tạm ngưng/chấm dứt. Hệ thống thông báo qua email và SMS giúp cập nhật cho khách hàng ở mọi bước mà không cần can thiệp thủ công.

💡 Giấy phép trọn đời được cung cấp đến năm 2017 đã khiến cơ sở người dùng WHMCS trở nên rất ổn định. Đối với các doanh nghiệp mới đang đánh giá vào giai đoạn 2025–2026, hãy so sánh chi phí hàng tháng của WHMCS với WiseCP (cạnh tranh tại thị trường Thổ Nhĩ Kỳ và MENA) và Blesta (thanh toán một lần, quyền sở hữu dữ liệu mạnh). Domain Name API hỗ trợ cả ba nền tảng này bằng các mô-đun chuyên biệt.

Các lựa chọn thay thế WHMCS hoàn toàn tương thích với Domain Name API và đang được phát triển tích cực:

Blesta — thân thiện với nhà phát triển, giấy phép trả một lần, khả năng di chuyển dữ liệu mạnh

HostBill — cấp độ doanh nghiệp, hơn 150 tích hợp, lý tưởng cho các đại lý có khối lượng lớn

WiseCP — giao diện hiện đại, đang phát triển nhanh tại Thổ Nhĩ Kỳ và khu vực MENA

ClientExec — bộ tính năng đơn giản hơn, lựa chọn khởi đầu tiết kiệm chi phí

HostFact — phổ biến ở Hà Lan và Tây Âu

Các nền tảng cũ như AWBS, WHMAutoPilot, Lpanel, Modernbill và PerlBill hiện không còn được phát triển tích cực nữa và không được khuyến nghị cho các cài đặt mới.

💡 Việc chọn nền tảng nên được định hình theo thị trường mục tiêu của bạn. WHMCS là lựa chọn an toàn nhất cho các hoạt động toàn cầu. WiseCP là lựa chọn thay thế đang nhanh chóng nổi bật trong số các đại lý tại thị trường Thổ Nhĩ Kỳ và được hỗ trợ đầy đủ bằng mô-đun WiseCP chuyên biệt của Domain Name API. HostBill được khuyến nghị cho các đại lý doanh nghiệp cần hơn 150 tích hợp, trong khi Blesta phù hợp với các nhà vận hành muốn có quyền sở hữu dữ liệu đầy đủ và chi phí một lần.

WHMCS là một phần mềm cấp phép có phí, được chia theo số lượng khách hàng đang hoạt động: có bốn gói là Starter, Plus, Business và Direct. Việc tính phí được thực hiện theo tháng. Có thời gian dùng thử miễn phí để đánh giá nền tảng trước khi cam kết.

Domain Name API cung cấp các gói cài đặt WHMCS Starter và Mega với theme đã được cài sẵn và cấu hình mô-đun đã hoàn tất. Những gói này giúp giảm đáng kể thời gian và chi phí để triển khai một doanh nghiệp đại lý tên miền mới.

💡 Nếu bạn mới bắt đầu, gói WHMCS Starter là đủ cho tối đa 250 khách hàng đang hoạt động. Các gói sẵn có của Domain Name API loại bỏ 2–3 ngày thời gian thiết lập vốn thường dành cho việc cài theme và kết nối mô-đun; bạn có thể mở một gian hàng mang thương hiệu riêng chỉ trong vài giờ.

Có. Bạn có thể chuyển đổi giữa các tầng giấy phép WHMCS và các gói cài đặt WHMCS của Domain Name API bất cứ lúc nào. Thay đổi sẽ có hiệu lực ở kỳ hóa đơn tiếp theo. Mô-đun WHMCS của Domain Name API tương thích với tất cả các tầng giấy phép WHMCS, bao gồm Starter, Plus, Business và Direct.

💡 Hãy bắt đầu với WHMCS Starter. Khi cơ sở khách hàng của bạn vượt quá 250, hãy nâng cấp lên Plus hoặc Business để có thể ghi nhận khách hàng và dịch vụ không giới hạn. Các gói Starter và Mega của Domain Name API cung cấp môi trường bán hàng sẵn sàng cho những ai không muốn cấu hình mọi thứ từ đầu.

Mô-đun WHMCS của Domain Name API hỗ trợ hơn 800 phần mở rộng tên miền, bao gồm tất cả các gTLD lớn như .com, .net, .org, .info, .biz cùng với .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in, .ge và nhiều ccTLD khác nữa. Đối với các tổ chức đăng ký có cung cấp giá premium, việc đăng ký premium domain cũng được hỗ trợ.

💡 Các đại lý nhắm tới những thị trường địa lý cụ thể nên sắp xếp bảng giá TLD theo hướng ưu tiên các phần mở rộng địa phương. Các đại lý tại Thổ Nhĩ Kỳ nên làm nổi bật .tr và .com.tr — những phần mở rộng này tạo ra tín hiệu tin cậy mạnh mẽ với khách hàng địa phương và giúp tăng tỷ lệ chuyển đổi. Việc định vị TLD theo hướng bản địa hóa là một trong những chiến thuật mang lại ROI cao nhất trong các chiến dịch SEO nhắm mục tiêu GEO.

WHMCS mặc định kiểm tra ngày hết hạn tên miền thông qua cron job tự động chạy mỗi 5 phút. Khi ngày hết hạn của một domain đến gần, WHMCS sẽ tự động tạo hóa đơn gia hạn cho khách hàng, gửi thông báo hết hạn theo các khoảng thời gian có thể cấu hình (thường là trước 60, 30, 14 và 7 ngày) và tự động thực hiện gia hạn nếu tài khoản khách hàng có đủ số dư hoặc có phương thức thanh toán hợp lệ.

Để quy trình này hoạt động chính xác, Domain Sync cần được bật trong mục Cài đặt hệ thống > Cài đặt chung > Domains; nhờ đó WHMCS sẽ luôn nhận được ngày hết hạn cập nhật từ Domain Name API.

💡 Chuỗi 4 email ở mốc 60/30/14/7 ngày có thể giúp giảm tỷ lệ mất domain tới 60% so với chỉ một lời nhắc duy nhất. Hãy bật thêm tùy chọn Sync Next Due Date trong mục Cài đặt tự động hóa — sự không khớp ngày tháng giữa WHMCS và đơn vị đăng ký là một trong những nguyên nhân phổ biến nhất dẫn đến việc mất tên miền ngoài ý muốn.

Giá tên miền có thể được nhập thủ công cho từng TLD hoặc được nhập tự động thông qua công cụ Registrar TLD Sync. Để đồng bộ tự động: vào mục Utilities > Registrar TLD Sync, chọn DomainNameApi và chờ việc so sánh hoàn tất. Màn hình kết quả sẽ hiển thị biên lợi nhuận/thua lỗ cho từng phần mở rộng và cho phép bạn chuyển giá hàng loạt.

Bạn cũng có thể đặt Domain Name API làm Lookup Provider (Cài đặt hệ thống > Giá tên miền > Lookup Provider > Thay đổi > DomainNameApi). Nhờ đó, việc truy vấn tình trạng khả dụng theo thời gian thực sẽ được thực hiện qua hạ tầng của Domain Name API thay vì các máy chủ WHOIS chung.

💡 Tự động đồng bộ giá là một trong những tính năng ít được sử dụng nhất của WHMCS. Việc chạy TLD Sync hàng tháng giúp đảm bảo giá bán lẻ của bạn vẫn cao hơn chi phí ngay cả sau khi nhà cung cấp thay đổi giá. Quy tắc biên lợi nhuận cố định (ví dụ: chi phí + 25%) sẽ bảo vệ khả năng sinh lời trên hơn 800 phần mở rộng mà không cần rà soát thủ công.

WHMCS cung cấp một hệ thống log mô-đun tích hợp để chẩn đoán các vấn đề tích hợp. Hãy vào mục Utilities > Logs > Module Log. Nếu bạn thấy nút Enable Debug Logging, hãy nhấp để kích hoạt. Sau khi được kích hoạt, tất cả các yêu cầu và phản hồi giữa WHMCS và Domain Name API sẽ được ghi lại. Bạn có thể nhấp vào ngày của bất kỳ bản ghi log nào để xem chi tiết đầy đủ của yêu cầu, phản hồi và phản hồi đã được lọc.

Các vấn đề thường gặp:

Tải tệp mô-đun lên sai thư mục — WHMCS không nhận diện mô-đun một cách rõ ràng

Thông tin xác thực API sai — số dư không hiển thị sau khi lưu

Domain sync bị tắt — ngày hết hạn trở nên cũ và việc gia hạn âm thầm thất bại

💡 Trước khi liên hệ đội ngũ hỗ trợ, hãy lấy bản ghi Module Log của thao tác bị lỗi. Phần phản hồi đã lọc sẽ hiển thị chính xác lỗi mà Domain Name API trả về; trong phần lớn trường hợp, vấn đề sẽ tự trở nên rõ ràng. Việc chuẩn bị sẵn log này sẽ rút ngắn đáng kể thời gian xử lý. Để tránh ảnh hưởng hiệu năng, hãy giữ debug logging ở trạng thái tắt trong môi trường production.

Việc chuyển nhượng domain được xử lý tự động thông qua mô-đun registrar. Khi một khách hàng bắt đầu chuyển vào, WHMCS sẽ gửi yêu cầu chuyển nhượng đến Domain Name API bằng mã ủy quyền EPP mà khách hàng cung cấp. Trạng thái chuyển nhượng và ngày bắt đầu/kết thúc thực tế có thể được xem theo thời gian thực trong bảng quản trị. Quản trị viên cũng có thể tạo yêu cầu hủy chuyển nhượng trực tiếp từ bảng quản lý domain.

💡 Việc chuyển nhượng thất bại thường xảy ra nhất do mã EPP đã hết hạn, khóa chuyển nhượng ở phía đơn vị đăng ký hiện tại hoặc thời hạn khóa ICANN 60 ngày kể từ lần đăng ký gần nhất. Hãy đặc biệt chú ý khi chuyển nhượng domain .tr: thông tin Số định danh công dân Thổ Nhĩ Kỳ và Mã số thuế trong tài khoản khách hàng bên nhận phải khớp với hồ sơ tại đơn vị đăng ký; nếu không khớp, điều đó có thể dẫn đến việc từ chối chuyển nhượng một cách âm thầm, rất khó chẩn đoán nếu không kiểm tra log.