# Konfigurieren Sie Testangebote für Abos

Bieten Sie kostenlose oder kostenpflichtige Testzeiträume für Artikel in einem Abo an.
![](https://b.stripecdn.com/docs-statics-srv/assets/trial-offer.2128af954f90482fce40e29d1604a01b.png)

Mit der [Trial Offer](https://docs.stripe.com/api/product-catalog/trial-offer.md?api-version=2026-03-25.preview) API lassen sich sowohl kostenlose als auch kostenpflichtige Einführungszeiträume für Ihre [Abonnements](https://docs.stripe.com/subscriptions.md) mit einer einzigen API-Integration verwalten. Mithilfe von Testangeboten können Sie Leads mit hoher Kaufabsicht qualifizieren, den Missbrauch von Testversionen reduzieren und Ihren Kundinnen und Kunden für eine begrenzte Dauer ermäßigte Tarife anbieten (zum Beispiel 1 USD für die erste Woche eines Angebots).

## Use Cases

Mit Testangeboten können Sie Tests zu Aktionspreisen und Produktangeboten direkt in Stripe durchführen. Häufige Anwendungsszenarien für Testangebote sind:

| Use Case                            | Beschreibung                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Ermäßigte Testzeiträume**         | Um die Konversionsrate von Testzeiträumen zu kostenpflichtigen Abonnements zu verbessern und Umsatz zu generieren, können Sie vergünstigte Testzeiträume einrichten. Sie können beispielsweise einen reduzierten Einführungspreis von 4 USD für 4&nbsp;Wochen oder einen kostenlosen 7-Tage-Testzeitraum anbieten.                                                                   |
| **Kostenlose Testzeiträume**        | Um ein kostenloses Testabonnement anzubieten, fügen Sie dem Abo einen Posten mit 0 USD hinzu.                                                                                                                                                                                                                                                                                        |
| **Aktualisieren Sie Testzeiträume** | Um mehr Premium-Funktionen zu verkaufen, können Sie Upgrade-Testzeiträume konfigurieren. Beispielsweise bieten Sie einer Kundin oder einem Kunden mit einem Basisplan einen 7-tägigen Testzeitraum an, in dem sie/er zu einem Basispreis auf Premium-Funktionen zugreifen kann. Nach Ablauf des Testzeitraums wird das Abonnement dann automatisch auf den Premium-Preis umgestellt. |
| **Testzeiträume auf Postenebene**   | Um Add-ons, KI-Pakete und andere Funktions-Bundles zu verkaufen, können Sie Testzeiträume auf Postenebene einrichten. Sie können Kunden/Kundinnen einen Testzeitraum für nur einen Posten in einem Abonnement anbieten, während Sie andere Posten zum regulären Preis in Rechnung stellen.                                                                                           |

## Before you begin

- Ihre Integration muss auf der Version [2026-03-25.preview](https://docs.stripe.com/changelog.md?channel=preview#2026-03-25.preview) ausgeführt werden. Sie müssen diese [Stripe-Version](https://docs.stripe.com/api/versioning.md) in Ihrem Anfrage-Header angeben, um auf die Vorschaufunktionen zugreifen zu können.
- Um einen Testzeitraum nutzen zu können, müssen Sie Ihr Abonnement vom `classic` [Abrechnungsmodus](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-billing_mode) auf den [flexiblen Abrechnungsmodus](https://docs.stripe.com/billing/subscriptions/billing-mode.md) umstellen.

### Einschränkungen

- Testangebote gelten nur für wiederkehrende Abonnementposten. Nicht wiederkehrende Posten kommen für kostenpflichtige Testversionen oder vergünstigte Testpreise nicht infrage.
- Das Dashboard und das Kundenportal werden während der öffentlichen Vorschau nur eingeschränkt unterstützt. Sie können sowohl das Dashboard als auch das Kundenportal verwenden, um Testangebote anzuzeigen, die über die API erstellt wurden. Zum Erstellen, Verwalten oder Ändern von Testangebotsposten können Sie sie jedoch nicht verwenden.
- Die Dauer des Testzeitraums kann nach dem Erstellen des Abonnements nicht mehr geändert werden. Sie können auch keine Verlängerungen oder Verkürzungen planen.
- Einschränkungen der [Trial Offer API](https://docs.stripe.com/api/product-catalog/trial-offer.md?api-version=2026-03-25.preview) und des Parameters [trial_end](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-trial_end):
  - Sie können Testangebote und den älteren Parameter `trial_end` nicht zusammen verwenden. Wir empfehlen die Verwendung der Trial Offer API, um ermäßigte und kostenlose Testzeiträume zu konfigurieren.
  - Wenn Sie [Checkout](https://docs.stripe.com/payments/checkout.md) verwenden, können Sie keine Testangebote verwenden. Um Testabonnements über Checkout zu erstellen, müssen Sie kostenlose -Legacy-Testzeiträume mit `trial_end` nutzen. Siehe [Kostenlose Testzeiträume konfigurieren](https://docs.stripe.com/payments/checkout/free-trials.md).

## Funktionsweise von Testangeboten

*Produkte* (Products represent what your business sells—whether that's a good or a service) beschreiben die spezifischen Waren oder Dienstleistungen, die Sie Ihren Kundinnen und Kunden anbieten und *Preise* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions) legen die Einzelkosten fest. Bei einem Abonnement werden den Kundinnen und Kunden diese Produkte regelmäßig zum angegebenen Preis in Rechnung gestellt. Wenn Sie ein Testangebot erstellen, legen Sie einen Testpreis und die Dauer des Testzeitraums für ein Produkt fest. Nach Ablauf des Testzeitraums wird das Abonnement automatisch auf den regulären Preis oder einen anderen Preis umgestellt.

Testangebote ersetzen keine [Produkte oder Preise](https://docs.stripe.com/products-prices/how-products-and-prices-work.md). `Trial Offer` ist ein separates Objekt, das einem [Abonnementposten](https://docs.stripe.com/api/subscription_items.md) für eine begrenzte Zeit einen ermäßigten oder kostenlosen Preis zuordnet, ohne den zugrunde liegenden [Preis](https://docs.stripe.com/api/subscription_items/object.md?#subscription_item_object-price) des Postens zu ändern.

## Testangebot erstellen

Um [ein Testangebot zu erstellen](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-03-25.preview), übergeben Sie einen [Preis](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-03-25.preview#create_product_catalog_trial_offer-price) mit der [price.id](https://docs.stripe.com/api/prices/object.md#price_object-id), um die Kosten während des Testzeitraums zu definieren. Sie können dies auf 0 USD für kostenlose Testzeiträume oder einen beliebigen positiven Betrag für kostenpflichtige Testzeiträume festlegen. Richten Sie als Nächstes den [Typ](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-03-25.preview#create_product_catalog_trial_offer-duration-type) des Testzeitraums ein. Sie können `relative` (basierend auf den Abrechnungsintervallen) oder `timestamp` (basierend auf einem absoluten Datums) festlegen. Verwenden Sie für die relative Dauer [Iterationen](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-duration-relative-iterations), um die Anzahl der Abrechnungsintervalle zu definieren. Legen Sie dann mithilfe des Parameters [end_behavior](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-03-25.preview#create_product_catalog_trial_offer-end_behavior) fest, was passiert, wenn der Testzeitraum endet. Mithilfe von `transition` geben Sie die [price.id](https://docs.stripe.com/api/prices/object.md#price_object-id) an, zu der das Abonnement am Ende des Testzeitraums wechselt.

### Testangebot mit relativer Laufzeit erstellen

```curl
curl https://api.stripe.com/v1/product_catalog/trial_offers \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "price={{PRICE_ID}}" \
  -d "duration[relative][iterations]=1" \
  -d "duration[type]=relative" \
  -d "end_behavior[transition][price]={{PRICE_ID}}"
```

### Testangebot mit Zeitstempeldauer erstellen

```curl
curl https://api.stripe.com/v1/product_catalog/trial_offers \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "price={{PRICE_ID}}" \
  -d "duration[type]=timestamp" \
  -d "end_behavior[transition][price]={{PRICE_ID}}"
```

## Testangebot an ein neues Abonnement anhängen

Um ein Testangebot an ein [Abonnement](https://docs.stripe.com/api/subscriptions/object.md) anzufügen, geben Sie die [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-id) im Parameter [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) an:

#### Accounts&nbsp;v2

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d "billing_mode[type]=flexible" \
  -d "items[0][current_trial][trial_offer]=to_123" \
  -d "items[0][quantity]=1"
```

#### Customer&nbsp;v1

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "customer={{CUSTOMER_ID}}" \
  -d "billing_mode[type]=flexible" \
  -d "items[0][current_trial][trial_offer]=to_123" \
  -d "items[0][quantity]=1"
```

## Abonnements mit einem Testangebot aktualisieren

### Testangebot zu einem bestehenden Abonnement hinzufügen

Um ein Testangebot einem bestehenden Abonnement hinzuzufügen, geben Sie die [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-id) im Parameter [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) an:

```curl
curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "items[0][current_trial][trial_offer]=to_123"
```

### Testangebot zu einem Abonnement mit bestehenden Posten hinzufügen

Um ein Testangebot als weiteren Posten an ein Abonnement anzufügen, das über vorhandene Posten verfügt, fügen Sie dem [Posten](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items)-Array einen Posten hinzu und geben Sie die [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-id) im Parameter [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) an:

```curl
curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \
  -d "items[1][current_trial][trial_offer]=to_123" \
  -d "items[1][quantity]=1"
```

### Abonnementposten in ein Testangebot umwandeln

Um einen bestehenden Posten eines Abonnements in ein Testangebot umzuwandeln, fügen Sie die [items.id](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-id) ein und geben Sie die [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-id) im Parameter [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) an:

```curl
curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \
  -d "items[0][current_trial][trial_offer]=to_123"
```

### Postenmenge für ein Testangebot ändern

Um die [Menge](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-quantity) der Posten für ein Testangebot zu ändern, aktualisieren Sie das Abonnement:

```curl
curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \
  -d "items[0][quantity]=2"
```

## Testangebot zu einem Abonnementplan hinzufügen

Sie können Zeitstempel-Testangebote nur mit [Abonnementplänen](https://docs.stripe.com/api/subscription_schedules.md) verwenden. Im Gegensatz zu Testzeiträumen mit relativer Dauer, die nach einer bestimmten Anzahl von Abrechnungsintervallen enden, ist das Ende bei Zeitstempel-Testzeiträumen ein absolutes Datum. Um eines zu erstellen, setzen Sie den [duration.type](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-duration-type) des Testangebots auf `timestamp`:

```curl
curl https://api.stripe.com/v1/product_catalog/trial_offers \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "price={{PRICE_ID}}" \
  -d "duration[type]=timestamp" \
  -d "end_behavior[transition][price]={{PRICE_ID}}"
```

Verwenden Sie als Nächstes [phases.items.trial_offer](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2026-03-25.preview#create_subscription_schedule-phases-items-trial_offer), um das Testangebot der [Planphase](https://docs.stripe.com/api/subscription_schedules/create.md?#create_subscription_schedule-phases) des Abonnementplans zuzuordnen:

#### Accounts&nbsp;v2

```curl
curl https://api.stripe.com/v1/subscription_schedules \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d start_date=1610403705 \
  -d "phases[0][items][0][trial_offer]=to_123" \
  -d "phases[0][end_date]=1610403706"
```

#### Customer&nbsp;v1

```curl
curl https://api.stripe.com/v1/subscription_schedules \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "customer={{CUSTOMER_ID}}" \
  -d start_date=1610403705 \
  -d "phases[0][items][0][trial_offer]=to_123" \
  -d "phases[0][end_date]=1610403706"
```

## Abos mit Testangeboten anzeigen

Wenn Sie [ein Abo abrufen](https://docs.stripe.com/api/subscriptions/retrieve.md), enthält die Antwort die Konfiguration für jeden Posten, einschließlich Testangebote:

```curl
curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview"
```

## Abo am Ende eines kostenpflichtigen Testzeitraums kündigen

Um das Abonnement nach Ablauf des kostenpflichtigen Testzeitraums zu kündigen, erstellen Sie ein Abonnement mit einem Testangebot und legen Sie den Parameter [cancel_at](https://docs.stripe.com/api/subscriptions/update.md?#update_subscription-cancel_at) auf das Ende des Testzeitraums fest.

Dieses Muster unterstützt Opt-in-Verlängerungen, indem sichergestellt wird, dass Kundinnen und Kunden nicht standardmäßig in ein wiederkehrendes Abo umgewandelt werden.

#### Accounts&nbsp;v2

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d "items[0][current_trial][trial_offer]=to_123" \
  -d "items[0][quantity]=1" \
  -d cancel_at=1610403706
```

#### Customer&nbsp;v1

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "customer={{CUSTOMER_ID}}" \
  -d "items[0][current_trial][trial_offer]=to_123" \
  -d "items[0][quantity]=1" \
  -d cancel_at=1610403706
```

## Testangebote mit anderen Funktionen nutzen

### Testangebote mit nutzungsbasierter Abrechnung

Beim Erstellen eines [Preisobjekts](https://docs.stripe.com/api/prices/object.md) können Sie anstelle eines wiederkehrenden Preises einen nutzungsbasierten Preis angeben und ihn einem Testangebot zuordnen. So können Sie dieselbe [nutzungsbasierte Abrechnung](https://docs.stripe.com/billing/subscriptions/usage-based.md) zu einem ermäßigten Preis anbieten.

Um einen nutzungsbasierten Preis zu verwenden, legen Sie den [usage_type](https://docs.stripe.com/api/prices/object.md?#price_object-recurring-usage_type) auf `metered` fest und fügen Sie einen vorhandenen [Zähler](https://docs.stripe.com/api/prices/object.md?#price_object-recurring-meter) hinzu, um die Nutzung zu erfassen.

```curl
curl https://api.stripe.com/v1/prices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d currency=usd \
  -d billing_scheme=per_unit \
  -d unit_amount=1 \
  -d "recurring[interval]=week" \
  -d "recurring[usage_type]=metered" \
  -d "recurring[meter]=mtr_123" \
  -d "product_data[name]=Trial Period Price"
```

Hängen Sie als Nächstes den Preis an ein Testangebot an&nbsp;– wie bei jedem anderen wiederkehrenden Preis auch:

```curl
curl https://api.stripe.com/v1/product_catalog/trial_offers \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "price={{PRICE_ID}}" \
  -d "duration[relative][iterations]=1" \
  -d "duration[type]=timestamp" \
  -d "end_behavior[transition][price]={{PRICE_ID}}"
```

## Weitere Überlegungen

### Status und Testangebot des Abos

Bei der Nutzung von Testangeboten wird der `status` eines Abonnements durch den Testpreis bestimmt:

- **Kostenlose Testzeiträume (0 USD)**: Wenn ein Abonnement nur Testangebote enthält und alle Preise für Testangebote auf 0 USD festgelegt sind, lautet der Status des Abonnements `trialing`. Dies entspricht dem Legacy-Verhalten von `trial_end` und ist ideal für kostenlose Testversionen mit Abrechnung ohne Karte oder standardmäßige kostenlose Testabläufe.
- **Bezahlte Testversionen (>)**: Wenn das Abonnement einen regulären Posten hat oder die Testangebote einen Preis ungleich Null haben, ist der Status des Abos `active`, `incomplete` oder `past_due`. Dieses Verhalten imitiert andere Abonnements ohne Testangebote. Da für einen kostenpflichtigen Testzeitraum eine sofortige erfolgreiche Zahlung erforderlich ist, folgt das Abonnement dem Standard-Lifecycle `PaymentIntent`. Dadurch wird sichergestellt, dass Ihre bestehende Abrechnungslogik&nbsp;– etwa Webhooks für erfolgreiche Zahlungen&nbsp;– konsistent bleibt, unabhängig davon, ob der Kunde/die Kundin einen Aktionspreis oder den vollständigen wiederkehrenden Betrag zahlt.

### Ereignisse

Jedes Mal, wenn sich ein Testzeitraum ändert, werden [Ereignisse](https://docs.stripe.com/api.md#event_types) ausgelöst. Stellen Sie sicher, dass Ihre Integration diese verarbeitet. Eventuell möchten Sie beispielsweise vor Ablauf eines Testzeitraums eine E-Mail an eine Kundin oder einen Kunden senden. Weitere Informationen zum [Umgang mit Abonnementereignissen](https://docs.stripe.com/billing/subscriptions/webhooks.md#events).

In der folgenden Tabelle werden die Ereignisse beschrieben, die ausgelöst werden, bevor ein kostenloser Testzeitraum abläuft, wenn ein Testabonnement unterbrochen oder gekündigt wird sowie wenn ein Abonnement wiederaufgenommen und aktiviert wird.

| Ereignis                               | Beschreibung                                                                                                                                                                                                                                                                                                                         | Use Case                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `customer.subscription.deleted`        | Wird gesendet, wenn ein Abonnement endet.                                                                                                                                                                                                                                                                                            | Verweigern Sie als Reaktion auf dieses Ereignis den Zugriff auf Ihr Produkt. Wenn ein kostenloser Testzeitraum ohne Angabe einer Zahlungsmethode endet und das Endverhalten `missing_payment_method` des Abonnements auf `cancel` festgelegt ist, so geht das Abonnement in den Status `canceled` über und versendet dieses Ereignis.                                                                                       |
| `customer.subscription.resumed`        | Wird gesendet, wenn ein Abonnement nicht mehr unterbrochen ist. Wenn Sie dieses Ereignis empfangen, gewähren Sie dem Kunden/der Kundin Zugriff auf das Produkt, wenn dieser widerrufen wurde, während das Abonnement pausiert war.                                                                                                   | Unterbrochene Abonnements werden nach der Wiederaufnahme in aktive Abonnements umgewandelt. Die Wiederaufnahme eines Abonnements kann eine Rechnung und einen entsprechenden Payment Intent generieren, die bezahlt werden müssen, bevor das Abonnement den Status `paused` verlässt.                                                                                                                                       |
| `customer.subscription.paused`         | Wird gesendet, wenn ein Abonnement vollständig ausgesetzt wurde. Die Invoicing erfolgt erst, wenn das Abonnement wieder aufgenommen wird. Wenn Sie dieses Ereignis erhalten, können Sie den Zugriff des/der Kund/in auf das Produkt widerrufen, bis er/sie eine Zahlungsmethode hinzufügt und das Abonnement wiederaufgenommen wird. | Verweigern Sie als Reaktion auf dieses Ereignis den Zugriff auf Ihr Produkt. Wenn ein kostenloser Testzeitraum ohne Angabe einer Zahlungsmethode endet und das Endverhalten `missing_payment_method` des Abonnements auf `pause` festgelegt ist, so geht das Abonnement in den Status `paused` über und versendet dieses Ereignis. Das Abonnement verbleibt im Status `paused`, bis es ausdrücklich wiederaufgenommen wird. |
| `customer.subscription.trial_will_end` | Wird 3&nbsp;Tage vor Ablauf des Testzeitraums gesendet. Wenn der Testzeitraum weniger als 3&nbsp;Tage beträgt, wird dieses Ereignis sofort ausgelöst.                                                                                                                                                                                | Konfigurieren Sie das Abonnement so, dass Ihre Kund/innen 3 Tage vor Ablauf des Testzeitraums automatisch per E-Mail an dessen Ende erinnert werden.                                                                                                                                                                                                                                                                        |

### Abrechnungsanker festlegen, wenn ein Testangebot endet

Wenn ein Testangebot endet und zum regulären wiederkehrenden Preis wechselt, müssen Kundinnen und Kunden sofort einen neuen Abrechnungszyklus starten. Standardmäßig wird der [billing_cycle_anchor](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-trial_settings-end_behavior-billing_cycle_anchor) des Abonnements automatisch auf den Zeitpunkt zurückgesetzt, an dem der Testzeitraum (jetzt) endet. Dadurch wird sichergestellt, dass Ihren Kundinnen und Kunden sofort der volle Betrag für ihr erstes reguläres Intervall in Rechnung gestellt wird, ohne dass anteilige Verrechnungen generiert werden.

Wenn Sie nicht möchten, dass sich Ihr `billing_cycle_anchor` ändert, können Sie ihn auf `unchanged` festlegen.

Konfigurationsoptionen für `billing_cycle_anchor` sind:

- `now` (Standard): Setzt den `billing_cycle_anchor` des Abonnements auf genau den Zeitpunkt zurück, zu dem das Testangebot abgeschlossen ist. Dadurch wird ein neuer Abrechnungszyklus für den regulären Preis erstellt und eine Rechnung mit vollem Betrag ohne anteilmäßige Verrechnung generiert.
- `unchanged`: Behält den ursprünglichen Anker von dem Zeitpunkt bei, zu dem das Abonnement erstellt wurde. Der Zeitraum zwischen dem Ende des Testzeitraums und dem nächsten natürlichen Ankerdatum wird als anteiliger Betrag in Rechnung gestellt.

Wenn Sie beispielsweise einen 7-tägigen Testzeitraum für 1 USD anbieten und möchten, dass die erste monatliche Zahlung von 20 USD ab Tag&nbsp;8 einen ganzen Monat abdeckt:

1. Januar&nbsp;1: Abonnement mit 7-tägigem Testangebot erstellt.
1. Januar&nbsp;8: Der Testzeitraum endet. Der `billing_cycle_anchor` wird automatisch auf den 8.&nbsp;Januar zurückgesetzt.
1. Rechnung: Stripe generiert eine Rechnung über den vollen wiederkehrenden Preis von 20 USD für den Zeitraum vom 8.&nbsp;Januar bis zum 8.&nbsp;Februar. Es wird keine anteilmäßige Verrechnung angewendet.

#### Accounts&nbsp;v2

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d "items[0][price]={{PRICE_ID}}" \
  -d "items[0][current_trial][trial_offer]={{TRIAL_OFFER_ID}}" \
  -d "trial_settings[end_behavior][billing_cycle_anchor]=unchanged"
```

#### Customer&nbsp;v1

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview" \
  -d "customer={{CUSTOMER_ID}}" \
  -d "items[0][price]={{PRICE_ID}}" \
  -d "items[0][current_trial][trial_offer]={{TRIAL_OFFER_ID}}" \
  -d "trial_settings[end_behavior][billing_cycle_anchor]=unchanged"
```

## See also

- [Produkte und Preise](https://docs.stripe.com/products-prices/overview.md)
- [Preise](https://docs.stripe.com/api.md#prices)
- [Abos](https://docs.stripe.com/api.md#subscriptions)
- [Verwalten von Abo-Rechnungsstellungszeiträumen](https://docs.stripe.com/billing/subscriptions/billing-cycle.md)
