Zum Hauptinhalt springen
Die V2-Abrechnung folgt einem einheitlichen Muster: Änderungen werden gesammelt, und Rechnungen entstehen asynchron. Das gilt plattformweit und ist hier am Beispiel der Pläne erklärt. Für die Integration sind vor allem zwei Dinge wichtig: wann eine Rechnung entsteht und wie sich eine Änderung wie ein Tarifwechsel auf die Abrechnung auswirkt.

Wann abgerechnet wird

  • Erstrechnung: Beim Checkout entsteht das Abonnement und die erste Abrechnung für die gewählte Tarifstufe.
  • Wiederkehrend: Danach wird das Abonnement regelmäßig im Intervall des Preisplans abgerechnet.
  • Bei Änderungen: Ein Tarifwechsel erzeugt keine eigene, sofortige Rechnung. Die anteilige Gutschrift oder Berechnung wird gesammelt und fließt in die nächste reguläre Rechnung ein.

Sammeln bis zur nächsten Rechnung

Solange für die laufende Periode noch keine Rechnung erstellt wurde, werden Positionen gesammelt. Rechnungen werden anschließend asynchron erzeugt, also nicht im selben Moment wie der API-Aufruf. Für dich als Entwickler heißt das:
1

Die Wechsel-Antwort enthält keine fertige Rechnung

switch-plan-tier bestätigt den Wechsel, liefert aber keine Rechnung. Die Rechnung folgt kurze Zeit später.
2

Mehrere Änderungen werden gebündelt

Führst du mehrere Änderungen kurz nacheinander aus, landen sie gemeinsam auf einer Rechnung, statt einzeln abgerechnet zu werden.
3

Den Effekt vorab zeigen

Wenn du dem Kunden die Kosten sofort zeigen möchtest, nutze die Vorschau. Sie liefert die erwartete Gutschrift und Berechnung, ohne etwas zu verändern.
Plane in deiner Oberfläche damit, dass eine Rechnung nach einem Wechsel mit kurzer Verzögerung erscheint. Verlasse dich für die sofortige Anzeige der Kosten auf die Vorschau, nicht auf eine direkte Rechnung.

Zusammenspiel mit Abonnements

Ein über einen Plan verkauftes Abonnement ist ein ganz normales Abonnement. Es trägt zusätzlich einen Verweis auf die aktuell aktive Tarifstufe (activePlanTier).
  • Beim Checkout wird das Abonnement angelegt und an die gewählte Tarifstufe gebunden.
  • Ein Tarifwechsel ersetzt die Positionen des Abonnements durch die der Zielstufe und aktualisiert die aktive Tarifstufe.
  • Status, Laufzeit und Abrechnung folgen den Regeln regulärer Abonnements. Eine Übersicht dazu findest du unter Abonnements.