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

Beispielsweise kann ein Upgrade oder Downgrade eines Abonnements zu anteiligen Zahlungen führen. Wenn ein Kunde/eine Kundin von einem Plan für 10 USD pro Monat auf einen Plan für 20 USD wechselt, 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.

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. Um mehr darüber zu erfahren, wie die anteilmäßige Verrechnung von Gutschriften funktioniert, lesen Sie unseren Leitfaden.

Anteilmäßige Verrechnungen und Rabatte

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

Dieses Verhalten unterscheidet sich von dem ohne anteilmäß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 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 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 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 über die Änderungen informieren, bevor Sie das Abonnement ändern. Da Stripe sekundengenau abrechnet, können sich anteilige Beträge zwischen der Vorschau und dem Zeitpunkt der Aktualisierung ändern. Um dies zu vermeiden, übergeben Sie ein subscription_proration_date an die Rechnung, wenn Sie eine Änderung in der Vorschau anzeigen. Wenn Sie das Abonnement aktualisieren, übergeben Sie dasselbe Datum mithilfe des Parameters proration_date für ein Abonnement, damit die anteilmäßige Verrechnung zur gleichen Zeit ermittelt 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 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 die anteilige Verrechnung ermittelt 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.