Abonnements unterbrechenPrivate Vorschau

Pausing a subscription lets you temporarily suspend both service delivery and invoice generation. The ability to pause a subscription helps you support customer scenarios such as vacations, temporary non‑usage, or goodwill pauses to prevent churn.

To use the Pause subscription endpoint, the subscription must use flexible billing mode.

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

• Zahlungseinzug unterbrechen: Bei Unterbrechung des Zahlungseinzugs werden weiterhin Rechnungen erstellt.
• Ende des kostenlosen Testzeitraums ohne Zahlungsmethode unterbrechen: Die Unterbrechung des Endes des Testzeitraums verhält sich eher wie eine echte Unterbrechung, 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

You can pause subscriptions with the Pause subscription endpoint. The pause takes effect immediately. After a subscription is paused:

• Der Status des Abos wird auf unterbrochen aktualisiert.
• Sie werden über die Webhooks customer.subscription.paused, customer.subscription.updated und 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 wird auf den Zeitpunkt aktualisiert, an dem Sie das Abo unterbrochen haben.
• You can use the bill_for parameter to control billing behavior at pause time, including creating credit prorations for unused licensed time and creating debits for metered usage in the current period. You can invoice immediately or create pending invoice items.

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

• Uses send_invoice collection
• Es verwendet den klassischen Abrechnungsmodus.
• Es befindet sich in einem Testzeitraum, es ist mit einem Testangebot verbunden oder es wurde gekündigt.
• Es ist mit einem Zeitplan verbunden.
• Es ist mit einem Rhythmus 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 https://api.stripe.com/v1/subscriptions/sub_1234567890/pause \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

You need to manually resume the subscription using the API. Resume is only available on subscriptions that use charge_automatically collection. If resuming doesn’t generate an invoice, the subscription status updates to active immediately. If resuming generates an invoice, Stripe finalizes the invoice immediately but doesn’t attempt payment in-request. You must attempt payment manually using the Pay invoice endpoint.

• If payment succeeds, the subscription status updates to active.
• If payment fails, the subscription status updates to past_due.
• If you don’t attempt payment within 23 hours, the invoice is voided and the subscription status stays paused.

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, customer.subscription.updated und 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 https://api.stripe.com/v1/subscriptions/sub_1234567890/resume \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.

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

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