Das hosting.de
WHMCS Modul

Verkauf Cloud- und VPS-Produkte aus Deinem WHMCS heraus. Werde zum Reseller von hosting.de!

Für Dich mit in Deutschland entwickelt und betrieben.

Begeistertes Team jubelt im Büro gemeinsam vor dem Bildschirm über einen Erfolg

Was macht das hosting.de WHMCS Modul?

Das Modul verbindet den Vertragsstatus in Deinem WHMCS mit einer echten Maschine in der hosting.de Cloud. WHMCS weiß, wer bei Dir was bestellt, bezahlt oder gekündigt hat. Die hosting.de Cloud API weiß, wie man einen VPS anlegt, startet, stoppt oder löscht. Das Modul übersetzt zwischen beiden Seiten: Es nimmt die Ereignisse aus dem Vertragslebenszyklus entgegen und löst dazu die passende Aktion in der Cloud aus.

Vom Auftrag zur laufenden Maschine

Einmal eingerichtet, läuft der Lebenszyklus ohne Handarbeit:

  • Bestellung aktiviert: Das Modul ruft die Cloud API auf, der VPS wird nach den Vorgaben aus Deinem Produkt provisioniert. Dein Kunde erhält die Zugangsdaten automatisch aus WHMCS heraus, in Minuten statt Stunden.
  • Zahlung bleibt aus: Der Vertrag wird gesperrt, die Maschine ebenfalls.
  • Zahlung geht ein: Die Sperre wird aufgehoben, der VPS läuft weiter.
  • Kündigung: Der VPS wird gelöscht, die Ressourcen werden frei und kosten Dich nichts mehr.

Wichtig dabei: Es entsteht kein Zwischenschritt über unseren Support. Der Vertrag in Deinem WHMCS ist die Quelle der Wahrheit, die Maschine folgt ihm.

Was Deine Kunden selbst erledigen

Zu jedem VPS erscheint in Deinem WHMCS-Kundenbereich eine Steuerung. Damit greifen Deine Kunden direkt durch bis auf die Maschine, ohne ein Ticket zu schreiben:

  • Power ON / Power OFF: Server starten und herunterfahren
  • Reset: Neustart, etwa wenn ein Dienst hängt
  • Rescue Mode: aktivieren und wieder deaktivieren, um ein defektes System zu reparieren oder Daten zu retten
  • Betriebssystem installieren: Neuinstallation mit dem gewünschten Image

Für Dich heißt das: weniger Supportaufwand für Standardvorgänge. Für Deine Kunden: kein Warten auf eine Antwort.

Einrichtung

Die Installation folgt dem WHMCS-Standard. Modulcode in das Server-Modulverzeichnis Deiner WHMCS-Installation kopieren, API-Key in Deiner hosting.de Kundenplattform erzeugen, Server-Eintrag in WHMCS anlegen und dem Produkt zuweisen. Ab diesem Moment provisioniert jede bezahlte Bestellung einen VPS.

Agenturteam bespricht sich lachend im Büro vor Monitoren mit Programmcode

Automatische Provisionierung

Wird eine Bestellung in WHMCS aktiviert, legt das Modul die virtuelle Maschine bei hosting.de an und verknüpft sie über das Custom Field machineId fest mit dem WHMCS-Vertrag. Du legst keine Maschine von Hand an und pflegst keine IDs nebenher.

Vertragsstatus steuert die Maschine

Suspend in WHMCS schaltet die Maschine aus, Unsuspend schaltet sie wieder an. Eine unbezahlte Rechnung sperrt den VPS damit ohne Dein Zutun, die Zahlung gibt ihn wieder frei.

Self-Service für Deine Kunden

Deine Kunden steuern ihren VPS im WHMCS-Kundenbereich, statt Dir dafür ein Ticket zu schreiben. Solange der Vertrag nicht aktiv ist, sind diese Aktionen gesperrt.

Ressourcen anpassen

Wächst ein Kunde, änderst Du die Ausstattung der bestehenden Maschine über das Modul.

Fehlermeldungen bleiben im Adminbereich

Im Kundenbereich erscheinen nur API-Meldungen aus einer geprüften Liste. Die vollständigen Fehlerdetails stehen im Adminbereich und im Modul-Log.

Für wen das Modul gemacht ist

Hoster und Reseller

Die ihr Portfolio um VPS erweitern wollen, ohne selbst Hardware, Virtualisierung und Rechenzentrum zu betreiben.

Agenturen und Freiberufler

Die ihren Kunden Server mitverkaufen und Abrechnung, Vertrag und Technik nicht in drei getrennten Systemen pflegen wollen.

Alle, für die Datenschutz ein Verkaufsargument ist

Die Maschinen laufen in Deutschland, betrieben von der hosting.de GmbH nach ISO/IEC 27001. Das kannst Du Deinen eigenen Kunden gegenüber genauso vertreten.

Ohne WHMCS führt der Weg über unsere API.

Installation in vier Schritten

WHMCS Modul herunterladen Version 20240829 · .tgz · 1,6 MB
  1. 1. Modul herunterladen und kopieren

    Lade das Modul herunter und entpacke das Archiv im Hauptverzeichnis Deiner WHMCS-Installation. Der Ordner HostingDeVps liegt danach unter modules/servers/HostingDeVps/.

  2. 2. Cronjob einrichten (optional)

    Für die interne Warteschlange des Moduls richtest Du einen Cronjob ein: php -q /pfad/zu/whmcs/modules/servers/HostingDeVps/cron/cron.php

  3. 3. Server anlegen

    Unter Setup > Products/Services > Servers legst Du einen neuen Server an. Als Type wählst Du HostingDeVps, als Hostname Deinen hosting.de API-Hostnamen. Aktiviere Secure (SSL) und hinterlege Deinen API-Auth-Token als Access Hash. Test Connection prüft die Zugangsdaten sofort.

  4. 4. Produkte verknüpfen

    Weise den Server oder eine Servergruppe den Produkten zu, die Du verkaufen willst. Im Produkt selbst wählst Du unter Setup > Products/Services das Module HostingDeVps und als Order Form Template das mitgelieferte without_nsprefix, weil VPS-Produkte keine Nameserver-Felder brauchen.

So funktioniert es im laufenden Betrieb

Ein Kunde bestellt in Deinem WHMCS ein VPS-Produkt und bezahlt. Mit der Aktivierung des Vertrags ruft das Modul die hosting.de Cloud API auf, die Maschine wird angelegt, und ihre machineId landet im Vertrag. Der Kunde sieht seinen Server ab sofort im Kundenbereich und verwaltet ihn dort selbst.

Bleibt eine Verlängerungsrechnung offen, setzt WHMCS den Vertrag auf Suspended, und das Modul schaltet die Maschine aus. Nach Zahlungseingang läuft sie wieder an. Kündigt der Kunde, wird die Maschine gelöscht. Ist sie noch wiederherstellbar, entfernst Du sie im Adminbereich endgültig über Purge Machine.

Alle API-Aufrufe laufen über den Hostnamen und das Protokoll aus dem WHMCS-Server-Datensatz und authentifizieren sich mit dem dort hinterlegten Access Hash.

POST /api/machine/v1/json/virtualMachineCreate

{
    "authToken": "********",
    "virtualMachine": {
        "accountId": "170817322018134",
        "name": "kunde-vps-01",
        "productCode": "cloud-server-vps-2-4-80-1m"
    }
}

Fragen zum Modul oder zu den Konditionen?

Du willst wissen, ob das Modul zu Deinem Setup passt, oder brauchst Zugangsdaten für die Cloud API? Schreib uns, wir gehen die Einrichtung mit Dir durch.

Häufig gestellte Fragen

Welche Zugangsdaten benötige ich?
Den API-Hostnamen von hosting.de und einen API-Auth-Token, den Du in WHMCS als Access Hash hinterlegst. Über Test Connection prüfst Du direkt, ob beides passt.
Muss ich den Cronjob einrichten?
Er ist optional. Der Cronjob arbeitet die interne Warteschlange des Moduls ab, deshalb empfehlen wir ihn für den produktiven Einsatz.
Was passiert bei einer unbezahlten Rechnung?
WHMCS setzt den Vertrag auf Suspended, das Modul schaltet die Maschine aus. Nach Zahlungseingang und Unsuspend startet sie wieder.
Was können meine Kunden selbst machen?
Sie steuern ihren VPS im WHMCS-Kundenbereich. Ist der Vertrag nicht aktiv, sind alle Self-Service-Aktionen gesperrt.
Sehen meine Kunden technische Fehlermeldungen von hosting.de?
Nein. Im Kundenbereich erscheinen nur Meldungen aus einer geprüften Liste. Die vollständigen Fehlerdetails findest Du im Adminbereich und im Modul-Log.
Wie werde ich eine gelöschte Maschine endgültig los?
Solange eine gelöschte Maschine noch wiederherstellbar ist, entfernst Du sie im Adminbereich über Purge Machine dauerhaft.
Kann ich Produkte später hoch- oder runterstufen?
Die Ausstattung bestehender Maschinen lässt sich über das Modul ändern.
Wo laufen die Server?
In Deutschland, betrieben von der hosting.de GmbH, zertifiziert nach ISO/IEC 27001.
An wen wende ich mich bei Problemen?
An support@hosting.de oder über unser Kontaktformular.
Kontakt aufnehmen