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.

Die anteilmäßige Verrechnung stellt sicher, dass die Kundinnen/Kunden genaue Rechnungen erhalten. Allerdings kann die anteilsmäßige möglicherweise zu anderen Zahlungsbeträgen führen, als Sie erwarten. Negative anteilsmäßige Verrechnungen werden nicht automatisch zurückerstattet und positive anteilsmäßige Verrechnungen werden 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

Sie können eine ausstehende Rechnung abrufen, um eine Vorschau der Änderungen an einem Abonnement anzuzeigen. Dieser API-Aufruf wirkt sich nicht auf das Abonnement aus, sondern gibt basierend auf Ihren übergebenen Parametern die ausstehende Rechnung zurück. Änderungen sowohl am price als auch an der quantity führen zu einer anteilmäßigen Verrechnung. In diesem Beispiel werden 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_4eC39HqLyjWDarjtT1zdp7dc'

# 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.upcoming({
  customer: 'cus_4fdAW5ftNQow1a',
  subscription: 'sub_49ty4767H20z6a',
  subscription_items: items,
  subscription_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.

{
  "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,
  "billing_reason": "upcoming",

Anhand dieser Informationen können Sie die Kundin/den Kunden die Änderungen bestätigen lassen, 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 das zu vermeiden, übergeben Sie ein subscription_proration_date an die Rechnung, wenn Sie die Vorschau für eine Änderung anzeigen. Ü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_4eC39HqLyjWDarjtT1zdp7dc'

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

Anteilmäßige Verrechnung deaktivieren

Die anteilsmäßige Verrechnung wird durch den Parameter proration_behavior gesteuert und der Standardwert ist create_prorations.

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

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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.