Lizenzierung und Pro-Aktivierung

Der Free-Plan ist eine unterstützte, dauerhafte Betriebsart von Perfex CRM Integration for WHMCS. Er synchronisiert Kunden und Kontakte in eine Richtung, von WHMCS nach Perfex, in Echtzeit. Dafür benötigen Sie niemals einen Schlüssel.

Eine Pro-Lizenz schaltet alles Weitere frei. Diese Seite behandelt den Kauf, die Aktivierung, die Prüfung und das Entfernen.

Was Pro freischaltet

Durch Pro freigeschaltet	Was das im Alltag bedeutet
🔁 Zwei-Wege-Synchronisierung von Kunden und Kontakten	Eine in Perfex korrigierte Adresse fließt zurück nach WHMCS, gemäß der von Ihnen gewählten Konfliktregel
📄 Rechnungsspiegelung	WHMCS-Rechnungen erscheinen beim Perfex-Kunden mit ihren Positionen, der Steuerzeile und dem Status
💳 Zahlungs- und Transaktionssynchronisierung	Eine bezahlte WHMCS-Rechnung setzt ihre Perfex-Spiegelung auf Paid, mit erfasstem Zahlungsanbieter und erfasster Transaktions-ID
🛒 Bestellsynchronisierung	Eine WHMCS-Bestellung wird zu einem Perfex-Lead, zu einer Notiz beim Kunden oder zu nichts, ganz wie Sie es wünschen
🎫 Support-Ticket-Synchronisierung	Tickets, Antworten und Statusänderungen fließen in beide Richtungen, optional mit einer Perfex-Aufgabe je Ticket für die Zeiterfassung
🌐 Panel für Dienste und Domains	Ein Reiter WHMCS in jedem Perfex-Kundenprofil, der die Dienste und Domains dieses Kunden auflistet
⏬ Backfill wizard	Importieren Sie Ihre bestehenden Kunden, Rechnungen, Dienste und Domains, nicht nur neue Vorgänge
🗂️ Dropdowns für die Abteilungszuordnung	Ordnen Sie WHMCS-Ticketabteilungen Perfex-Abteilungen per Auswahlliste zu, statt IDs einzutippen

Den vollständigen direkten Vergleich finden Sie in der Tabelle Free vs Pro.

Die Lizenz liegt ausschließlich auf der WHMCS-Seite

Das Perfex-Companion ist kostenlos und hält niemals einen Schlüssel. Das WHMCS-Addon bestimmt den Plan und teilt Perfex mit, welcher es ist, damit die Perfex-Einstellungsseite erklären kann, warum die Zwei-Wege-Synchronisierung läuft oder eben nicht. Ihr Lizenzschlüssel selbst gelangt nie nach Perfex.

Pro kaufen: das Checkout-Overlay

Das ist der schnelle Weg, und er kommt vollkommen ohne Kopieren und Einfügen aus.

1. Klicken Sie auf einer der beiden Verwaltungsseiten auf einen Upgrade-Link:
   • WHMCS: Addons > Perfex CRM Bridge. Der Link erscheint als Buy a Pro licence neben dem Feld Pro License Key sowie als Upgrade to Pro in der Lizenzzeile der Checkliste und in den Pro-Hinweisboxen.
   • Perfex: Setup > WHMCS Bridge, Panel WHMCS plan, Schaltfläche Upgrade to Pro.
2. Ein sicheres Checkout-Overlay öffnet sich direkt über der Seite, auf der Sie sich bereits befinden.
3. Schließen Sie den Kauf ab.
4. Die Aktivierung erfolgt automatisch:
   • Aus WHMCS gestartet: Der Lizenzschlüssel aus der Checkout-Antwort wird in das Feld Pro License Key des Einstellungsformulars geschrieben, und dieses Formular wird für Sie abgesendet. Das Speichern prüft den Schlüssel live, stellt den Plan auf Pro um und informiert die Perfex-Seite, alles in derselben Anfrage.
   • Aus Perfex gestartet: Der Schlüssel wird über den signierten Bridge-Kanal an Ihre WHMCS-Installation weitergereicht. WHMCS prüft ihn live, bevor irgendetwas gespeichert wird, aktiviert Pro und meldet den frischen Planzustand unmittelbar zurück, sodass das Perfex-Plan-Panel ohne Neuladen auf Pro umspringt. Perfex speichert den Schlüssel nie.
5. Pro ist sofort aktiv. Sie müssen auf keinen Cron-Durchlauf warten und nichts eintippen.

Das Overlay ist eine Verbesserung, keine Voraussetzung

Wird das Overlay-Skript von einer Browser-Erweiterung, einer strengen Content-Security-Policy oder einer langsamen Verbindung blockiert, verhält sich der Link einfach wie eh und je und öffnet die gehostete Checkout-Seite in einem neuen Tab. Es geht nichts kaputt; Sie schließen den Vorgang lediglich mit dem manuellen Einfügen unten ab.

Wenn der Browser vor Abschluss der Aktivierung geschlossen wurde

Sie haben Ihren Schlüssel weiterhin. Zwei Sicherheitsnetze, in dieser Reihenfolge:

1. Auf der Seite. Wenn der Kauf erfolgreich war, die automatische Aktivierung aber nicht ausgeführt werden konnte, wird der Schlüssel auf der Seite in einem markierbaren Feld angezeigt, auf der Perfex-Seite mit einer Copy-Schaltfläche, dazu eine genaue Anleitung, wo Sie ihn einfügen. Ein bezahlter Schlüssel existiert niemals nur innerhalb eines geschlossenen Overlays.
2. In Ihrem Posteingang. Der Schlüssel wird Ihnen beim Kauf stets per E-Mail zugesandt und ist zusätzlich in Ihrem Kundenportal beim Zahlungsanbieter verfügbar. Wenn der Browser im ungünstigsten Moment abgestürzt ist, sehen Sie in Ihren E-Mails nach.

Folgen Sie anschließend dem manuellen Weg unten.

Einen Schlüssel manuell aktivieren

Nutzen Sie diesen Weg immer dann, wenn Sie den Schlüssel bereits besitzen: aus der Kaufbestätigung per E-Mail, aus Ihrem Kundenportal, oder wenn Sie eine Lizenz auf eine andere WHMCS-Installation umziehen.

1. Öffnen Sie in WHMCS Addons > Perfex CRM Bridge.
2. Scrollen Sie zu Settings > Pro licence.
3. Fügen Sie den Schlüssel in Pro License Key ein. Schlüssel beginnen mit sk_.
4. Klicken Sie auf Save Settings.

Das ist die gesamte Aktivierung. Das Speichern eines tatsächlich geänderten Schlüssels löst die Live-Prüfung sofort aus, sodass die Seite bereits mit Ihrem Plan zurückkommt. Sie müssen nichts weiter drücken und nicht auf einen Cron-Durchlauf warten.

Das Banner teilt Ihnen genau eines von drei Dingen mit:

Banner	Bedeutung	Was zu tun ist
🟢 Grün - "Settings saved. Licence verified - your Pro plan is active..."	Der Lizenzserver hat den Schlüssel bestätigt. Der Seitenkopf und die Checklistenzeile License / plan zeigen bereits Pro an, die Pro-Hinweisboxen sind verschwunden, und der Backfill wizard ist freigeschaltet.	Nichts. Sie sind fertig.
🔴 Rot - "Settings saved. The licence server rejected this key..."	Der Schlüssel wurde abgelehnt, und die Meldung nennt die Begründung des Servers: ein unbekannter Schlüssel, ein abgelaufenes Abonnement, eine gekündigte Lizenz oder ein bereits ausgeschöpftes Aktivierungskontingent.	Prüfen Sie, ob der Schlüssel exakt so eingefügt wurde, wie er in Ihrer Kaufbestätigung steht, ohne fehlende oder zusätzliche Zeichen, und speichern Sie erneut.
🟠 Gelb - "Settings saved. Could not reach the licence server..."	Weder eine Bestätigung noch eine Ablehnung: Ihr Server konnte den Lizenzdienst gerade nicht erreichen.	Der Schlüssel ist gespeichert, und die Versuche laufen automatisch weiter. Prüfen Sie, ob Ihr Server api.freemius.com über HTTPS erreichen kann, und klicken Sie dann auf Check licence now. Die Kulanzfrist schützt Sie in der Zwischenzeit.

"Settings saved." stimmt immer, unabhängig von der Farbe

Die Einstellungen werden in die Datenbank geschrieben, bevor irgendeine Lizenzprüfung läuft. Ein rotes Banner bedeutet daher nie "Ihr Speichern ist fehlgeschlagen". Es bedeutet "gespeichert, und Ihr Schlüssel wurde abgelehnt". Sie müssen das Formular nie erneut ausfüllen.

Das Speichern anderer Einstellungen kostet nichts

Nur ein tatsächlich geänderter Lizenzschlüssel löst eine Prüfung aus. Das Pausieren der Synchronisierung, das Ändern des Bestellziels oder das Bearbeiten des Ticket Reply Admin erzeugt überhaupt keinen Netzwerkaufruf, und das Banner bleibt ein schlichtes "Settings saved."

Check licence now

Die Schaltfläche Check licence now befindet sich oben auf der WHMCS-Modulseite, neben Test Connection und Run Sync Now.

Sie erzwingt eine sofortige erneute Prüfung des bereits gespeicherten Schlüssels und umgeht die tägliche Drosselung. Nutzen Sie sie, wenn:

• Sie Ihre Lizenz gerade verlängert oder erweitert haben und Pro sofort zurückhaben möchten;
• ein Speichervorgang gelb zurückkam und Sie das Netzwerk- oder Firewall-Problem inzwischen behoben haben;
• Sie den aktuellen Zustand bestätigen möchten, bevor Sie ein Support-Ticket eröffnen.

Die Schaltfläche hat eine kurze Sperre von wenigen Sekunden gegen Doppelklicks. Drücken Sie sie zweimal hintereinander, antwortet der zweite Druck mit "checked a moment ago", ohne eine zweite Anfrage zu senden. Warten Sie ein paar Sekunden, prüft sie wieder normal.

Ist überhaupt kein Schlüssel gespeichert, antwortet die Schaltfläche mit einem roten Banner, das den leeren Schlüssel meldet und darauf hinweist, dass die Installation im Free-Plan läuft. Es verlässt keine Anfrage Ihren Server.

Aktiviert bleiben: tägliche Prüfung und die 14-tägige Kulanzfrist

Sobald ein Schlüssel gespeichert ist, validiert der WHMCS-Cron ihn einmal täglich erneut. Sie müssen nichts tun.

Ist der Lizenzdienst nicht erreichbar, schaltet das Modul Sie nicht ab. Dieser Fall bedeutet "wir wissen es nicht", niemals "abgelehnt", und eine 14-tägige Kulanzfrist hält Pro voll funktionsfähig, während weiter geprüft wird.

Drei Details, die Sie kennen sollten:

• Die Kulanzuhr läuft ab der letzten erfolgreichen Prüfung, nicht ab dem letzten Versuch. Die auf der Seite angezeigte Restzeit ist die tatsächliche Anzahl verbleibender Tage und setzt sich nicht bei jedem fehlgeschlagenen Versuch zurück.
• Eine echte Ablehnung beendet die Kulanz sofort. Wenn der Lizenzserver aktiv meldet, dass die Lizenz abgelaufen, gekündigt oder ungültig ist, ist das eine Antwort, und die Kulanz greift nicht. Den Lizenz-Endpunkt an Ihrer Firewall zu blockieren, hält eine widerrufene Lizenz nicht am Leben.
• Die Kulanz verlängert, sie startet nie von selbst. Ein Schlüssel, der noch nie bestätigt wurde, hat keine Kulanz, auf die er sich stützen könnte. Wenn Sie einen brandneuen Schlüssel einfügen, während der Lizenzdienst nicht erreichbar ist, wird der Schlüssel gespeichert und weiter geprüft, aber Pro wird erst aktiv, wenn eine Prüfung tatsächlich erfolgreich war.

Planzustände, die im Seitenkopf erscheinen können

Text im Seitenkopf	Bedeutung
Free plan - no licence key set.	Kein Schlüssel. Das ist die Free-Stufe im Normalbetrieb.
Pro license set - awaiting first verification.	Ein Schlüssel ist gespeichert, wurde aber nie bestätigt. Klicken Sie auf Check licence now.
Pro active until YYYY-MM-DD (UTC)	Alles in Ordnung.
Pro active - lifetime licence	Eine Lizenz ohne Ablaufdatum.
Pro (grace) - could not reach the licence server, retrying daily. Pro keeps working for N more day(s).	Vorübergehende Störung. Für Sie ist noch nichts kaputt.
Free plan - this licence has expired.	Verlängern Sie, und klicken Sie dann auf Check licence now.
Free plan - this licence was cancelled.	Die Lizenz wurde gekündigt oder erstattet. Wenden Sie sich an den Support, falls das ein Irrtum ist.
Free plan - the licence key was rejected.	Falscher Schlüssel, oder das Aktivierungskontingent ist ausgeschöpft. Die Meldung enthält den Wortlaut des Servers.
Free plan - the licence server could not be reached and the grace period has run out.	Stellen Sie die Erreichbarkeit des Lizenz-Endpunkts wieder her und klicken Sie dann auf Check licence now.

Derselbe Satz erscheint in der Zeile License / plan der Setup checklist, Sie müssen ihn also nie suchen.

Aktivierungs-Slots

Eine WHMCS-Installation belegt einen Aktivierungs-Slot Ihrer Lizenz. Das Modul erzeugt einmalig eine stabile Kennung und verwendet sie dauerhaft weiter, sodass erneutes Prüfen, erneutes Speichern oder ein Umzug Ihrer Website auf eine andere Domain nie einen zweiten Slot verbraucht.

Erhalten Sie eine Ablehnung mit dem Hinweis, dass die Lizenz bereits auf der maximalen Anzahl von Installationen genutzt wird, entfernen Sie entweder den Schlüssel aus der Installation, die ihn nicht mehr benötigt, was den Slot sofort freigibt, oder Sie wenden sich wegen Ihres Kontingents an den Support.

Einen Schlüssel entfernen und zu Free zurückkehren

1. Öffnen Sie in WHMCS Addons > Perfex CRM Bridge > Settings > Pro licence.
2. Haken Sie Remove the stored key (revert to Free) an.
3. Klicken Sie auf Save Settings.

Was daraufhin geschieht:

• Die Installation kehrt sofort zu Free zurück, unabhängig davon, was noch zwischengespeichert ist. Die Pro-Funktionen werden eingestellt.
• Der Aktivierungs-Slot wird freigegeben, sodass die Lizenz auf einer anderen Installation aktiviert werden kann.
• Die Perfex-Seite wird über die Herabstufung informiert, damit ihr Panel WHMCS plan nicht den Rest des Tages weiter Pro anzeigt.

Entfernen Sie den Schlüssel, bevor Sie eine Website umziehen oder stilllegen

Wenn Sie eine WHMCS-Installation löschen, ohne zuvor den Schlüssel zu entfernen, bleibt ihr Aktivierungs-Slot belegt. Das Entfernen des Schlüssels dauert fünf Sekunden und erspart Ihnen später eine Support-Runde.

Was mit Ihren Daten geschieht, wenn Pro endet

Es wird nichts gelöscht. In einer Free-Installation gilt:

• Die Kunden- und Kontaktsynchronisierung läuft weiter, in eine Richtung, genau wie zuvor.
• WHMCS stellt keine Ereignisse mehr für Rechnungen, Zahlungen, Bestellungen, Dienste, Domains und Tickets in die Warteschlange. Die Schranke sitzt an der Quelle, es sammelt sich also nichts an, und es wird nichts sinnlos wiederholt.
• Änderungen der Perfex-Seite, die bereits für WHMCS eingereiht waren, werden mit der klaren Meldung "Two-way sync requires Pro on the WHMCS side" im Panel Outbound queue abgelehnt, wiederholt und schließlich in den Dead-Letter-Status versetzt.
• Alles bereits Synchronisierte bleibt in Perfex erhalten. Der Reiter WHMCS in den Kundenprofilen zeigt weiterhin die zuletzt gespeicherten Snapshots an; er wird lediglich nicht mehr aktualisiert.

Aktivieren Sie einen gültigen Schlüssel erneut, und alles läuft beim nächsten Ereignis wieder an.

Fehlerbehebung zur Lizenzierung

Symptom	Ursache	Lösung
Das Speichern eines Schlüssels bewirkt sichtbar nichts	Sie haben denselben Schlüssel eingefügt, der bereits gespeichert war. Nur ein geänderter Schlüssel löst eine Prüfung aus.	Klicken Sie auf Check licence now.
Das Banner ist jedes Mal gelb	Ihr Server erreicht den Lizenz-Endpunkt nicht über HTTPS.	Erlauben Sie ausgehendes HTTPS zu api.freemius.com durch jede Egress-Firewall oder jeden Proxy auf dem WHMCS-Server. Klicken Sie danach auf Check licence now.
"The licence key was rejected" bei einem korrekt aussehenden Schlüssel	Ein abgeschnittenes Einfügen, oder das Aktivierungskontingent ist ausgeschöpft.	Kopieren Sie den Schlüssel in einem Zug erneut aus der Kaufbestätigung. Schlüssel sind 32 Zeichen lang und können Satzzeichen enthalten, kürzen Sie also nichts. Erwähnt die Meldung Installationen, geben Sie einen Slot frei.
Perfex zeigt weiterhin Free, obwohl WHMCS Pro anzeigt	Der Planzustand hatte Perfex noch nicht erreicht.	Klicken Sie in WHMCS auf Check licence now oder Test Connection; beides übermittelt den Planzustand unmittelbar an Perfex. Laden Sie die Perfex-Einstellungsseite neu.
Das Perfex-Plan-Panel zeigt Unknown	Die WHMCS-Seite hat nie gemeldet oder seit langer Zeit nicht mehr.	Klicken Sie in WHMCS auf Test Connection und laden Sie dann die Perfex-Seite neu. Bleibt es bei Unknown, ist möglicherweise der WHMCS-Cron gestoppt, oder die beiden Seiten sind nicht mehr gekoppelt.

Mehr dazu unter Fehlerbehebung.