Anteilmäßige Verrechnung

Der aufwändigste Aspekt beim Ändern bestehender Abonnements sind anteilmäßige Verrechnungen, bei denen Kundinnen/Kunden ein prozentualer Anteil der Kosten eines Abonnements berechnet wird, um die anteilmäßige Nutzung zu berücksichtigen. Auf dieser Seite wird erläutert, wie anteilmäßige Verrechnungen bei Abonnements funktionieren und wie Sie diese für Ihre Kundinnen/Kunden verwalten.

So funktionieren anteilmäßige Verrechnungen

Zum Beispiel kann das Upgrade oder Downgrade eines Abonnements zu anteilmäßig verrechneten Zahlungen führen. Wenn ein/e Kundin/Kunde von einem monatlichen Plan im Wert von 10 USD auf eine Option im Wert von 20 USD umsteigt, werden ihr/ihm anteilmäßig verrechnete Beträge für die Zeit berechnet, die sie/er mit jeder Option verbracht hat. Unter der Annahme, dass der Wechsel nach der Hälfte des Rechnungsstellungszeitraums erfolgte, werden der/dem Kundin/Kunden zusätzlich 5 USD in Rechnung gestellt: -5 USD für die ungenutzte Zeit im ursprünglichen Preis und 10 USD für die verbleibende Zeit im neuen Preis.

Die anteilmäßige Verrechnung stellt sicher, dass die Kundinnen/Kunden genaue Rechnungen erhalten. Allerdings kann die anteilmäßige Verrechnung zu unerwarteten Zahlungsbeträgen führen. Negative anteilmäßige Verrechnungen werden nicht automatisch zurückerstattet und positive anteilmäßige Verrechnungen nicht sofort in Rechnung gestellt, obwohl beides manuell möglich ist.

Sie können sich eine Vorschau der anteilmäßigen Verrechnung anzeigen lassen, um den Betrag vor dem Übernehmen der Änderungen zu sehen. Wenn Sie mehr darüber erfahren möchten, wie die anteilmäßige Verrechnung von Gutschriften funktioniert, lesen Sie unseren Leitfaden.

Anteilmäßige Verrechnungen und Rabatte

Alle Rechnungsposten bei denen es sich um anteilmäßige Verrechnungen (prorations=true) sind auf discountable=false gesetzt. Rabatte, die auf eine Rechnung angewendet werden, die anteilige Verrechnungen enthält, werden nur auf Rechnungsposten und Rechnungszeilenposten angewendet, die keine anteilmäßige Verrechnungen sind. Alle Rabatte, die zuvor auf das Abonnement angewendet wurden und sich auf den Betrag der anteiligen Verrechnungen auswirken, spiegeln sich im Betrag des anteiligen Rechnungspostens wider.

Nicht anteilmäßige Verrechnungen zeigen Rabattkorrekturen in discount_amounts.

Wodurch werden anteilmäßige Verrechnungen ausgelöst

Standardmäßig führen die folgenden Szenarien zu einer anteilmäßigen Verrechnung:

Was keine anteilsmäßigen Verrechnungen auslöst

Viele Aktualisierungen von Abonnements wirken sich nicht auf die Abrechnung aus bzw. generieren keine anteilmäßige Verrechnung. Nehmen Sie diese Aktualisierungen jederzeit vor, ohne Rechnungsposten mit anteilmäßiger Verrechnung zu erstellen:

Eigene anteilmäßige Verrechnungen manuell erstellen

Um Ihre eigene anteilmäßige Verrechnung außerhalb von Stripe zu berechnen und sie dem Abonnement hinzuzufügen, übergeben Sie add_invoice_items mit einem negativen unit_amount (gleich dem berechneten Anteilsbetrag) an diese Endpoints:

• CreateSubscription
• UpdateSubscription
• CreateSubscriptionSchedule
• UpdateSubscriptionSchedule

Anteilmäßige Verrechnungen werden unter folgenden Umständen angewendet

Anteilmäßige Verrechnungen gelten nur für Gebühren, die vor Beginn des Rechnungsstellungszeitraums anfallen. Nutzungsbasierte Abrechnung unterliegt nicht der anteilmäßigen Verrechnung.

Der anteilige Betrag wird berechnet, sobald das Abonnement über die API aktualisiert wird. Anhand der Start- und Endzeiten des aktuellen Abrechnungszeitraums werden die Kosten des Abonnements vor und nach der Änderung berechnet.

Anteilmäßige Verrechnungen und unbezahlte Rechnungen

Stripe kalkuliert anteilmäßige Verrechnungen auf der Grundlage des Status des Abonnements zum Zeitpunkt der Aktualisierung und geht davon aus, dass alle früheren Rechnungen für das Abonnement irgendwann bezahlt werden. Wenn eine Kundin / ein Kunde ihr/sein Abonnement ändert, während sie/er eine unbezahlte Rechnung für die aktuelle Laufzeit hat, erhält sie/er möglicherweise eine Gutschrift für die ungenutzte Zeit im höherpreisigen Plan, auch wenn sie/er für diese Zeit noch nicht bezahlt hat.

Um eine Gutschrift für unbezahlte Zeit zu vermeiden, können Sie die anteilmäßige Verrechnung deaktivieren, wenn die letzte Rechnung des Abonnements nicht bezahlt ist. Legen Sie beim Aktualisieren des Abonnements proration_behavior auf none fest. Wählen Sie eines der folgenden Verfahren aus:

1. Um den ursprünglichen Rechnungsstellungszeitraum beizubehalten: Erstellen Sie manuell eine Einmalrechnung für alle neuen Gebühren.
2. Um die neue Preisstufe sofort in Rechnung zu stellen und den Rechnungsstellungszeitraum zurückzusetzen: Setzen Sie billing_cycle_anchor auf now. Weitere Informationen finden Sie unter Rechnungsstellungszeitraum auf die aktuelle Uhrzeit zurücksetzen.

Beide Vorgehensweisen können zu einer doppelten Zahlung führen, wenn die/der Kundin/Kunde vielleicht die alte Rechnung bezahlt. Um dies zu vermeiden, stornieren Sie die unbezahlte Rechnung.

Steuern und anteilmäßige Verrechnungen

Informationen darüber, wie Steuern mit anteilmäßiger Verrechnung funktionieren, finden Sie unter Steuern für wiederkehrende Zahlungen einziehen.

Anteilmäßige Verrechnung von Gutschriften

Anteilmäßige Verrechnungen werden ausgestellt, wenn Kund/innen ihre Abonnements herabstufen oder Posten vor dem Ende des Rechnungsstellungszeitraums stornieren. Stripe bietet zwei Ansätze zur Berechnung der anteilmäßigen Verrechnung, je nachdem, ob Sie den billing_mode Ihres Abonnements auf classic oder flexible setzen.

Berechnungslogik ohne anteilmäßige Verrechnungen

Im folgenden Szenario erhöhen Sie ein monatliches Abonnement von 10 USD auf 20 USD mit der Einstellung proration_behavior auf none für 10 Tage. Es gibt keine vorherige Abbuchung, auf die Sie sich stützen könnten. Später stufen Sie das Abonnement auf 10 USD pro Monat herab, wobei proration_behavior auf always_invoice eingestellt ist.

Um dieses Szenario einzurichten, müssen Sie zunächst ein Abonnement erstellen und zwar für 10 USD pro Monat am 1. April:

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "items[0][price]"=price_10_monthly

Die Antwort enthält die Rechnung, die für dieses Abonnement erstellt wurde:

{
  id: "sub_123",
  latest_invoice: {
    id: "in_123",
    total: 10_00,
    currency: "usd"
    }
}

Am 11. April folgt die Aufstockung des Abonnements auf 20 USD pro Monat, ohne anteilmäßige Verrechnungen zu erstellen:

curl https://api.stripe.com/v1/subscriptions/sub_123 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "items[0][id]"=sub_item_1 \
  -d "items[0][price]"=price_20_monthly \
  -d proration_behavior=none

Die letzte Rechnung bleibt unverändert, da proration_behavior gleich none ist:

{
  id: "sub_123",
  latest_invoice: {
    id: "in_123"
  }
}

Am 21. April stufen Sie das Abonnement auf 10 USD pro Monat herab und verrechnen anteilmäßig:

curl https://api.stripe.com/v1/subscriptions/sub_123 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "items[0][id]"=sub_item_1 \
  -d "items[0][price]"=price_10_monthly \
  -d proration_behavior=always_invoice

# billing_mode = classic
  {
    id: "sub_123",
    latest_invoice: {
      id: "in_456",
      total: -3_34,
      currency: "usd"
    }
  }

# billing_mode = flexible
  {
    id: "sub_123",
    latest_invoice: {
      id: "in_456",
      total: 0,
      currency: "usd"
    }
  }

Berechnungslogik für Gutscheine, die auf mehrere Abonnementartikel angewendet werden

Stripe gewichtet den amount_off-Gutschein bei der anteilmäßigen Verrechnung der Gutschrift, um eine überhöhte Rechnungsstellung zu vermeiden.

Im folgenden Szenario wird ein Gutschein in Höhe von 5 USD ungleichmäßig einem monatlichen Abonnement in Höhe von 25 USD für einen Artikel über 10 USD und einen Artikel über 20 USD zugewiesen.

Um dieses Szenario einzurichten, erstellen Sie ein Abonnement mit mehreren Posten und einem Gutschein für den 1. Februar:

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "items[0][price]"=price_20_monthly \
  -d "discounts[0][coupon]"=five_dollars_off

Dadurch wird die folgende Antwort zurückgegeben:

{
  id: "sub_123",
  latest_invoice: {
    id: "in_123",
    total: 25_00,
    currency: "usd",
    lines: {
      data: [
      {
        id: "ili_1",
        amount: 10_00,
        price: "price_10_monthly",
        discount_amounts: [{
          discount: "di_a",
          amount: 1_66 }] },
      {
        id: "ili_2",
        amount: 20_00,
        price: "price_20_monthly",
        discount_amounts: [{
          discount: "di_a",
          amount: 3_34
          }]
        },
    ] }
  }
}

Um den Posten des monatlichen Abonnements zu stornieren:

curl https://api.stripe.com/v1/subscription_items/si_10_monthly \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d proration_behavior=create_prorations

Wenn ein Posten des Abonnements gelöscht wird, beeinflusst der billing_mode, der mit diesem Abonnement verbunden ist, wie die anteilmäßige Verrechnung kalkuliert wird:

# billing_mode = classic
  {
    "id": "sub_123",
    "latest_invoice": {
      "id": "in_456",
      "total": -250,
      "currency": "usd"
    }
  }

# billing_mode = flexible
  {
    "id": "sub_123",
    "latest_invoice": {
      "id": "in_789",
      "total": -417,
      "currency": "usd"
    }
  }

Vorschau für eine anteilmäßige Verrechnung anzeigen

Sie können eine Rechnungsvorschau erstellen, um eine Vorschau der Änderungen an einem Abonnement anzuzeigen. Dieser API-Aufruf ändert das Abonnement nicht. Stattdessen wird die ausstehende Rechnung nur basierend auf den von Ihnen übergebenen Parametern zurückgegeben. Änderungen sowohl am price als auch an der quantity führen zu einer anteilmäßigen Verrechnung. In diesem Beispiel wird der price geändert und ein Datum für die anteilmäßige Verrechnung festgelegt.

# 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_BQokikJOvBiI2HlWgH4olfQ2'

# Set proration date to this moment:
proration_date = Time.now.to_i

subscription = Stripe::Subscription.retrieve('sub_49ty4767H20z6a')

# See what the next invoice would look like with a price switch
# and proration set:
items = [{
  id: subscription.items.data[0].id,
  price: 'price_CBb6IXqvTLXp3f', # Switch to new price
}]

invoice = Stripe::Invoice.create_preview({
  customer: 'cus_4fdAW5ftNQow1a',
  subscription: 'sub_49ty4767H20z6a',
  subscription_details: {
    items: items,
    proration_date: proration_date,
  }
})

Sie können die Beispielantwort erweitern, um Folgendes anzuzeigen:

• Das Guthaben für nicht genutzte Zeit zum vorherigen Preis in den Zeilen 36 bis 38.
• Die Kosten für genutzte Zeit zum neuen Preis in den Zeilen 107 bis 109.
• Die neue Zwischensumme und die Summe für die Rechnung in den Zeilen 276 bis 279.

{
  "id": "upcoming_in_1OujwkClCIKljWvsq5v2ICAN",
  "account_country": "US",
  "account_name": "Test account",
  "amount_due": 3627,
  "amount_paid": 0,
  "amount_remaining": 3627,
  "application_fee_amount": null,
  "attempt_count": 0,
  "attempted": false,

Anhand dieser Informationen können Sie die Kundin/den Kunden die Änderungen bestätigen lassen, bevor Sie das Abonnement ändern. Da Stripe sekundengenau anteilmäßig verrechnet, können sich anteilmäßig verrechnete Beträge zwischen der Vorschau und dem Zeitpunkt der Aktualisierung ändern. Um das zu vermeiden, übergeben Sie einen Wert subscription_details.proration_date beim Erstellen einer Vorschau. Übergeben Sie beim Aktualisieren des Abonnements das gleiche Datum mithilfe des Parameters proration_date für ein Abonnement, sodass der Anteil zur gleichen Zeit berechnet wird.

# 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_BQokikJOvBiI2HlWgH4olfQ2'

subscription = Stripe::Subscription.update(
  'sub_49ty4767H20z6a',
  {
    items: [
      {
        id: subscription.items.data[0].id,
        price: 'price_CBb6IXqvTLXp3f',
      },
    ],
    proration_date: proration_date,
  }
)

Anteilmäßige Verrechnung steuern

Die anteilmäßige Verrechnung wird durch den Parameter proration_behavior gesteuert, der über drei mögliche Parameteroptionen verfügt: create_prorations, always_invoice und none.

Standardverhalten

Der Standardparameter für proration_behavior ist create_prorations, wodurch gegebenenfalls anteilige Rechnungsposten erstellt werden. Diese anteilmäßigen Posten werden nur unter bestimmten Voraussetzungen sofort in Rechnung gestellt.

Sofortige anteilmäßige Verrechnungen erstellen

Um einer Kundin/einem Kunden eine Änderung an einem Abo innerhalb desselben Rechnungsstellungszeitraums sofort in Rechnung zu stellen, setzen Sie beim Ändern des Abos proration_behavior aufalways_invoice. Dadurch wird die anteilmäßige Verrechnung berechnet und sofort eine Rechnung erstellt.

Anteilmäßige Verrechnung deaktivieren

Um die anteilige Verrechnung auf Anforderungsbasis zu deaktivieren, legen Sie den Parameter proration_behavior auf none fest. Es gibt keinen Parameter, der alle zukünftigen anteilmäßigen Verrechnungen für ein Abonnement deaktiviert. Um die anteilmäßige Verrechnung auf unbestimmte Zeit zu deaktivieren, legen Sie proration_behavior für jede Anfrage, die anteilmäßige Verrechnungen generiert, auf none fest:

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "items[0][id]"="si_1AkFf6LlRB0eXbMtRFjYiJ0J" \
  -d "items[0][price]"="price_CBb6IXqvTLXp3f" \
  -d "proration_behavior"="none"

Wenn die anteilmäßige Verrechnung deaktiviert ist, wird Kundinnen/Kunden mit der nächsten Rechnung der gesamte Betrag zum neuen Preis in Rechnung gestellt.