Pläne bildest du über die V2-Endpunkte ab. Für alle anderen Anwendungsfälle nutzt du weiterhin die API-Referenz. Beide laufen parallel, du wählst pro Anwendungsfall die passende.
Plattformweite Grundlagen
Diese Bausteine gelten unabhängig vom Anwendungsfall:Authentifizierung
API-Token für die Einrichtung, Kunden-Token für den Kundenbereich.
Asynchrone Abrechnung
Wie Änderungen gesammelt und Rechnungen asynchron erzeugt werden.
Manche Konzepte sind plattformweiter Standard und gelten für V1 und V2 gleichermaßen. Vertriebskanäle (Sales-Channels) zum Beispiel steuern Branding, Domain und Standardeinstellungen für jeden Verkauf. Sie haben keine eigene V2-Variante. Die vollständige Anleitung findest du unter Vertriebskanäle.
Pläne
Mit Plänen modellierst du dein Angebot als eine Leiter aus Tarifstufen, zwischen denen Kunden auf- und absteigen. Das Modell besteht aus drei Bausteinen:Plan
Die Klammer um dein Angebot, mit stabilem
code, Namen und Status.Tarifstufe
Eine Stufe auf der Leiter, zum Beispiel Starter, Pro oder Business.
Position
Ein Produkt mit Preisplan innerhalb einer Stufe, inklusive Mengen.
Schnellstart
Vom ersten Plan bis zum ersten Tarifwechsel in wenigen Aufrufen.
Kernkonzepte
Plan, Tarifstufe, Position, Status und die wichtigsten Felder.
Up- und Downgrades
Erreichbarkeit, Vorschau und die anteilige Berechnung.
Checkout
Checkout-Links für Tarifstufen und der Weg zum Abonnement.
API-Referenz
Alle Endpunkte mit Parametern, Antworten und Beispielen.