# Upsells für Abonnements

Mit Upsells ermöglichen Sie Kund/innen ein Uprade ihres Abonnementplans beim Bezahlvorgang.

# Gehostete Seite

> This is a Gehostete Seite for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/upsells?payment-ui=stripe-hosted.

Abonnement-Upsells bieten Kundinnen/Kunden die Möglichkeit, mit Checkout ein Upgrade auf einen Plan mit längerer Laufzeit vorzunehmen. Das Upselling von Kundinne/Kunden auf längere Abonnementintervalle (z. B. von monatlich auf jährlich) kann Ihren durchschnittlichen Bestellwert und Ihren Cashflow steigern.

Alle wiederkehrenden Preise, die nicht nutzungsabhängig sind, kommen für Abonnement-Upsells infrage. Sie können für jeden infrage kommenden Preis ein Abonnement-Upsell zu einem anderen Preis einrichten, der folgende Kriterien erfüllt:

- Preise müssen auf dasselbe [Produkt](https://docs.stripe.com/api/prices/object.md#price_object-product) verweisen.
- Preise müssen dieselbe [Währung](https://docs.stripe.com/api/prices/object.md#price_object-currency) haben.
- Preise müssen vom [Typ](https://docs.stripe.com/api/prices/object.md#price_object-type) `recurring` sein.
- Wenn Ihre Preise [Steuerverhalten](https://docs.stripe.com/api/prices/object.md#price_object-tax_behavior) verwenden, müssen deren Werte identisch sein.
- Wenn Ihr Preis [Stufen](https://docs.stripe.com/api/prices/object.md#price_object-tiers) verwendet, muss der Wert für `up_to` in jeder Stufe identisch sein.
- Beim Verwenden der [Mengenumwandlung](https://docs.stripe.com/api/prices/object.md#price_object-transform_quantity) müssen die Werte für `divide_by` und `round` identisch sein.

## Erstellen Sie Upselling von Abonnements

Konfigurieren Sie das Upselling für ein Abonnement im Dashboard auf der Seite „Preisdetails“. Um die Details zu einem Preis anzuzeigen, wählen Sie ein Produkt und einen mit diesem Produkt verknüpften Preis aus. Wählen Sie im Abschnitt **Upselling** einen Upselling-Preis aus dem Dropdown-Menü aus. Upselling gilt sofort für berechtigte Checkout-Sitzungen, bei denen dieser Preis verwendet wird.
![Auf der Preisdetailseite ein Upsell für ein Abonnement konfigurieren](https://b.stripecdn.com/docs-statics-srv/assets/add-upsell.08bc9bf9425295edb1ada9ff297ee257.gif)

Auf der Preisdetailseite ein Upsell für ein Abonnement konfigurieren.

## Bezahlvorgang

Während des Bezahlvorgangs wird den Kundinnen und Kunden eine Option zur Auswahl des Upsells, ggf. mit möglichen Einsparungen, angezeigt. Damit eine Checkout-Sitzung für Upsells infrage kommt, muss es:

- Sich um eine Checkout-Sitzung im Abonnementmodus handeln
- In der Checkout-Sitzung kann nur ein Preis den `type=recurring` haben
- Für den Upsell-Preis sollte eine gültige Konfiguration vorhanden sein

Stripe berechnet den Rabatt auf Grundlage des Betrags, den die/der Nutzer/in in einem Abrechnungszeitraum sparen würde, wenn sie/er den Upsell-Preis wählen würde. Ein monatliches Abonnement von 100&nbsp;USD, das mit Upsell zu einem Jahresabonnement von 1000&nbsp;USD würde, wird beispielsweise mit einem Rabatt von 200&nbsp;USD angezeigt. Rabatte werden als Betrag oder Prozentsatz angezeigt, je nach Zeichenlänge des Rabatts.

Nutzer/innen können zwischen der ursprünglichen Preisoption und der Upsell-Preisoption wählen und dann den Bezahlvorgang abschließen.
![Zwischen der ursprünglichen Preisoption und der Upsell-Preisoption wählen](https://b.stripecdn.com/docs-statics-srv/assets/upsell-preview.2a43c1a8acb9f167178b7fda6a2b0796.gif)

Kundenvorschau.

## Posten der Checkout-Sitzung abrufen

Nachdem eine Kundin/ein Kunde ein Upselling ausgewählt hat, werden die `line_items` für die Checkout-Sitzung aktualisiert, um den Upselling-Preis anzuzeigen. Wenn Ihre Bestellung mit dem Webhook `checkout.session.completed` [ausgeführt](https://docs.stripe.com/checkout/fulfillment.md#create-payment-event-handler) wird, müssen Sie die [Posten abrufen](https://docs.stripe.com/api/checkout/sessions/line_items.md).

## Ablauf Testversionen

Wählt eine Kundin/ein Kunde einen Upsell für eine Checkout Session mit verfügbarer Testversion, ändert sich der Testzeitraum nicht.

## Verhalten bei Gutscheinen

Wenn Sie einen Gutschein an das [Rabatt](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-discounts)-Array der Checkout-Sitzung übergeben, wird dieser Gutschein auch auf den Upselling-Preis angewendet, wenn ein Kunde/eine Kundin das Upselling auswählt. Wenn beispielsweise ein monatliches Abonnement ein Upselling auf ein Jahresabonnement durchführt und Sie einen 50&nbsp;%-Rabattgutschein mit einer Laufzeit von vier Monaten übergeben, gilt der Rabatt für alle Rechnungen im Zeitraum von vier Monaten, beginnend mit der erstmaligen Anwendung des Gutscheins. Wenn der Kunde/die Kundin das Upselling auswählt, gilt der 50&nbsp;%-Rabatt für das gesamte Jahresabonnement, da die Jahresrechnung während des Zeitraums von vier Monaten des Gutscheins erstellt wird.

## Ein Upsell für ein Abonnement entfernen

Sie können ein Upsell für ein Abonnement auf der Seite mit Preisangaben entfernen. Nachdem Sie ein Upsell für ein Abonnement entfernt haben, steht das Upsell für neue Checkout-Sitzungen nicht mehr zur Verfügung.
![Upselling entfernen](https://b.stripecdn.com/docs-statics-srv/assets/remove-upsell.36e5e59619f3c13f0aa94a3bd48bafdb.gif)

Ein Upsell entfernen.


# Eingebettete Seite

> This is a Eingebettete Seite for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/upsells?payment-ui=embedded-form.

Abonnement-Upsells bieten Kundinnen/Kunden die Möglichkeit, mit Checkout ein Upgrade auf einen Plan mit längerer Laufzeit vorzunehmen. Das Upselling von Kundinne/Kunden auf längere Abonnementintervalle (z. B. von monatlich auf jährlich) kann Ihren durchschnittlichen Bestellwert und Ihren Cashflow steigern.

Alle wiederkehrenden Preise, die nicht nutzungsabhängig sind, kommen für Abonnement-Upsells infrage. Sie können für jeden infrage kommenden Preis ein Abonnement-Upsell zu einem anderen Preis einrichten, der folgende Kriterien erfüllt:

- Preise müssen auf dasselbe [Produkt](https://docs.stripe.com/api/prices/object.md#price_object-product) verweisen.
- Preise müssen dieselbe [Währung](https://docs.stripe.com/api/prices/object.md#price_object-currency) haben.
- Preise müssen vom [Typ](https://docs.stripe.com/api/prices/object.md#price_object-type) `recurring` sein.
- Wenn Ihre Preise [Steuerverhalten](https://docs.stripe.com/api/prices/object.md#price_object-tax_behavior) verwenden, müssen deren Werte identisch sein.
- Wenn Ihr Preis [Stufen](https://docs.stripe.com/api/prices/object.md#price_object-tiers) verwendet, muss der Wert für `up_to` in jeder Stufe identisch sein.
- Beim Verwenden der [Mengenumwandlung](https://docs.stripe.com/api/prices/object.md#price_object-transform_quantity) müssen die Werte für `divide_by` und `round` identisch sein.

## Erstellen Sie Upselling von Abonnements

Konfigurieren Sie das Upselling für ein Abonnement im Dashboard auf der Seite „Preisdetails“. Um die Details zu einem Preis anzuzeigen, wählen Sie ein Produkt und einen mit diesem Produkt verknüpften Preis aus. Wählen Sie im Abschnitt **Upselling** einen Upselling-Preis aus dem Dropdown-Menü aus. Upselling gilt sofort für berechtigte Checkout-Sitzungen, bei denen dieser Preis verwendet wird.
![Auf der Preisdetailseite ein Upsell für ein Abonnement konfigurieren](https://b.stripecdn.com/docs-statics-srv/assets/add-upsell.08bc9bf9425295edb1ada9ff297ee257.gif)

Auf der Preisdetailseite ein Upsell für ein Abonnement konfigurieren.

## Bezahlvorgang

Während des Bezahlvorgangs wird den Kundinnen und Kunden eine Option zur Auswahl des Upsells, ggf. mit möglichen Einsparungen, angezeigt. Damit eine Checkout-Sitzung für Upsells infrage kommt, muss es:

- Sich um eine Checkout-Sitzung im Abonnementmodus handeln
- In der Checkout-Sitzung kann nur ein Preis den `type=recurring` haben
- Für den Upsell-Preis sollte eine gültige Konfiguration vorhanden sein

Stripe berechnet den Rabatt auf Grundlage des Betrags, den die/der Nutzer/in in einem Abrechnungszeitraum sparen würde, wenn sie/er den Upsell-Preis wählen würde. Ein monatliches Abonnement von 100&nbsp;USD, das mit Upsell zu einem Jahresabonnement von 1000&nbsp;USD würde, wird beispielsweise mit einem Rabatt von 200&nbsp;USD angezeigt. Rabatte werden als Betrag oder Prozentsatz angezeigt, je nach Zeichenlänge des Rabatts.

Nutzer/innen können zwischen der ursprünglichen Preisoption und der Upsell-Preisoption wählen und dann den Bezahlvorgang abschließen.
![Zwischen der ursprünglichen Preisoption und der Upsell-Preisoption wählen](https://b.stripecdn.com/docs-statics-srv/assets/upsell-preview.2a43c1a8acb9f167178b7fda6a2b0796.gif)

Kundenvorschau.

## Posten der Checkout-Sitzung abrufen

Nachdem eine Kundin/ein Kunde ein Upselling ausgewählt hat, werden die `line_items` für die Checkout-Sitzung aktualisiert, um den Upselling-Preis anzuzeigen. Wenn Ihre Bestellung mit dem Webhook `checkout.session.completed` [ausgeführt](https://docs.stripe.com/checkout/fulfillment.md#create-payment-event-handler) wird, müssen Sie die [Posten abrufen](https://docs.stripe.com/api/checkout/sessions/line_items.md).

## Ablauf Testversionen

Wählt eine Kundin/ein Kunde einen Upsell für eine Checkout Session mit verfügbarer Testversion, ändert sich der Testzeitraum nicht.

## Verhalten bei Gutscheinen

Wenn Sie einen Gutschein an das [Rabatt](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-discounts)-Array der Checkout-Sitzung übergeben, wird dieser Gutschein auch auf den Upselling-Preis angewendet, wenn ein Kunde/eine Kundin das Upselling auswählt. Wenn beispielsweise ein monatliches Abonnement ein Upselling auf ein Jahresabonnement durchführt und Sie einen 50&nbsp;%-Rabattgutschein mit einer Laufzeit von vier Monaten übergeben, gilt der Rabatt für alle Rechnungen im Zeitraum von vier Monaten, beginnend mit der erstmaligen Anwendung des Gutscheins. Wenn der Kunde/die Kundin das Upselling auswählt, gilt der 50&nbsp;%-Rabatt für das gesamte Jahresabonnement, da die Jahresrechnung während des Zeitraums von vier Monaten des Gutscheins erstellt wird.

## Ein Upsell für ein Abonnement entfernen

Sie können ein Upsell für ein Abonnement auf der Seite mit Preisangaben entfernen. Nachdem Sie ein Upsell für ein Abonnement entfernt haben, steht das Upsell für neue Checkout-Sitzungen nicht mehr zur Verfügung.
![Upselling entfernen](https://b.stripecdn.com/docs-statics-srv/assets/remove-upsell.36e5e59619f3c13f0aa94a3bd48bafdb.gif)

Ein Upsell entfernen.

