Anwendungsszenarien für Abonnementpläne

Stellen Sie sich zum besseren Verständnis von Abonnementplänen einen fiktiven Zeitungsverlag mit dem Namen The Pacific vor. Der Verlag bietet zwei Abonnement-Optionen an:

• Print, hier erhalten Kund/innen die Zeitung in gedruckter Form.
• Digital, hier erhalten Kund/innen Zugang zu exklusiven Inhalten auf der Website von The Pacific.

Beide Abonnements werden monatlich abgerechnet. Durchsuchen Sie nachfolgend mögliche Optionen für Abonnementpläne.

Abonnement in der Zukunft starten

Standardmäßig beginnen neue Print-Abonnements am ersten Tag des Folgemonats. Hierbei wird das start_date auf einen Zeitpunkt in der Zukunft festgelegt. Der nachfolgende Programmcode erstellt ein in der Zukunft startendes Abonnement:

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=1690873200 \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"={{PRICE_PRINT}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=12

Ein Abonnement zurückdatieren

Wenn Kund/innen den digitalen Abonnementplan abonnieren, werden die Abonnements von The Pacific auf den ersten Tag des aktuellen Monats zurückdatiert. Mit der Rückdatierung wird die bereits vergangene Zeit abgerechnet und die Abonnenten des digitalen Abonnements können sofort auf die Website zugreifen.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=1688194800 \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"={{PRICE_DIGITAL}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=12

Einen Zeitplan zu einem bestehenden Abonnement hinzufügen

The Pacific stellt gegebenenfalls fest, dass einige ihrer ursprünglichen Kund/innen Abonnements ohne Zeitpläne haben. Da diese Abonnements bereits bestehen, können die Abonnement-IDs im Attribut from_subscription zum Hinzufügen eines Zeitplans übergeben werden. Wenn die Abonnement-IDs so übergeben werden, wird ein Zeitplan mit einer Phase erstellt, die auf dem aktuellen Abrechnungszeitraum des Abonnements basiert.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d from_subscription=
{{SUBSCRIPTION_ID}}

Beim Hinzufügen dieser Zeitpläne entscheiden sich manche Kund/innen für ein Print-Abonnement, woraufhin The Pacific dem Zeitplan eine zweite Phase hinzufügt, um mit dem Print-Plan einen Monat später zu starten. Im folgenden Anwendungsszenario wird ein Beispiel für diesen Vorgang gezeigt.

Upgrade von Abonnements

The Pacific bietet die Option mit einem einmonatigen Print-Abonnement zu starten und danach automatisch die digitale Option hinzuzufügen. Manche Kund/innen bevorzugen diese Option, da sie die Druckversion zunächst testen und anschließend entscheiden können, ob sie ihr Abonnement fortsetzen oder kündigen möchten.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"={{PRICE_PRINT}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=1 \
  -d "phases[1][items][0][price]"={{PRICE_PRINT}} \
  -d "phases[1][items][0][quantity]"=1 \
  -d "phases[1][items][1][price]"={{PRICE_DIGITAL}} \
  -d "phases[1][items][1][quantity]"=1 \
  -d "phases[1][iterations]"=11

Downgrade von Abonnements

The Pacific bietet auch die Option mit einem Abonnement zu starten, das sowohl die gedruckte als auch die digitale Version enthält, und erst danach für die übrige Dauer des Abonnements zur Druckversion herabzustufen. Kund/innen können mit dieser Option beide Versionen testen, um herauszufinden, wie ihnen diese gefallen.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"={{PRICE_DIGITAL}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][items][1][price]"={{PRICE_PRINT}} \
  -d "phases[0][items][1][quantity]"=1 \
  -d "phases[0][iterations]"=1 \
  -d "phases[1][items][0][price]"={{PRICE_PRINT}} \
  -d "phases[1][items][0][quantity]"=1 \
  -d "phases[1][iterations]"=11

Abonnements ändern

The Pacific bietet zwei Optionen für Print-Abonnements an, eine Basic-Option mit Werbung oder eine Premium-Option ohne Werbung. Einige Kundinnen/Kunden mit der Premium-Option möchten beim nächsten Abrechnungszyklus zur Basic-Option mit Werbung wechseln. Erstellen Sie einen Zeitplan unter Zugrundelegung des vorhandenen Abonnements und aktualisieren Sie dann den Zeitplan mit der Basic-Option mit Ankündigungen als neue Phase.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

# Create a subscription schedule with the existing subscription
schedule = Stripe::SubscriptionSchedule.create({
  from_subscription: 'sub_ERf72J8Sc7qx7D',
})

# Update the schedule with the new phase
Stripe::SubscriptionSchedule.update(
  schedule.id,
  {
    phases: [
      {
        items: [
          {
            price: schedule.phases[0].items[0].price,
            quantity: schedule.phases[0].items[0].quantity,
          },
        ],
        start_date: schedule.phases[0].start_date,
        end_date: schedule.phases[0].end_date,
      },
      {
        items: [
          {
            price: '{{PRICE_PRINT_BASIC}}',
            quantity: 1,
          },
        ],
        iterations: 1,
      },
    ],
  },
)

Die Menge erhöhen

Sie können auch eine Erhöhung der Mengen für ein Abonnement planen. Der unten dargestellte Zeitplan startet mit einem Beispiel für eine digitale Veröffentlichung für einen Monat. In der zweiten Phase wird die Menge für 11 weitere Monate auf 2 erhöht.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=1 \
  -d "phases[1][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[1][items][0][quantity]"=2 \
  -d "phases[1][iterations]"=11

Gutscheine verwenden

Gelegentlich bietet The Pacific Rabattaktionen für Abonnements an. Der unten dargestellte Zeitplan gewährt den Kund/innen zunächst für sechs Monate 50 % Rabatt auf die Druckversion. In der zweiten Phase mit den verbleibenden sechs Monaten wird der Gutschein aus dem Abonnement entfernt.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=6 \
  -d "phases[0][coupon]"=
{{COUPON_ID}} \
  -d "phases[1][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[1][items][0][quantity]"=1 \
  -d "phases[1][iterations]"=6

Steuersätze ändern

The Pacific ist in mehreren Regionen tätig, in denen teilweise verschiedene Steuersätze für abonnementbasierte Geschäfte gelten. In einer dieser Regionen sind zwei Steuersätze erforderlich: einer für den ersten Monat, wenn Kund/innen ein Abonnement abschließen, und einer für wiederkehrende Abrechnungen.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=release \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][items][0][tax_rates][0]"=txr_2J8lmBBGHJYyuUJqF6QJtaAA \
  -d "phases[0][iterations]"=1 \
  -d "phases[1][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[1][items][0][quantity]"=1 \
  -d "phases[1][items][0][tax_rates][0]"=txr_2J8lmBBGHJYyuUJqF6QJtbBB \
  -d "phases[1][iterations]"=11

Abonnement aus einem Zeitplan freigeben

Sie können ein Abonnement aus einem Zeitplan freigeben, solange der Status des Zeitplans not_started oder active ist. Durch das Freigeben eines Abonnements bleibt es selbst bestehen, aber der Zeitplan und alle verbleibenden Phasen werden entfernt.

curl -X POST https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}}
/release \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Einen Zeitplan und ein Abonnement kündigen

Sie können einen Abonnementzeitplan und das zugehörige Abonnement sofort kündigen (wenn der Abonnementzeitplan ein aktives Abonnement hat). Ein Abonnementzeitplan kann nur gekündigt werden, wenn sein Status not_started oder active ist.

curl -X POST https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}}
/cancel \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Abrechnungszyklusanker zurücksetzen

The Pacific rechnet seine langjährigen Kund/innen von Print-Abonnements an dem Tag des Monats ab, an dem sie ihr Abonnement ursprünglich abgeschlossen haben. Dieser Tag ist ihr Abrechnungszyklusanker.

Wenn diese Kund/innen zur digitalen Version wechseln, legt The Pacific das Datum für den Wechsel auf den 1. des Folgemonats fest. Gleichzeitig wird der Abrechnungszyklusanker auf das gleiche Datum zurückgesetzt.

Sie können überprüfen, ob der Abrechnunsgzyklusanker zurückgesetzt wird, indem Sie ein Abonnement mit dem unten stehenden Beispielcode erstellen. Wenn Sie sich das Abonnement auf dem Dashboard ansehen, werden Sie feststellen, dass die anstehende Rechnung zahlbar wird, sobald das digitale Abonnement am 1. startet.

Wenn Sie wissen möchten, zu welchem Zeitpunkt die Abrechnung erfolgt, wenn Sie den Anker nicht zurücksetzen, führen Sie den Beispielcode erneut aus. Sie müssen dabei die Zeile entfernen, die den Abrechnungszyklusanker auf phase_start festlegt. Ohne die entsprechende Zeile wird die anstehende Rechnung im Dashboard der Kundin/dem Kunden erst in einem Monat nach dem heutigen Datum zahlbar, auch wenn der Wechsel am 1. erfolgt.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d "phases[0][items][0][price]"={{PRICE_PRINT}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][end_date]"=1690873200 \
  -d "phases[1][items][0][price]"={{PRICE_DIGITAL}} \
  -d "phases[1][items][0][quantity]"=1 \
  -d "phases[1][iterations]"=11 \
  -d "phases[1][billing_cycle_anchor]"=phase_start

Ratenzahlungspläne

Ratenzahlungspläne sind eine Möglichkeit für Kund/innen, über einen festgelegten Zeitraum Teilzahlungen zu leisten, bis der Gesamtbetrag beglichen ist. Wenn The Pacific beispielsweise neue Druckmaschinen kauft, werden die gebrauchten Maschinen an andere Verlagshäuser weiterverkauft. Kleinere Verlage verfügen häufig nicht über die finanziellen Mittel, um eine Druckmaschine im Voraus zu bezahlen, und nutzen stattdessen Ratenzahlungen.

Für die meisten Druckmaschinen berechnet The Pacific 1.000 USD pro Monat, sodass ein wiederkehrender Preis entsteht:

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d unit_amount=100000 \
  -d currency=usd \
  -d product=prod_Hh99apo1OViyGW \
  -d "recurring[interval]"=month

Abhängig von der Bauart, dem Modell und dem Alter der Druckmaschine berechnet The Pacific unterschiedliche Beträge. In diesem Beispiel werden über 6 Monate monatlich 1.000 USD berechnet, was einem Gesamtbetrag von 6.000 USD entspricht.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=cancel \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=6

Die Anzahl der iterations wird mit dem Intervall des Preises – in unserem Beispiel 6 monatliche Raten – multipliziert, um so die Anzahl der Abbuchungen für den/die Kund/in zu bestimmen. end_behavior bestimmt, was nach Ende der letzten Iteration mit dem Abonnement geschieht. Bei einem Ratenplan wird das Abonnement nicht länger benötigt, sodass end_behavior auf cancel festgelegt wird.

In seltenen Fällen berechnet The Pacific weniger als die regulären 1.000 USD pro Monat. In diesen Szenarien verwendet das Unternehmen price_data, um einen einmaligen Preis zu erstellen. Im folgenden Beispiel wird ein Preis in Höhe von 500 USD erstellt, der monatlich für 6 Monate berechnet wird:

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d start_date=now \
  -d end_behavior=cancel \
  -d "phases[0][items][0][price_data][currency]"=usd \
  -d "phases[0][items][0][price_data][product]"=prod_Hh99apo1OViyGW \
  -d "phases[0][items][0][price_data][recurring][interval]"=month \
  -d "phases[0][items][0][price_data][unit_amount]"=50000 \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=6