API 및 통합

WHMCS로 클라우드 서버와 결제 자동화를 구축하는 방법

  • 읽는 데 13분 소요
  • Hostragons 팀
WHMCS로 클라우드 서버와 결제 자동화를 구축하는 방법

WHMCS 모듈은 결제 수납, 갱신 요금 업데이트, 고객 작업 관리, 클라우드 서버 자원 제어처럼 반복되기 쉬운 업무를 WHMCS 한 곳에서 모아 처리하게 해줍니다. Hostragons 카탈로그에는 결제와 운영 중심의 5개 모듈, 그리고 OVHcloud, AWS Lightsail, Contabo, Microsoft Azure, Google Cloud 인프라를 위한 5개의 독립 통합이 준비되어 있습니다. 이 가이드에서는 10개 모듈이 각각 무엇을 해주는지, 어디까지가 범위인지, 어떤 상황에 맞는지 한눈에 비교해 드립니다.

모듈을 고를 때는 기능 목록만 보고 결정하면 안 됩니다. 사용하는 WHMCS 버전, 제공업체 계정, API 권한, 운영체제, 청구 방식, 그리고 실제 운영 전에 어떤 테스트를 할지까지 함께 살펴봐야 합니다. 여기 소개하는 통합은 WHMCS 라이선스나 클라우드 제공업체 계정, 또는 결제사 계정을 대신해 주지 않습니다. 제공업체의 사용료, 네트워크 비용, 라이선스 비용, 세금은 별도로 부과됩니다.

WHMCS 모듈은 어떤 작업을 쉽게 만들어 주나?

WHMCS 핵심은 고객, 주문, 청구서, 서비스의 생명주기를 관리합니다. 모듈은 여기에 특정 업무 흐름을 연결해 줍니다. 예를 들어 결제 게이트웨이 모듈은 청구서를 외부 결제 페이지로 보내고 검증된 결과를 WHMCS에 다시 전달할 수 있습니다. 운영용 모듈은 대량의 잔액이나 요금 업데이트를 한 번에 처리할 수 있고, 서버 모듈은 주문에 연결된 가상 머신을 생성한 뒤 고객 영역에서 허용된 관리 기능을 제공할 수 있습니다.

이 차이를 이해하는 것이 중요합니다. 모든 모듈이 모든 일을 하는 것은 아닙니다. 예를 들어 Paddle과 Mollie 모듈은 결제 흐름에 집중하고, 고객 잔액 관리자 모듈은 내부 크레딧 작업에 집중하며, 클라우드 통합은 각 제공업체의 자원에만 초점을 맞춥니다. 필요 목록을 먼저 “결제”, “고객 운영”, “서버 자동화”로 나누어 보면 더 맞는 제품을 빠르게 찾을 수 있습니다.

10개 WHMCS 모듈 빠른 비교

10개 WHMCS 모듈 빠른 비교
모듈주요 용도필요한 외부 계정출시 당시 가격
자동 요금 업데이트반복 서비스, 애드온, 도메인 요금 업데이트불필요일회성 99 USD
Paddle 결제 게이트웨이단건 및 구독 결제Paddle Billing일회성 99 USD
Mollie 결제 게이트웨이Mollie에서 지원하는 결제 수단 사용Mollie일회성 99 USD
고객 간 도메인 이전WHMCS 고객 간 도메인 양도불필요일회성 99 USD
고객 잔액 관리자대량 고객 크레딧 관리불필요일회성 99 USD
OVHcloud VPS & DedicatedOVHcloud 서버 생명주기 연결OVHcloud일회성 99 USD
AWS LightsailLightsail 서버 프로비저닝 및 관리AWS일회성 99 USD
Contabo CloudContabo VPS 및 VDS 관리콘타보일회성 99 USD
Microsoft Azure VMAzure 가상 머신 생명주기Microsoft Azure일회성 99 USD
Google Cloud Compute EngineLinux 기반 Compute Engine 자원Google Cloud일회성 99 USD

위 가격은 이 글이 공개된 시점의 최신 목록 가격이며, 영구적인 가격 보장은 아닙니다. 구매 전에는 제품 페이지에 표시된 최신 범위, 라이선스, 가격 정보를 우선 확인해야 합니다.

결제 및 운영 자동화 모듈

자동 요금 업데이트

반복 요금이 시간이 지나며 바뀌면, 이미 생성된 활성 또는 일시정지 서비스는 예전 갱신 금액이 유지될 수 있습니다. 자동 요금 업데이트 모듈은 서비스, 애드온, 도메인 갱신 금액을 WHMCS의 현재 요금 체계에 맞춰 다시 계산하는 데 사용됩니다. 한 번만 실행할 수도 있고, 예약된 cron 흐름에 연결할 수도 있습니다.

특히 환율이나 요금표가 바뀐 뒤에 많은 항목을 하나씩 손보지 않으려는 사업자에게 잘 맞습니다. 실제 적용 예시는 WHMCS 자동 가격 업데이트 모듈 가이드를 참고해 보세요. 다만 대량 변경 전에는 반드시 데이터베이스 백업을 먼저 만들고, 일부 고객 그룹에서 먼저 시험해 본 뒤, 생성될 청구서까지 확인하는 것이 좋습니다.

Paddle 결제 게이트웨이

Paddle Billing V3 연동은 WHMCS 청구서에 대해 Paddle Checkout을 통해 단건 결제와 구독 결제를 시작합니다. HMAC-SHA256 서명이 포함된 webhook 알림을 검증하고, 반복 결제 알림은 구독 ID를 기준으로 해당 청구서와 연결하는 데 도움을 줍니다. 즉, 브라우저 리디렉션 결과만 믿는 대신 서버에서 전달된 서명된 알림을 처리하는 방식입니다.

이 모듈은 Paddle 계정 개설이나 판매 적격성 승인까지 대신해 주지는 않습니다. Paddle 계정, 제품 정의, 통화, webhook 설정은 직접 준비해야 합니다. 설치 세부사항은 Paddle WHMCS 결제 내용을 확인할 수 있으며, Checkout으로 전환하기 전에는 성공, 실패, 취소, 반복 결제 시나리오를 테스트 환경에서 각각 확인해 보는 것이 좋습니다.

Mollie 결제 게이트웨이

Mollie 모듈은 Mollie 계정에서 활성화된 iDEAL, 카드, PayPal, Apple Pay, Bancontact, SOFORT, 은행 송금 같은 결제 수단을 WHMCS 청구서와 연결합니다. webhook 콜백은 결제 상태를 WHMCS로 전달하며, iDEAL 흐름에서 은행 선택이나 은행 송금 시 만기 관리처럼 결제 수단별 기능도 제공합니다.

사용 가능한 결제 수단은 국가, 통화, Mollie 계정, 그리고 계정에서 실제로 켜 둔 수단에 따라 달라집니다. 따라서 “15개 방법”이라고 해서 모든 계정에서 전부 바로 열린다는 뜻은 아닙니다. WHMCS Mollie 모듈 가이드와 함께 Mollie 패널의 권한과 webhook 엔드포인트를 실제 오픈 전에 꼭 검증하세요.

고객 간 도메인 이전

이 모듈은 한 WHMCS 고객 계정에 있는 도메인을 다른 WHMCS 고객에게 넘기는 데 필요한 통제된 절차를 구성합니다. 요청은 고객 영역에서 시작되며, 수신자 이메일로 발송된 일회용 링크로 승인됩니다. token 검증, IP 기록, 설정 가능한 유효 기간, 상태 추적 덕분에 수동 이전보다 훨씬 더 추적 가능한 흐름이 됩니다.

여기서 말하는 작업은 레지스트라 간 일반 도메인 이전과는 다릅니다. 같은 WHMCS 설치 안에서 고객 소유권만 바꾸는 것입니다. 레지스트라의 transfer lock, EPP code, 외부 계정 이동과 관련된 절차는 별도로 해당 레지스트라 규정을 따라야 합니다.

고객 잔액 관리자

고객 잔액 관리자는 WHMCS 관리자 영역에서 고객 크레딧을 필터링하고 대량 작업을 하고 싶을 때 유용합니다. 고객은 이름, 회사, 이메일, 통화, 잔액 상태로 찾을 수 있고, 선택한 계정에 크레딧을 한꺼번에 추가하거나 잔액을 0으로 만들 수도 있습니다. 모든 작업은 관리자 메모와 활동 기록으로 남습니다.

크레딧 잔액은 재무 기록에 바로 영향을 주므로, 권한이 있는 관리자 역할을 제한하고, 작업 전에 선택된 고객 목록을 다시 확인하며, 큰 규모의 변경은 백업 후에 적용하는 것이 안전합니다.

클라우드 서버 자동화 모듈

클라우드 모듈은 WHMCS의 주문/서비스 기록과 제공업체 API 사이를 이어 주는 다리 역할을 합니다. 기본 서비스 생명주기가 어떻게 돌아가는지는 WHMCS로 자동 호스팅 계정 생성 가이드에서 확인할 수 있습니다. 고객에게 열리는 관리 범위는 제공업체 API의 동작 방식, 제품 설정, 그리고 사업자가 부여한 권한에 따라 달라집니다. 이 모듈들은 독립적인 통합이며, 해당 클라우드 제공업체가 직접 만든 제품이 아니고 파트너십을 의미하지도 않습니다.

OVHcloud VPS & Dedicated

OVHcloud 연동은 VPS와 Dedicated 서비스를 WHMCS에 연결합니다. VPS 쪽에서는 생명주기 관리와 재설치를 고객 영역의 허용된 셀프 서비스 기능으로 처리할 수 있습니다. Dedicated 범위는 기존 서버 풀의 할당과 통제된 운영에 초점이 있으며, 새 물리 서버 구매를 자동화한다고 보아서는 안 됩니다. 일시정지, 종료, 데이터 손실을 일으킬 수 있는 작업은 운영자가 직접 확인해야 합니다.

AWS Lightsail

AWS Lightsail 모듈은 서버 프로비저닝, 전원 작업, 고정 IPv4, 방화벽, snapshot 흐름을 WHMCS 서비스와 연결합니다. Linux 및 Windows 자원의 접속 정보는 각 플랫폼 규칙에 따라 처리됩니다. 이 모듈은 일반적인 AWS 서비스 카탈로그가 아니라 Lightsail 자원에 집중한 연동입니다.

제공업체 식별자, 리전, 인스턴스 이름, 연결된 고정 IP 같은 정보는 서비스별로 따로 보관해야 합니다. API key는 배포 ZIP 안에 들어 있지 않으며, 설치 시 고객이 자신의 AWS 계정에서 필요한 권한으로 직접 구성해야 합니다.

Contabo Cloud

Contabo Cloud 모듈은 Contabo VPS와 VDS 자원에 대해 프로비저닝, 전원 작업, 재설치, 비밀번호 초기화, snapshot 관리를 연결합니다. 자원 ID가 WHMCS 서비스와 정확히 매칭되는지, 반복된 프로비저닝 요청이 같은 자원으로 정상 합쳐지는지, 삭제 작업에서 소유권이 제대로 검증되는지가 중요합니다.

Contabo 계정, API 접근, 그리고 제공업체 사용료는 별도로 필요합니다. 패키지 업그레이드, reverse DNS, 브라우저 내 VNC, 기타 모든 제공업체 기능이 모듈에 포함된다고 가정해서는 안 되며, 반드시 제품 페이지의 최신 기능 목록을 기준으로 판단해야 합니다.

Microsoft Azure VM

Microsoft Azure VM 모듈은 가상 머신 프로비저닝, 전원 작업, deallocate, 크기 변경, disk, snapshot, 방화벽 관리를 WHMCS와 연결합니다. resource group과 가상 머신 태그는 서비스 소유권을 확인하는 데 사용됩니다. 삭제 작업은 Azure의 비동기 처리 결과와 실제 제거 여부를 확인하기 전까지 완료된 것으로 보면 안 됩니다.

Azure disk나 snapshot 같은 유료 추가 자원의 카탈로그와 가격 설정은 운영자가 직접 준비해야 합니다. 고객에게 보이는 선택지는 설정하고 검증한 범위 안에서만 노출하는 것이 좋습니다.

Google Cloud Compute Engine

Google Cloud 모듈은 Linux 기반 Compute Engine 가상 머신의 프로비저닝, 전원 작업, 머신 타입 변경, 서비스 범위 네트워크 규칙 관리를 연결합니다. 자원 이름, 리전, 서비스 태그는 고유 식별값으로 저장되며, 생명주기 작업은 이 소유 정보가 확인된 뒤 실행됩니다.

현재 2.0.0 배포 범위는 Linux 워크로드입니다. Windows나 RDP 지원이 있는 것처럼 계획해서는 안 됩니다. Google Cloud 프로젝트, service account, quota, 네트워크, 청구 설정은 사업자가 준비해야 합니다.

어떤 WHMCS 모듈을 골라야 할까?

  • 기존 갱신 요금을 현재 카탈로그에 맞추고 싶다면 자동 요금 업데이트 모듈을 살펴보세요.
  • Paddle Checkout이나 Mollie로 결제를 받고 싶다면 해당 결제 게이트웨이 모듈을 선택하세요.
  • 같은 WHMCS 설치 안에서 고객 간 도메인 양도가 필요하다면 고객 간 Domain Transfer 모듈이 적합합니다.
  • 여러 고객 계정에 크레딧을 대량으로 처리해야 한다면 고객 잔액 관리자가 알맞습니다.
  • VPS, VDS, VM 서비스를 제공업체 API와 연결하고 싶다면, 현재 사용 중인 제공업체 전용 클라우드 서버 모듈만 고르세요.

자체 인프라에서 VPS 또는 VDS를 운영 중이라면 가상 서버 제품 구조와 WHMCS 자동화를 함께 설계하세요. 여러 제공업체를 함께 쓰는 사업자라면 각 통합을 별도의 API 계정, 별도의 테스트 상품, 가능하다면 권한이 낮은 별도 자격 증명으로 먼저 붙이는 것이 실수 범위를 줄이는 데 도움이 됩니다.

구매, 다운로드, 설치 흐름

구매, 다운로드, 설치 흐름
  1. 필요한 모듈과 현재 제품 페이지에 표시된 최신 범위를 확인합니다.
  2. WHMCS 고객 영역에서 주문을 완료하고 청구서를 결제합니다.
  3. WHMCS가 결제를 승인하면 공식 Auto Release 흐름이 해당 서비스를 Active 상태로 전환합니다.
  4. Active 서비스가 있는 계정에서만 구매한 제품에 대한 다운로드가 표시됩니다.
  5. ZIP 아카이브를 검증하고, 설치 문서를 읽은 뒤 테스트 WHMCS 환경에 업로드합니다.
  6. 설치 후 제공업체 또는 결제사 API 정보를 관련 설정 칸에 입력합니다.
  7. 성공, 실패, webhook, 시간 초과, 재시도, 종료 시나리오를 테스트한 뒤 운영 환경으로 전환합니다.

다운로드 파일은 일반 웹 디렉터리에서 직접 제공되지 않습니다. 제품과 서비스의 관계, 그리고 Active 상태의 서비스 여부가 고객 영역의 다운로드 권한을 결정합니다. 주문 화면에 표시된 최신 라이선스 조건과 설치 문서는 항상 이 요약보다 우선합니다.

라이선스, 제공업체 비용, 보안 범위

모듈 파일은 암호화되지 않은 source code 형태로 제공되지만, 이것이 곧 오픈 소스나 자유로운 재배포 권리를 뜻하는 것은 아닙니다. 사용, 수정, 재배포 권한은 구매한 라이선스 계약에 따르며, WHMCS 라이선스 관리 방식으로 제품과 설치별로 관리해야 합니다. 제공업체 API key, 실제 고객 데이터, live 자원 ID, Hostragons 내부 작업 데이터는 배포 패키지에 포함되지 않습니다.

설치 시에는 최소 권한 원칙을 적용해야 합니다. 가능하다면 모듈에 꼭 필요한 API 작업만 허용하는 별도 자격 증명을 주고, webhook secret은 주기적으로 바꾸며, WHMCS 관리자 역할은 제한하고, 로그에서는 민감 정보를 마스킹하세요. 운영 전에는 별도의 테스트 계정이나 저비용 테스트 자원을 사용하세요. 취소와 종료 테스트에서는 제공업체 API 응답뿐 아니라 자원이 실제로 제거되었는지, 유료 추가 자원이 남아 있지 않은지도 확인해야 합니다.

클라우드 서버 서비스를 판매할 때는 비용 계산에 가상 머신만 넣지 말고, disk, snapshot, IP, 트래픽, 라이선스, 지역별 가격 차이까지 포함해야 합니다. 모듈 자동화는 운영 시간을 줄여 주지만, 제공업체 quota, 계정 승인, 청구 책임까지 없애 주지는 않습니다.

설치 전에 확인할 짧은 체크리스트

  • WHMCS와 PHP 버전에 맞는 최신 제품 문서를 읽어 보세요.
  • 데이터베이스와 파일 백업을 먼저 만들어 두세요.
  • 외부 API 사용자에게 필요한 권한만 주세요.
  • 테스트 상품, 테스트 고객, 위험이 낮은 제공업체 자원을 준비하세요.
  • 반복되는 CreateAccount 호출에서 두 번째 자원이 생기지 않는지 확인하세요.
  • 일시정지, 재개, 종료, 재설치 결과를 제공업체 패널에서 직접 검증하세요.
  • 결제 모듈에서는 서명된 webhook, 잘못된 금액, 중복 알림, 환불 시나리오를 꼭 테스트하세요.
  • 실서비스 전환 후 첫 주문들과 오류 로그를 세심하게 모니터링하세요.

자주 묻는 질문

WHMCS 모듈이란 무엇인가요?

WHMCS 모듈은 결제, 고객 작업, 서버 관리 같은 특정 업무 흐름을 WHMCS에 추가하는 확장 기능입니다. WHMCS 라이선스나 외부 제공업체 계정을 대신하지는 않습니다.

어떤 클라우드 제공업체를 지원하나요?

OVHcloud VPS 및 Dedicated, AWS Lightsail, Contabo VPS/VDS, Microsoft Azure VM, 그리고 Linux 기반 Google Cloud Compute Engine용 별도 모듈이 있습니다.

클라우드 제공업체 계정과 사용료가 가격에 포함되나요?

아니요. 제공업체 계정, 구독료, 자원 사용료, 네트워크, 라이선스, 세금은 해당 제공업체가 별도로 청구합니다.

API 자격 증명이 모듈 패키지에 들어 있나요?

아니요. 모듈 ZIP에는 제공업체 자격 증명이나 실제 고객 데이터가 들어 있지 않습니다. 필요한 정보는 설치 후 적절한 WHMCS 설정 칸에 직접 입력해야 합니다.

구매한 모듈은 어떻게 내려받나요?

WHMCS가 결제를 승인하고 해당 서비스가 Active 상태가 되면, 고객 영역에서 구매한 제품의 다운로드 권한이 표시됩니다.

모듈 source code는 암호화되어 있나요?

모듈 파일은 암호화되지 않은 source code로 제공됩니다. 사용, 수정, 재배포 권한은 구매한 라이선스 조건에 따릅니다.

WHMCS 업무 흐름에 맞는 모듈을 선택하세요

결제, 고객 운영, 클라우드 서버 자동화 중 어떤 일이 필요한지 먼저 정리한 뒤, 각 모듈의 범위, 최신 가격, 라이선스 조건을 비교해 보세요. WHMCS 모듈 살펴보기 그리고 운영 전 테스트 계획을 설치 문서와 함께 미리 준비해 두면 훨씬 안전합니다.

이 기사를 공유하세요:

Hostragons 팀

호스팅, 서버, 도메인 이름에 대한 최신 가이드를 전문가 팀과 함께 확인하세요. 프로젝트에 맞는 최적의 솔루션을 찾아드리겠습니다.

문의하기