API と統合

WHMCSでクラウドサーバーと決済自動化を構築する方法

  • 15 読むのにかかる時間(分)
  • Hostragons チーム
WHMCSでクラウドサーバーと決済自動化を構築する方法

WHMCSモジュールは、決済の受け付け、更新料金の再計算、顧客オペレーションの管理、クラウドサーバー資源のWHMCS上での制御といった、日々の運用で発生しやすい作業をひとつの管理画面にまとめます。Hostragonsのカタログには、決済と運用に特化した5つのモジュールと、OVHcloud、AWS Lightsail、Contabo、Microsoft Azure、Google Cloud向けの5つの独立した連携が用意されています。このガイドでは、10個のモジュールがそれぞれ何を得意とし、どこまで対応し、どんな導入シーンに向いているのかを、日本の運用感覚に合わせて比較します。

モジュール選定では、機能一覧だけを見ても十分ではありません。使用中のWHMCSバージョン、プロバイダーアカウント、API権限、OS、課金モデル、本番投入前のテスト計画まで含めて判断する必要があります。ここで紹介する連携は、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種類使える」と書いてあっても、すべてのアカウントで同じ15種類がそのまま有効になるとは限りません。導入時は WHMCS Mollieモジュール の手順とあわせて、Mollieダッシュボードの権限とWebhookエンドポイントを本番公開前に確認しておくべきです。

顧客間ドメイン転送

このモジュールは、WHMCSのある顧客アカウントにあるドメインを、別のWHMCS顧客へ譲渡するための、統制された手順を提供します。申請は顧客エリアから始まり、受け取り側のメールアドレスに送られるワンタイムリンクで承認します。トークン検証、IP記録、設定可能な有効期限、ステータス追跡により、手動運用よりも追跡しやすい流れを実現します。

ここでの処理は、レジストラ間の一般的なドメイン移管とは異なります。同一のWHMCSインスタンス内で、顧客の所有権を切り替えるものです。レジストラの転送ロック、EPPコード、外部アカウントへの移行などについては、別途レジストラ側のルールが適用されます。

顧客残高マネージャー

顧客残高マネージャーは、WHMCS管理画面で顧客クレジットを絞り込み、まとめて処理したい場合に役立ちます。顧客は、名前、会社名、メールアドレス、通貨、残高の状態で検索でき、選択したアカウントへ一括でクレジット追加したり、残高をゼロに戻したりできます。処理結果は管理者メモとアクティビティログで追跡可能です。

クレジット残高は会計上の数字に直接影響するため、管理者権限は必要最小限に絞り、実行前に対象顧客リストを必ず確認してください。大きな一括変更を行う際は、バックアップを取得したあとに適用するのが安全です。

クラウドサーバー自動化モジュール

クラウド系モジュールは、WHMCSの注文・サービス記録と、各プロバイダーのAPIをつなぐ橋渡し役です。サービスの基本的なライフサイクルの流れは、WHMCSでホスティングアカウントを自動作成 のガイドで確認できます。顧客に見せられる操作範囲は、プロバイダーAPIの仕様、製品設定、そして運用側が付与する権限によって変わります。これらは独立した連携であり、各クラウド事業者が公式に提供する製品ではなく、提携の表明でもありません。

OVHcloud VPS & Dedicated

OVHcloud連携は、VPSとDedicatedサービスをWHMCSに結びつけます。VPSでは、ライフサイクル管理や再インストールを顧客エリアのセルフサービス操作として提供できます。Dedicatedの範囲は、既存サーバー在庫の割り当てや、制御された運用作業が中心です。新規の物理サーバー購入まで自動化されると考えるのは避けてください。停止、終了、データ消失につながる操作には、運用者の確認が必要です。

AWS Lightsail

AWS Lightsailモジュールは、サーバーのプロビジョニング、電源操作、固定IPv4、ファイアウォール、スナップショットの流れをWHMCSサービスに結びつけます。LinuxとWindows資源のアクセス情報は、それぞれのプラットフォームルールに従って扱います。これはAWS全体を扱う総合モジュールではなく、Lightsail資源に特化した連携です。

プロバイダーID、リージョン、インスタンス名、関連する固定IPなどは、サービスごとに個別管理してください。APIキーは配布ZIPの中に含まれていません。インストール時に、顧客自身のAWSアカウントで必要な権限を設定します。

Contabo Cloud

Contabo Cloudモジュールは、ContaboのVPSとVDSに対して、プロビジョニング、電源操作、再インストール、パスワードリセット、スナップショット管理を行うための連携を提供します。資源IDがWHMCSサービスと正しく対応していること、再送された作成リクエストが同じ資源に対して整合されること、削除のような操作で所有権確認ができることは、とても重要です。

Contaboアカウント、APIアクセス、プロバイダー側の利用料は別途必要です。プランのアップグレード、逆引きDNS、ブラウザ内VNC、あるいは各プロバイダー固有のすべての機能がモジュールに含まれると考えず、製品ページの最新機能一覧を基準にしてください。

Microsoft Azure VM

Microsoft Azure VMモジュールは、仮想マシンのプロビジョニング、電源操作、deallocate、サイズ変更、ディスク、snapshot、ファイアウォール管理をWHMCSに接続します。リソースグループと仮想マシンのタグは、サービス所有者を確認するために使います。削除処理は、Azure側の非同期処理が完了し、本当にリソースが消えたことを確認してから完了扱いにすべきです。

Azureのディスクやsnapshotのような有償追加リソースについては、カタログ設定と料金設定を運用側で準備する必要があります。顧客に見せる選択肢は、構成済みでテスト済みの範囲だけに限定するのが無難です。

Google Cloud Compute Engine

Google Cloudモジュールは、LinuxベースのCompute Engine仮想マシンで、プロビジョニング、電源操作、マシンタイプの変更、サービス単位のネットワークルール管理をつなげます。資源名、リージョン、サービスタグは恒久的な識別子として保存され、ライフサイクル操作はその所有情報を確認してから実行されます。

現行の2.0.0配布版の範囲はLinuxワークロード向けです。WindowsやRDPの対応がある前提で設計しないようにしてください。Google Cloudプロジェクト、サービスアカウント、クォータ、ネットワーク、課金設定は、運用側で用意します。

どのWHMCSモジュールを選ぶべきか?

  • 古い更新料金を最新の料金表へ反映したいなら、自動料金更新 を検討してください。
  • Paddle CheckoutやMollieで決済を受けたいなら、該当する決済ゲートウェイモジュールを選びます。
  • 同じWHMCS環境内の顧客間でドメイン譲渡が必要なら、顧客間ドメイン転送 が適しています。
  • 多数の顧客アカウントでクレジット処理を行うなら、顧客残高マネージャー が便利です。
  • 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・タイムアウト・リトライ・終了処理のシナリオをテストしてから、本番へ切り替えます。

ダウンロードファイルは、一般公開のWebディレクトリから配布されるわけではありません。製品とサービスの紐づけ、およびActive状態かどうかが、顧客エリアでのダウンロード権限を決めます。注文画面に表示される最新のライセンス条件とインストール手順が、この要約より優先されます。

ライセンス、プロバイダー費用、セキュリティの境界

モジュールのファイルは、暗号化されていないソースコードで提供されます。ただし、これは「オープンソース」や自由な再配布権を意味しません。利用、改変、再配布の権利は、購入したライセンス契約に従います。製品と導入内容は WHMCSライセンス管理 の考え方で管理してください。プロバイダーのAPIキー、本番の顧客データ、実際の資源ID、Hostragons側の運用データは、配布パッケージには含まれません。

インストール時は、最小権限の原則を徹底してください。可能であれば、モジュールには必要なAPI操作だけを許可した別の認証情報を与え、Webhookシークレットは定期的に更新し、WHMCS管理者ロールを絞り込み、ログでは機微情報をマスクします。本番前には、必ず別のテストアカウントか、低コストのテスト資源を使って検証してください。キャンセルや終了のテストでは、プロバイダーAPIの応答だけでなく、資源が本当に削除されたか、課金対象の追加リソースが残っていないかまで確認する必要があります。

クラウドサーバー サービスを販売する際は、コスト計算に仮想マシン本体だけでなく、ディスク、snapshot、IP、トラフィック、ライセンス、リージョンごとの差額まで含めてください。モジュールの自動化は運用時間を短縮しますが、プロバイダーのクォータ、アカウント審査、請求責任まで肩代わりしてくれるわけではありません。

インストール前の簡易チェックリスト

  • 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になったあと、顧客エリアに購入済み製品のダウンロードリンクが表示されます。

モジュールのソースコードは暗号化されていますか?

モジュールは暗号化されていないソースコードで提供されます。利用、カスタマイズ、再配布の権利は、購入ライセンスの条件に従います。

WHMCSの業務フローに合うモジュールを選ぼう

決済、顧客運用、クラウドサーバー自動化のいずれであっても、必要なモジュールの範囲、最新価格、ライセンス条件を比較することが大切です。WHMCSモジュールを見る を確認し、インストール手順とあわせて、本番前のテスト計画をきちんと立ててから導入しましょう。

この記事を共有する:

Hostragons チーム

ホスティング、サーバー、ドメイン名に関する、当社の専門チームによる最新ガイド。お客様のプロジェクトに最適なソリューションを一緒に見つけましょう。

お問い合わせ