WHMCS 모듈

Domain Name API WHMCS 모듈은 WHMCS 설치 환경을 Domain Name API의 도메인 등록 및 SSL 인프라에 직접 연결해 주는 registrar 플러그인입니다. 설치 후 WHMCS는 고객을 대신하여 도메인 등록, 갱신, 이전, DNS 관리 및 WHOIS 업데이트를 자동으로 수행하므로, 귀하나 귀하의 팀이 별도의 수동 작업을 할 필요가 없습니다. 청구, 결제 추적 및 만료일 알림도 자동으로 관리됩니다.

이 모듈은 .com, .net, .org 같은 주요 gTLD는 물론, .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in, .ge를 포함한 지역별 ccTLD까지 800개 이상의 도메인 확장자를 지원합니다. 또한 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 잔액이 registrar 설정 화면에 표시되는지 반드시 확인하세요. 문제 해결을 위해서는 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 설치만으로 고객 등록, 청구, 서비스 자동 활성화, 결제 추적 및 정지/종료 흐름까지 관리할 수 있습니다. 이메일 및 SMS 알림 시스템은 수동 개입 없이 고객에게 각 단계별로 안내를 제공합니다.

💡 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 모듈은 Starter, Plus, Business, Direct를 포함한 모든 WHMCS 라이선스 단계와 호환됩니다.

💡 WHMCS Starter로 시작하세요. 고객 수가 250명을 넘으면 고객 및 서비스 기록을 무제한으로 관리할 수 있도록 Plus 또는 Business로 업그레이드하세요. Domain Name API의 Starter 및 Mega 패키지는 처음부터 모두 설정하고 싶지 않은 분들을 위해 준비된 판매 환경을 제공합니다.

Domain Name API WHMCS 모듈은 .com, .net, .org, .info, .biz 같은 주요 gTLD는 물론, .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in, .ge 및 그 밖의 수많은 ccTLD를 포함하여 800개 이상의 도메인 확장자를 지원합니다. 프리미엄 가격 정책을 제공하는 등록기관에 대해서는 프리미엄 도메인 등록도 지원됩니다.

💡 특정 지역 시장을 겨냥하는 리셀러는 TLD 가격표를 현지 확장자 우선으로 구성해야 합니다. 터키의 리셀러는 .tr 및 .com.tr 확장자를 전면에 내세워야 합니다 — 이러한 확장자는 현지 고객에게 강한 신뢰 신호를 주고 전환율을 높입니다. 현지화된 TLD 포지셔닝은 GEO 타겟 SEO 캠페인에서 가장 높은 ROI를 제공하는 전술 중 하나입니다.

WHMCS는 기본적으로 5분마다 실행되는 자동 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). 이렇게 하면 일반 WHOIS 서버 대신 Domain Name API 인프라를 통해 실시간 가용성 조회가 이루어집니다.

💡 자동 가격 동기화는 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을 비활성화 상태로 유지하세요.

도메인 이전은 registrar 모듈을 통해 자동으로 처리됩니다. 고객이 수신 이전을 시작하면, WHMCS는 고객이 제공한 EPP 인증 코드를 사용하여 Domain Name API로 이전 요청을 전달합니다. 이전 상태와 실제 시작/종료 날짜는 관리자 패널에서 실시간으로 확인할 수 있습니다. 관리자는 도메인 관리 패널에서 직접 이전 취소 요청도 생성할 수 있습니다.

💡 이전 실패는 가장 흔하게 만료된 EPP 코드, 현재 등록기관 측의 이전 잠금, 또는 최근 등록 이후 적용되는 60일 ICANN 잠금 기간 때문에 발생합니다. 특히 .tr 도메인 이전 시에는 주의가 필요합니다. 수신 측 고객 계정의 터키 공화국 신분번호 및 세금번호 정보는 등록기관의 기록과 일치해야 하며, 불일치가 있으면 로그를 확인하기 전에는 원인 파악이 어려운 조용한 이전 거부로 이어질 수 있습니다.