Startseite
XtreamUIPro

Tutorial

Einen Shop mit einem Konnektor anbinden

Lassen Sie Ihre Abrechnungs- oder Shop-Plattform Lines selbst anlegen und verlängern: ein API-Schlüssel, der Konnektor für Ihre Plattform, eine Testbestellung und Webhooks für das, was danach passiert.

Am Ende legt eine auf Ihrer Plattform bezahlte Bestellung eine Line an, und jede Zahlung verlängert sie, ohne das Dashboard. Sie brauchen ein Partnerkonto (Reseller) mit Credits und Paketen, die es verkaufen darf, und eine Plattform mit Konnektor – WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress mit WooCommerce oder Easy Digital Downloads, Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext oder Shopify, Upmind und Invoice Ninja über die Webhook-Bridge.

Einen API-Schlüssel erstellen

Melden Sie sich mit dem Partnerkonto an und öffnen Sie API-Schlüssel. Ein Schlüssel wird einmal angezeigt, wenn er erstellt wird – kopieren Sie ihn sofort. Erstellen Sie pro System einen zusätzlichen Schlüssel, mit einem Namen und den Adressen, die ihn nutzen dürfen, damit einer widerrufen werden kann, ohne die anderen anzufassen; der Konnektor braucht einen Schlüssel mit Schreibrecht, lassen Sie also das Nur-Lese-Flag ausgeschaltet.

Die Seite API Key eines Partnerkontos: der Schlüssel, die zusätzlichen Schlüssel pro System, die Webhooks und die letzten Aufrufe.
Die Seite API Key eines Partnerkontos: der Schlüssel, die zusätzlichen Schlüssel pro System, die Webhooks und die letzten Aufrufe.

Den Konnektor wählen

Öffnen Sie Resources → All Connectors und wählen Sie Ihre Plattform. Ihre Seite listet die Verbindungsdaten, die Installationsschritte, eine Schaltfläche Download, die SHA-256 der Datei zur Überprüfung und wie weit dieser Konnektor getestet wurde – einige liefen in der echten Plattform, bei anderen wurde nur der Kern geprüft. Der Quellcode ist offen; dieselben Dateien werden auf der Konnektoren-Website veröffentlicht.

Die Seite All Connectors: eine Karte pro Plattform mit ihrer Version und dem Grad der Tests.
Die Seite All Connectors: eine Karte pro Plattform mit ihrer Version und dem Grad der Tests.

Auf Ihrer Plattform installieren

Prüfen Sie die Prüfsumme und installieren Sie die Datei dort, wo die Seite des Konnektors es angibt: der Modulordner von WHMCS, Blesta oder FOSSBilling, der Plugin-Upload von WordPress, der Addons-Ordner von Odoo, der Erweiterungsinstaller von OpenCart und so weiter. Die Webhook-Bridge für Shopify, Upmind und Invoice Ninja ist eine kleine PHP-Anwendung, die Sie selbst hosten. Ein Konnektor ruft nur die Reseller API mit Ihrem Schlüssel auf: Er kann tun, was Ihr Konto kann, nicht mehr.

Die Seite des WHMCS-Konnektors: Verbindungsdaten, Installationsschritte, der Download und seine SHA-256.
Die Seite des WHMCS-Konnektors: Verbindungsdaten, Installationsschritte, der Download und seine SHA-256.

Konfigurieren

Tragen Sie in den Einstellungen des Konnektors die Adresse des API-Servers (sein Pfad /reseller/v1) und den Schlüssel ein und ordnen Sie dann jedes Produkt Ihrer Plattform einem Paket zu, das Ihre Gruppe verkaufen darf. Preise und Zahlung bleiben auf Ihrer Plattform: Das Panel nimmt kein Geld an und hat kein Gateway.

Eine Testbestellung aufgeben

Bestellen Sie das Produkt in einer Testumgebung Ihrer Plattform. Der Konnektor ruft create_line mit dem Paket und einer Request-ID auf; die Line erscheint unter Lines mit der Laufzeit des Pakets als Ablauf, und Ihre Plattform erhält ihre Zugangsdaten. Eine Verlängerung ruft renew_line mit einer eigenen Request-ID auf, sodass ein erneuter Versuch nach einem Netzwerkfehler nie doppelt berechnet wird. Die Seite API Key listet die letzten Aufrufe mit Aktion, Ergebnis, Fehlercode, Adresse und Konnektor-Namen.

Die Seite Lines nach einer Testbestellung: die neue Line mit dem Paket, dem Ablauf und den Verbindungen, die der Konnektor angefordert hat.
Die Seite Lines nach einer Testbestellung: die neue Line mit dem Paket, dem Ablauf und den Verbindungen, die der Konnektor angefordert hat.

Webhooks hinzufügen (optional)

Fügen Sie auf der Seite API Key einen Webhook-Endpunkt (eine https-Adresse Ihrer Plattform) für die gewünschten Ereignisse hinzu: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low. Jede Benachrichtigung wird mit dem bei der Erstellung einmal angezeigten Secret signiert (X-Xtream-Signature) und enthält nie ein Passwort; die Schaltfläche Test sendet sofort eine.

Verwandte Hilfethemen

Nächste Tutorials