Portal, API und Hosted Pages im Zusammenspiel

Die tebio Plattform kann auf drei Arten genutzt werden: über das tebio Business-Portal, über die API und über Hosted Pages.

Diese drei Zugangswege erfüllen unterschiedliche Aufgaben, greifen aber auf dieselben zentralen Plattformdaten und Plattformprozesse zu.

Das tebio Business-Portal ist die Arbeitsoberfläche für Business-User.
Die API ist die technische Schnittstelle für Integrationen und Automatisierung.
Hosted Pages sind bereitgestellte Oberflächen für kunden- oder partnerseitige Prozesse im eigenen Branding.

Zusammen bilden Portal, API und Hosted Pages eine flexible Plattformarchitektur: Interne Teams arbeiten operativ im Portal, externe Systeme integrieren über die API, und Kunden oder Vertriebspartner interagieren über bereitgestellte Seiten.

Die drei Zugänge im Überblick

Zugang	Zielgruppe	Typische Nutzung
tebio Business-Portal	Business-User, Operations, Finance, Customer Care und Produktmanagement	Manuelle Verwaltung, Konfiguration, Prüfung und operative Bearbeitung
API	Entwickler, technische Teams, Backend-Systeme und Integrationspartner	Systemintegration, Datenübertragung, Prozesssteuerung und Automatisierung
Hosted Pages	Kunden, Vertriebspartner, Affiliate-Partner und externe Nutzer	Bestellungen, Self-Care / Kundenportal, Vertriebspartnerportal und Affiliate Pages

Alle drei Zugänge können je nach Geschäftsmodell einzeln oder kombiniert genutzt werden.

tebio Business-Portal

Das tebio Business-Portal ist die webbasierte Benutzeroberfläche der tebio Plattform.

Business-User verwenden das Portal, um zentrale Aufgaben direkt auszuführen, ohne eigene Software entwickeln zu müssen. Das Portal eignet sich besonders für operative Tätigkeiten, Konfigurationen und manuelle Prüfprozesse.

Typische Aufgaben im tebio Business-Portal sind:

Kunden anlegen und bearbeiten
Subscriptions erstellen, ändern, pausieren oder kündigen
Produkte, Optionen und Preise konfigurieren
Bestellungen erfassen oder prüfen
Rechnungen einsehen und verwalten
Zahlungen, Gutschriften und Erstattungen nachvollziehen
Helpdesk-Tickets bearbeiten
Vertriebspartner verwalten
Einstellungen und Konfigurationen pflegen
Ereignisverläufe und Dokumente einsehen

Das Portal ist besonders relevant für Teams, die Geschäftsprozesse steuern, prüfen oder korrigieren müssen.

API

Die API ist die technische Schnittstelle zur tebio Plattform.

Über die API können externe Systeme Daten an tebio übertragen, Plattformfunktionen auslösen oder Informationen aus tebio abrufen. Die API eignet sich für Unternehmen, die tebio in bestehende Systemlandschaften integrieren oder wiederkehrende Prozesse automatisieren möchten.

Typische API-Anwendungsfälle sind:

Kunden aus einem externen CRM-System anlegen oder aktualisieren
Subscriptions aus einem eigenen Produkt-Backend erstellen
Bestellungen aus einem externen Shop übertragen
Nutzungsdaten für Usage-based Billing übermitteln
Rechnungs- oder Zahlungsinformationen abrufen
Statusänderungen an externe Systeme zurückmelden
Self-Service-Prozesse in ein eigenes Kundenportal integrieren

Die API ist besonders relevant, wenn Prozesse nicht manuell im Portal durchgeführt werden sollen, sondern aus anderen Systemen heraus gesteuert werden.

Die detaillierte technische Beschreibung der Endpunkte, Parameter, Authentifizierung und Antwortformate finden Sie in der separaten API-Referenz.

Hosted Pages

Hosted Pages sind von tebio bereitgestellte Seiten im Branding Ihres Unternehmens.

Sie ermöglichen kunden- oder partnerseitige Prozesse, ohne dass Unternehmen dafür zwingend ein eigenes Frontend entwickeln müssen. Hosted Pages greifen auf konfigurierte Plattformprozesse zu und können in das eigene Geschäftsmodell eingebunden werden.

Typische Einsatzbereiche für Hosted Pages sind:

Bestellseiten
Self-Care / Kundenportal
Vertriebspartnerportal
Affiliate Pages
Kundenregistrierung
Aktualisierung von Kundendaten oder Zahlungsmethoden
Anzeige von Dokumenten oder Rechnungen
Erfassung von Einwilligungen

Hosted Pages eignen sich besonders, wenn Kunden, Vertriebspartner oder Affiliate-Partner direkt mit Prozessen der tebio Plattform interagieren sollen.

Gemeinsame Datenbasis

Portal, API und Hosted Pages arbeiten mit denselben zentralen Plattformobjekten.

Dazu gehören zum Beispiel:

Kunden
Produkte
Optionen
Subscriptions
Bestellungen
Rechnungen
Zahlungen
Dokumente
Ereignisse
Vertriebspartner
Tenants, Einstellungen und Konfigurationen

Wenn ein Kunde über eine Hosted Page eine Bestellung auslöst, kann diese Bestellung anschließend im tebio Business-Portal eingesehen und bearbeitet werden.

Wenn ein externes System über die API eine Subscription erstellt, kann diese Subscription ebenfalls im Portal verwaltet werden.

Wenn ein Business-User im Portal eine Änderung vornimmt, kann diese Änderung über Ereignisse oder Webhooks für externe Systeme relevant werden.

Dadurch entsteht ein gemeinsamer Prozessraum, in dem manuelle, automatisierte und kunden- oder partnerseitige Abläufe zusammengeführt werden.

Typisches Zusammenspiel in einem Geschäftsprozess

Ein häufiger Ablauf kombiniert alle drei Zugänge:

Ein Unternehmen konfiguriert Produkte, Optionen, Preise und Hosted Pages im tebio Business-Portal.
Ein Kunde bestellt ein Produkt über eine Hosted Page.
Die Bestellung erzeugt eine Subscription oder einen anderen Folgeprozess in der tebio Plattform.
Business-User prüfen oder bearbeiten den Vorgang im tebio Business-Portal.
Externe Systeme werden über API oder Webhooks über relevante Änderungen informiert.
Rechnungen, Zahlungen, Dokumente und Ereignisse werden zentral in tebio verwaltet.

Dieser Ablauf zeigt, dass Portal, API und Hosted Pages keine getrennten Systeme sind. Sie sind unterschiedliche Zugänge zu denselben Plattformdaten und Plattformprozessen.

Beispiel: Bestellung über Hosted Page mit API-Anbindung

Ein Unternehmen bietet ein Abo-Produkt über eine Hosted Page an.

Der Kunde öffnet die Bestellseite, gibt seine Daten ein, wählt eine Zahlungsmethode und schließt die Bestellung ab. tebio erstellt daraus die relevanten Plattformobjekte, zum Beispiel Kunde, Bestellung und Subscription.

Anschließend können interne Teams den Vorgang im tebio Business-Portal prüfen. Gleichzeitig kann ein externes System über Webhooks informiert werden und bei Bedarf weitere Daten über die API abrufen.

So können kundennahe Prozesse schnell über Hosted Pages bereitgestellt werden, während interne Teams im Portal arbeiten und externe Systeme technisch angebunden bleiben.

Nächste Schritte

Wenn Sie entscheiden möchten, welcher Zugang für Ihren Anwendungsfall geeignet ist, lesen Sie den Artikel Wann nutze ich Portal, API oder Hosted Pages?.

Weitere relevante Themen: