Zahlungseinzug unterbrechen

Das Aussetzen des Zahlungseinzugs wird häufig genutzt, um Ihre Dienste vorübergehend kostenlos anzubieten. Dies wird manchmal als „Kulanzfrist” bezeichnet, wenn eine Kundin/ein Kunde zusätzliche Zeit zum Bezahlen benötigt oder für einen oder mehrere Rechnungsstellungszeiträume nicht zahlen kann.

Abonnements können Sie über das Stripe-Dashboard oder die API unterbrechen und wiederaufnehmen. Wenn der Einzug pausiert ist, generieren Abonnements weiterhin Rechnungen, Sie haben jedoch mehrere Möglichkeiten, diese Rechnungen zu bearbeiten. Überprüfen Sie die folgenden Anwendungsfälle, um die für Sie am besten geeignete Option zu bestimmen:

Wenn diese Optionen nicht zu Ihren Anwendungsszenarien passen, können Sie Abonnements stattdessen kündigen.

Zahlungen für Rechnungen, die vor der Abonnementunterbrechung erstellt wurden, werden nach der Wiederaufnahme erneut eingezogen, wenn Sie die Rechnung nicht stornieren.

Dienste vorübergehend kostenlos anbieten und die Zahlung niemals einziehen

Wenn Sie Ihre Dienste vorübergehend kostenlos anbieten und mit der Rechnung keine Zahlung einziehen möchten (zum Beispiel wegen einer „Kulanzfrist“), können Sie Abonnementrechnungen stornieren. So stellen Sie sicher, dass Ihren Kundinnen/Kunden keine Gebühren in Rechnung gestellt werden und das Abonnement im status=active verbleibt. Ändern Sie anhand der Abonnement-ID pause_collection[behavior] in void und legen Sie unter pause_collection[resumes_at] das Datum fest, ab dem Sie die Zahlungen wieder einziehen möchten.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pause_collection[behavior]"=void

Alle Rechnungen, die vor dem Datum unter resumes_at erstellt wurden, werden sofort als uneinbringlich markiert. Stripe sendet keine E-Mails zu anstehenden Rechnungen oder Webhooks und der Status des Abonnements bleibt unverändert.

Wenn Sie kein Datum unter resumes_at festlegen, bleibt das Abonnement unterbrochen, bis Sie pause_collection aufheben.

Dienste vorübergehend kostenlos anbieten und den Zahlungseinzug später vornehmen

Wenn Sie Ihre Dienste vorübergehend kostenlos anbieten und den Zahlungseinzug später vornehmen möchten, legen Sie pause_collection[behavior]=keep_as_draft fest. Wenn Sie bereits wissen, wann Sie den Einzug wiederaufnehmen werden, übergeben Sie einen Zeitstempel für resumes_at.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pause_collection[behavior]"=keep_as_draft

Alle Rechnungen, die vor dem Datum unter resumes_at erstellt wurden, verbleiben im Status draft und auto_advance wird auf false gesetzt. Stripe sendet keine E-Mails zu anstehenden Rechnungen oder Webhooks für diese Rechnungen und der Status des Abonnements bleibt unverändert.

Wenn Sie kein Datum unter resumes_at festlegen, bleibt das Abonnement unterbrochen, bis Sie pause_collection aufheben.

Wenn Sie schließlich die Zahlung für diese Rechnungen einziehen möchten, setzen Sie auto_advance wieder auf true. Wenn Sie die Rechnungs-IDs nicht haben, können Sie Abonnement-IDs verwenden, um nach Rechnungen im status=draft zu suchen. Anhand der Rechnungs-ID können Sie dann auto_advance=true ändern:

curl https://api.stripe.com/v1/invoices/
{{INVOICE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d auto_advance=true

Dienste vorübergehend kostenlos anbieten und Rechnungen als uneinbringlich markieren

Wenn Sie Ihre Dienste vorübergehend kostenlos anbieten und alle über das Abonnement generierten Rechnungen als uneinbringlich markieren möchten, verwenden Sie die Abonnement-ID, um pause_collection[behavior] in mark_uncollectible zu ändern und optional pause_collection[resumes_at] auf das Datum festzulegen, ab dem Sie die Zahlungen wieder einziehen möchten. Dies stellt sicher, dass alle nachgelagerten Berichte korrekt sind, das Kundenkonto nicht belastet wird und das Abonnement im status=active bleibt.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pause_collection[behavior]"=mark_uncollectible

Wenn Sie pause_collection[behavior] auf mark_uncollectible festlegen, stoppen wir den aktiven Zahlungseinzug für neue Rechnungen, die das Abonnement vor dem resumes_at-Datum erstellt hat. Stripe sendet keine E-Mails zu anstehenden Rechnungen oder Webhooks für diese Rechnungen.

Trotz dieser Pause wendet Stripe jegliches vorhandene Kundenguthaben auf Rechnungen an. Dadurch können die verfügbaren Gelder verwendet werden, bevor wir eine Rechnung als uncollectible markieren. Wenn die total der Rechnung vollständig mit dem Kundenguthaben beglichen wird, wird der Status der Rechnung auf paid gesetzt. Andernfalls wird der Status der Rechnung auf uncollectible gesetzt.

Wenn Sie kein resumes_at-Datum festlegen, bleibt der Zahlungseinzug für das Abonnement angehalten, bis Sie pause_collectiondeaktivieren.

Manuelles Unterbrechen

Um den Zahlungseinzug wiederaufzunehmen, können Sie das Abonnement aktualisieren und pause_collection zurücksetzen:

curl https://api.stripe.com/v1/subscriptions/sub_GTbTiykEwMRog0 \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "pause_collection"=

Die Wiederaufnahme des Zahlungseinzugs wirkt sich nur auf zukünftige Rechnungen aus.

Abonnementpläne unterbrechen

If you pause a subscription on a subscription schedule, the scheduled updates still take effect. However, payment isn’t collected while the subscription is paused. When you want to collect payment again, you need to manually unpause the subscription. You also need to update auto_advance to true on any invoices with status=draft that you want to collect payment on.