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.

You can pause or resume collection in the Stripe Dashboard or the API. While collection is paused, subscriptions still generate invoices, but you have a few options for handling these invoices. Review the following use cases to determine the best approach for you:

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

Wenn Sie ein Abonnement innerhalb eines Abonnementplans unterbrechen, werden die geplanten Aktualisierungen weiterhin durchgeführt. Es werden jedoch keine Zahlungen eingezogen, während das Abonnement unterbrochen ist. Wenn Sie den Zahlungseinzug wiederaufnehmen möchten, müssen Sie das Unterbrechen des Abonnements manuell aufheben. Ändern Sie auch auto_advance für alle Rechnungen mit status=draft, für die Sie die Zahlung einziehen möchten, in true.