> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Fynn API V2

> Modelliere dein Angebot als Pläne mit Tarifstufen, Up- und Downgrades und Checkout über die Fynn API V2.

Mit der Fynn API V2 modellierst du dein Angebot als **Pläne**: eine Leiter aus Tarifstufen, zwischen denen Kunden auf- und absteigen, mit Checkout und anteiliger Abrechnung beim Wechsel.

<Info>
  Pläne bildest du über die V2-Endpunkte ab. Für alle anderen Anwendungsfälle nutzt du weiterhin die [API-Referenz](/api-reference/introduction). Beide laufen parallel, du wählst pro Anwendungsfall die passende.
</Info>

## Plattformweite Grundlagen

Diese Bausteine gelten unabhängig vom Anwendungsfall:

<CardGroup cols={2}>
  <Card title="Authentifizierung" icon="key" href="/v2-plans-api/authentication">
    API-Token für die Einrichtung, Kunden-Token für den Kundenbereich.
  </Card>

  <Card title="Asynchrone Abrechnung" icon="receipt" href="/v2-plans-api/billing">
    Wie Änderungen gesammelt und Rechnungen asynchron erzeugt werden.
  </Card>
</CardGroup>

<Note>
  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](/guide/tenant/sales-channels).
</Note>

## 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:

<CardGroup cols={3}>
  <Card title="Plan" icon="box">
    Die Klammer um dein Angebot, mit stabilem `code`, Namen und Status.
  </Card>

  <Card title="Tarifstufe" icon="stairs">
    Eine Stufe auf der Leiter, zum Beispiel Starter, Pro oder Business.
  </Card>

  <Card title="Position" icon="cube">
    Ein Produkt mit Preisplan innerhalb einer Stufe, inklusive Mengen.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Schnellstart" icon="rocket" href="/v2-plans-api/quickstart">
    Vom ersten Plan bis zum ersten Tarifwechsel in wenigen Aufrufen.
  </Card>

  <Card title="Kernkonzepte" icon="book" href="/v2-plans-api/concepts">
    Plan, Tarifstufe, Position, Status und die wichtigsten Felder.
  </Card>

  <Card title="Up- und Downgrades" icon="arrow-up-arrow-down" href="/v2-plans-api/upgrades-downgrades">
    Erreichbarkeit, Vorschau und die anteilige Berechnung.
  </Card>

  <Card title="Checkout" icon="cart-shopping" href="/v2-plans-api/checkout-and-sales-channels">
    Checkout-Links für Tarifstufen und der Weg zum Abonnement.
  </Card>

  <Card title="API-Referenz" icon="code" href="/v2-plans-api/plans/create-plan">
    Alle Endpunkte mit Parametern, Antworten und Beispielen.
  </Card>
</CardGroup>
