# Abonnements unterbrechen

Erfahren Sie, wie Sie Abos unterbrechen und sowohl die Dienstleistungserbringung als auch das Erstellen von Rechnungen stoppen.

Mit dem Unterbrechen eines Abos können Sie sowohl die Erbringung von Leistungen als auch das Erstellen von Rechnungen vorübergehend aussetzen. Durch diese Möglichkeit, ein Abonnement zu pausieren, können Sie sich besser auf verschiedene Situationen einstellen, die sich auf Seiten der Kundschaft ergeben können. Dies ist nützlich, wenn die Kundin oder der Kunde in Urlaub fährt, die abonnierte Leistung für eine bestimmte Zeit nicht nutzen kann oder möchte, oder um Unterbrechungen aus Kulanzgründen zu gewähren, um Abwanderung zu verhindern.

Um den Pause subscription endpoint zu verwenden, muss das Abo den [flexiblen Abrechnungsmodus](https://docs.stripe.com/billing/subscriptions/billing-mode.md) verwenden.

Derzeit werden auch die folgenden ähnlichen Verhaltensweisen zum Pausieren für Abos unterstützt:

- [Zahlungseinzug pausieren](https://docs.stripe.com/billing/subscriptions/pause-payment.md): Die Bereitstellung von Dienstleistungen und die Rechnungserstellung werden fortgesetzt, jedoch wird der Einzug von Rechnungen vorübergehend ausgesetzt.
- [Pause nach Ablauf des kostenlosen Testzeitraums ohne Zahlungsmethode](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#create-free-trials-without-payment): Die Pause nach Ablauf des Testzeitraums verhält sich eher wie eine echte Pause, gilt aber nur für ein bestimmtes, systembedingtes Szenario.

Die Möglichkeit, Abos zu unterbrechen, ist für folgende Personen hilfreich:

- Händlerteams, die API-Kontrolle über den Lebenszyklus von Abos wünschen, ohne Abos zu kündigen.
- Backend-Entwickler/innen, die Kundenbindungsabläufe entwickeln oder Tools unterstützen, die einen echten Pausenzustand benötigen.
- Entwickler/innen, die Rechnungsstellung, Berechtigungswiderruf und Webhook-Handhabung für unterbrochene Zeitfenster validieren.

## Abonnements unterbrechen

Sie können Abonnements mit dem Endpoint „Abonnement unterbrechen“ pausieren. Die Unterbrechung wird sofort wirksam. Nachdem ein Abo unterbrochen wurde:

- Der Status des Abos wird auf `unterbrochen` aktualisiert.
- Sie werden über die Webhooks [customer.subscription.paused](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.paused), [customer.subscription.updated](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.updated) und [entitlements.active_entitlement_summary.updated](https://docs.stripe.com/api/events/types.md#event_types-entitlements.active_entitlement_summary.updated) über die Statusänderung benachrichtigt, damit Sie die Bereitstellung der Dienstleistung entsprechend einstellen können.
- Das Erstellen von Rechnungen wird für die gesamte Dauer der Pause unterbrochen. Bestehende Aborechnungen werden jedoch ohne Auswirkungen auf den Pausenstatus weiterhin verarbeitet.
- Das [current_period_end](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-items-data-current_period_end) wird auf den Zeitpunkt aktualisiert, an dem Sie das Abo unterbrochen haben.
- Mit dem Parameter `bill_for`können Sie das Abrechnungsverhalten zum Zeitpunkt der Unterbrechung steuern, einschließlich der Erstellung von Gutschriften mit anteilmäßiger Verrechnung für nicht genutzte Lizenzzeiten und der Erstellung von Lastschriften für die gemessene Nutzung im aktuellen Zeitraum. Sie können sofort eine Rechnung erstellen oder ausstehende Rechnungsposten anlegen.

In folgenden Fällen können Sie ein Abo nicht unterbrechen:

- Verwendet die Einzugsmethode [send_invoice](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-collection_method)
- Es verwendet den [klassischen](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_mode-type) Abrechnungsmodus.
- Es befindet sich in einem Testzeitraum, es ist mit einem Testangebot verbunden oder es wurde gekündigt.
- Es ist mit einem [Zeitplan](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md) verbunden.
- Es ist mit einem [Rhythmus](https://docs.stripe.com/api/v2/billing-cadences.md?api-version=preview) verbunden.

Ebenso können Sie einem unterbrochen Abo keinen Zeitplan oder Rhythmus hinzufügen.

Wenn Sie ein Abo unterbrechen, das einen Gutschein verwendet, behält der Gutschein seine ursprüngliche Gültigkeit. Die Unterbrechung verlängert seine Gültigkeit also nicht.

Dieses Beispiel zeigt, wie Sie mit der API ein aktives Abo sofort unterbrechen können:

```curl
curl https://api.stripe.com/v1/subscriptions/sub_1234567890/pause \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: preview" \
  -d type=subscription \
  -d "bill_for[unused_time_from][type]=now" \
  -d "bill_for[outstanding_usage_through][type]=now" \
  -d invoicing_behavior=pending_invoice_item
```

Das Kundenportal zeigt an, dass ein Abo unterbrochen wurde, Ihre Abonnentinnen und Abonnenten können es jedoch nicht verwenden, um Abos selbst zu unterbrechen.

## Abos wiederaufnehmen

Sie müssen das Abo manuell über die [API](https://docs.stripe.com/api/subscriptions/resume.md?api-version=preview) wiederaufnehmen. Die Wiederaufnahme ist nur für Abonnements verfügbar, die die Einzugsmethode [charge_automatically](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-collection_method) verwenden. Wenn die Wiederaufnahme keine Rechnung generiert, wird der Status des Abos sofort auf `aktiv` aktualisiert. Wenn die Wiederaufnahme eine Rechnung generiert, finalisiert Stripe die Rechnung sofort, versucht aber keine Zahlung auf Anfrage. Sie müssen versuchen, die Zahlung manuell über den [Endpoint „Rechnung bezahlen“](https://docs.stripe.com/api/invoices/pay.md) durchzuführen.

- Bei erfolgreicher Zahlung ändert sich der Status des Abos auf `aktiv`.
- Schlägt die Zahlung fehl, wird der Status des Abos auf `past_due` aktualisiert.
- Wenn Sie nicht innerhalb von 23 Stunden eine Zahlung versuchen, wird die Rechnung nichtig und der Status des Abos bleibt `unterbrochen`.

Nachdem der Status eines Abos auf `aktiv` geändert wurde, passiert Folgendes:

- Die Rechnungsstellung wird fortgesetzt.
- Optional wird der Abrechnungszyklusanker zurückgesetzt.
- Sie werden über die Webhooks [customer.subscription.resumed](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.resumed), [customer.subscription.updated](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.updated) und [entitlements.active_entitlement_summary.updated](https://docs.stripe.com/api/events/types.md#event_types-entitlements.active_entitlement_summary.updated) über die Statusänderung benachrichtigt, damit Sie die Bereitstellung der Dienstleistung entsprechend wiederaufnehmen können.

Dieses Beispiel zeigt, wie Sie mit der API ein unterbrochenes Abo sofort wiederaufnehmen können:

```curl
curl https://api.stripe.com/v1/subscriptions/sub_1234567890/resume \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: preview" \
  -d billing_cycle_anchor=unchanged \
  -d proration_behavior=create_prorations
```

## Unterbrechungs- und Wiederaufnahmeereignisse erkennen

Stripe sendet die folgenden Ereignisse für unterbrochene und wiederaufgenommene Abos.

| Ereignis                                                                                                                                                                       | Beschreibung                                                                                       |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| [customer.subscription.paused](https://docs.stripe.com/api/events/types.md?api-version=preview#event_types-customer.subscription.paused)                                       | Wird ausgegeben, wenn ein Abo unterbrochen wird.                                                   |
| [customer.subscription.resumed](https://docs.stripe.com/api/events/types.md?api-version=preview#event_types-customer.subscription.resumed)                                     | Wird ausgegeben, wenn ein Abo wiederaufgenommen wird.                                              |
| [customer.subscription.updated](https://docs.stripe.com/api/events/types.md?api-version=preview#event_types-customer.subscription.updated)                                     | Wird ausgegeben, wenn ein Abo unterbrochen oder wiederaufgenommen wird.                            |
| [entitlements.active_entitlement_summary.updated](https://docs.stripe.com/api/events/types.md?api-version=preview#event_types-entitlements.active_entitlement_summary.updated) | Wird ausgegeben, wenn sich Berechtigungen aufgrund einer Unterbrechung oder Wiederaufnahme ändern. |

Beispielhafte Webhook-Nutzlast für `customer.subscription.paused` (entscheidende Felder abgebildet):

```json
{
  "id": "evt_1SrpXjRnJ89Z4rKkFxe9waAz",
  "object": "event",
  ...
  "data": {
    "object": {
      "id": "sub_1SrpWtRnJ89Z4rKknfSwXkBc",
      "object": "subscription",
      ...
      "latest_invoice": "in_1SrpWtRnJ89Z4rKkzYBCF1MY",
      ...
      "status": "paused",
      ...
    }
  },
  ...
  "type": "customer.subscription.paused"
}
```