Anteilmäßige Verrechnung

Der aufwändigste Aspekt beim Ändern bestehender Abonnements sind anteilsmäßige Verrechnungen, bei denen den 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

Beispielsweise können Upgrades oder Downgrades eines Abonnements zu anteiligen Zahlungen führen. Wenn eine Kundin/ein Kunde einen Monatsplan im Wert von 10 USD auf 20 USD erweitert (Upgrade), werden anteilige Beträge für die Zeit der jeweiligen Nutzung in Rechnung gestellt. Angenommen, der Wechsel erfolgt nach der Hälfte des Abrechnungszeitraums, dann werden der Kundin/dem Kunden zusätzlich 5 USD in Rechnung gestellt: -5 USD für die nicht genutzte Zeit zum ursprünglichen Preis und 10 USD für die verbleibende Zeit zum neuen Preis.

Durch anteilsmäßige Verrechnung wird sichergestellt, dass Kundinnen und Kunden genaue Rechnungen erhalten. Allerdings kann die anteilsmäßige Verrechnung zu unerwarteten Zahlungsbeträgen führen. Negative anteilsmäßige Verrechnungen werden nicht automatisch zurückerstattet und positive anteilsmäß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.

Verrechnungen und Rabatte

Alle Anpassungen aufgrund von Rabatten werden im Betrag des Postens der anteiligen Rechnung wiedergegeben. Weitere Rabatte auf Rechnungspostenebene oder auf Rechnungseinzelpostenebene gelten nicht für anteilige Verrechnungen, da sie discountable=false haben.

Dieses Verhalten unterscheidet sich von dem ohne anteilsmäßige Verrechnungen, bei dem Rabattanpassungen in discount_amounts angezeigt werden.

Wodurch werden anteilmäßige Verrechnungen ausgelöst

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

• Wechsel zu einem Preis mit anderen Grundkosten
• Wechsel zu einem Preis mit anderem Abrechnungsintervall
• Hinzufügen eines Testzeitraums zu einem aktiven Abonnement
• Ändern der Menge
• Lizenzierte Abonnements, (da diese immer zu Beginn eines Abrechnungszeitraums in Rechnung gestellt werden)

Eigene anteilsmäßige Verrechnungen manuell erstellen

Um Ihre eigene anteilsmäßige Verrechnung außerhalb von Stripe zu berechnen und sie dem Abonnement hinzuzufügen, übergeben Sie add_invoice_items mit 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 Zahlungen, die vor dem Abrechnungszylus erfolgen. Die nutzungsbasierte Abrechnung ist nicht von der anteilmäßigen Verrechnung betroffen.

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.

Steuern und anteilmäßige Verrechnungen

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

Vorschau für anteilmäßige Verrechnung anzeigen

You can create a preview invoice to preview changes to a subscription. This API call doesn’t modify the subscription. Instead, it returns the upcoming invoice based only on the parameters that you pass. Changing the price or quantity both result in a proration. This example changes the price and sets a date for the proration.

# 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 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 über die Änderungen informieren, bevor Sie das Abonnement ändern. Da die anteilsmäßige Verrechnung in Stripe sekundengenau erfolgt, können sich anteilige Beträge zwischen der Vorschau und dem Zeitpunkt der Aktualisierung ändern. Um dies zu vermeiden, übergeben Sie subscription_proration_date an die Rechnung, wenn Sie die Vorschau einer Veränderung einsehen. Wenn Sie das Abonnement aktualisieren, übergeben Sie dasselbe Datum mithilfe des proration_date-Parameters für ein Abonnement, damit 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,
  }
)

Anteilsmäßige Verrechnung steuern

Die anteilsmäß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 anteilsmäßige Verrechnungen erstellen

Um einem Kunden/einer Kundin eine Änderung an einem Abonnement im selben Abrechnungszyklus sofort in Rechnung zu stellen, legen Sie proration_behavior auf always_invoice fest, wenn Sie das Abonnement ändern. Dadurch wird der Anteil berechnet und sofort eine Rechnung erstellt.

Anteilmäßige Verrechnung deaktivieren

Um die anteilige Verrechnung auf Anforderungsbasis zu deaktivieren, setzen Sie den proration_behavior-Parameter auf none. Es gibt keinen Parameter, der alle zukünftigen anteilsmäßigen Verrechnungen für ein Abonnement deaktiviert. Um die anteilsmäßige Verrechnung auf unbestimmte Zeit zu deaktivieren, legen Sie für jede Anfrage, die anteilsmäßige Verrechnungen generiert, proration_behavior 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 Kund/innen mit der nächsten Rechnung der gesamte Betrag zum neuen Preis in Rechnung gestellt.