Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden

Setzen Sie fortschrittliche nutzungsbasierte Abrechnung mit Preisplänen umPrivate Vorschau

Rechnen Sie Ihre Kundinnen und Kunden auf der Grundlage von Nutzung und wiederkehrenden Gebühren ab.

Sie können verschiedene Preiskomponenten in einem einzigen Preisplan zusammenfassen. Sie können beispielsweise einen Preisplan erstellen, der Preislisten für die nutzungsbasierte Abrechnung, Lizenzgebühren für wiederkehrende Zahlungen und Serviceaktionen für wiederkehrende Gutschriftvergaben. Wenn ein Kunde/eine Kundin einen Preisplan abonniert, werden alle wiederkehrenden Komponenten automatisch erfasst und gemäß dem von Ihnen festgelegten Rhythmus abgerechnet.

Folgende Preismodelle werden beispielsweise unterstützt:

  • Pay-as-you-go
  • Echtzeit-Guthabenabrechnung mit Aufladungen
  • Pauschalgebühr und Überschreitungsgebühren

Private Vorschau

Preispläne befinden sich derzeit in der privaten Vorschau und können in Funktionalität und Integrationspfad Änderungen unterliegen, bevor sie allen Stripe-Nutzerinnen und -Nutzern allgemein zur Verfügung stehen. Kontaktieren Sie uns here, um Zugang zu beantragen.

Bevor Sie beginnen

Sie können auch eine geführte API-Version (Blueprint) dieses Leitfadens im Dashboard verwenden.

Preispläne verwenden /v2-API-Endpoints. Erfahren Sie mehr über die /v2 und /v1 Namespaces.

Verwenden Sie Sandboxes, um die Integration Ihrer Preispläne zu testen. Sie können den Test-Modus nicht mit /v2-APIs verwenden.

Preisplan erstellen

Verwenden Sie das Stripe Dashboard oder die API, um einen Preisplan zu erstellen, der alle relevanten Abrechnungskomponenten Ihres Preismodells enthält.

Für jeden Preisplan können Sie Folgendes konfigurieren:

  • Währung: Geben Sie die Währungen für alle Komponenten in Ihrem Preisplan an.
  • Steuer soll in Preisen enthalten sein: Geben Sie an, ob die Steuer in Ihren Preis einbezogen werden soll (inklusive) oder ob sie zur Zwischensumme der Rechnung hinzuaddiert werden soll (exklusive). Erfahren Sie mehr über inklusive und exklusive Steuern für die Abrechnung.
  • Metadaten: Fügen Sie optional Ihre eigenen Metadaten zum Preisplan hinzu.

Nachdem Sie die Währung und die Steuerparameter festgelegt haben, definieren Sie die relevanten Komponenten Ihres Plans. Welche Komponenten Sie einbeziehen, hängt von Ihrem Preismodell ab. Dieser Leitfaden verwendet alle drei Komponenten ((Preislisten, Lizenzgebühren und Serviceaktionen), aber welche Komponenten Sie verwenden, hängt von Ihrem Preismodell ab. Zum Beispiel benötigen Sie bei einem Pay-as-you-go-Preismodell und bei Guthabenverrechnung in Echtzeit mit Aufstockungen nur eine Preisliste. Bei Pauschalgebühren und Überschreitungen benötigen Sie eine Preisliste und eine Lizenzgebühr und bei wiederkehrenden Guthaben mit Aufladungen benötigen Sie eine Preisliste und eine Serviceaktion.

Erstellen Sie den Preisplan

  1. Klicken Sie auf der Seite Preispläne auf Preisplan erstellen.
  2. Im Preisplan-Editor:
    • Geben Sie einen Anzeigenamen, die Währung und das Steuerverhalten an.
    • (Optional) Geben Sie unter Erweiterte Einstellungen eine Beschreibung, einen eindeutigen Suchschlüssel und Metadaten an.
  3. Klicken Sie auf Fortfahren.

Preisliste hinzufügen

  1. Klicken Sie im Preisplan Editor auf und Preisliste.
  2. Im Preislisten-Editor:
    • Geben Sie einen Anzeigenamen an.
    • Legen Sie den Servicezeitraum fest .
    • (Optional) Geben Sie unter Erweiterte Einstellungen einen Suchschlüssel und Metadaten an.
  3. Klicken Sie auf Fortfahren.

Fügen Sie der Preisliste einen Preis hinzu.

  1. Im Preis-Editor:
    • Geben Sie außerdem einen Anzeigenamen für das verbrauchsabhängige Element an – zum Beispiel Hypernian-Token.
    • Wählen Sie einen vorhandenen Zähler aus oder erstellen Sie einen neuen, indem Sie auf klicken.
    • Wählen Sie den Preistyp aus – Fester Satz, Staffelpreis oder Gestufter Preis. Im Hypernian-Beispiel wird der Festpreis verwendet.
      • Wählen Sie unter Verkaufen als, ob Sie einzelne Einheiten oder eine Gruppierung von Einheiten verkaufen möchten. Ein KI-Unternehmen könnte zum Beispiel seine Tokens in Paketen zu 100 Einheiten zu einem Preis von 0,04 USD pro Paket verkaufen.
      • Geben Sie für Pakete die Einheiten pro Paket ein.
      • Wählen Sie aus, ob für Teilpakete auf- oder abgerundet werden soll. Wenn Sie aufrunden, werden einem/einer Nutzer/in, der/die 110 Einheiten nutzt, 0,08 USD in Rechnung gestellt.
      • Geben Sie den Preis pro Paket ein.
    • (Optional) Konfigurieren Sie Erweiterte Einstellungen für Ihren gemessenen Posten, z. B. Angabe eines Produkt-Steuercodes (erfahren Sie mehr über Steuercodes), Einheitskennzeichnung, Suchschlüssel und Metadaten. Sie können dem Preis auch Metadaten hinzufügen.
  2. Klicken Sie auf Fertig.
  3. (Optional) Klicken Sie auf Preis hinzufügen, um der Preisliste zusätzliche Preise hinzuzufügen.

Lizenzgebühr hinzufügen

  1. Klicken Sie im Preisplan-Editor auf und Lizenzgebühr.
  2. Im Lizenzgebühren-Editor:
    • Geben Sie einen Anzeigenamen für den lizenzierten Posten an.
    • Legen Sie den Servicezeitraum fest .
    • Wählen Sie den Preistyp aus – Fester Satz, Staffelpreis oder Gestufter Preis. Zum Beispiel 50,00 USD pro Einheit.
    • (Optional) Konfigurieren Sie die Erweiterten Einstellungen für Ihren lizenzierten Posten, z. B. durch die Angabe eines Produkt-Steuercodes (Weitere Informationen zu Steuercodes), Einheitskennzeichnung, Suchschlüssel und Metadaten. Sie können der Gebühr auch Metadaten hinzufügen.
  3. Klicken Sie auf Fertig.

Serviceaktion hinzufügen

  1. Klicken Sie im Preisplan-Editor auf und Gutschriftgewährung.
  2. Im Editor für wiederkehrende Gutschriftgewährungen:
    • Geben Sie einen Anzeigenamen für die Gutschriftgewährung an.
    • Legen Sie den Servicezeitraum fest .
    • Geben Sie einen Gutschriftsbetrag an.
    • (Optional) Konfigurieren Sie Erweiterte Einstellungen für Ihre wiederkehrende Gutschriftgewährung, z. B. die Spezifizierung eines Antrags oder eines Suchschlüssels.
  3. Klicken Sie auf Fertig.

Nachdem Sie den Preisplan konfiguriert haben, klicken Sie auf Preisplan erstellen.

Abonnieren Sie Ihre/n Kunde/Kundin auf einen Preisplan

Nachdem Sie einen Preisplan eingerichtet haben, können Sie ihn für eine Kundin/einen Kunden abonnieren. Sie können ein Abo erstellen, indem Sie die Checkout Sessions API mit entweder einer von Stripe gehosteten Seite oder eingebetteten Komponenten als Nutzeroberfläche für die Zahlung verwenden. (Die Checkout-Sitzung erstellt auch eine Kundin/einen Kunden.) Sie können die API auch verwenden, um direkt ein Preisplan-Abo zu erstellen. Wenn Sie die direkte API-Methode verwenden, müssen Sie eine Kundin/einen Kunden, eine Einzugsmethode,einen Abrechnungsrhythmus und einen Abrechnungs-Intent erstellen, wodurch das Preisplan-Abonnement erstellt wird.

Verwenden Sie die Checkout Sessions API, um eine Bezahlseite für Ihre Kundinnen und Kunden zu erstellen. Wenn ein Kunde auf Abonnieren klickt, erstellt die Checkout Session ein Kundenobjekt (wenn Sie keine Kunden-ID für die Session angegeben haben) und ein Preisplan-Abo. Wenn Sie mehrere Posten in checkout_items haben, wird für jeden Posten ein Preisplan-Abo erstellt.

Im Folgenden finden Sie ein Beispiel dafür, wie ein vollständiger Preisplan mit Checkout aussieht.

Beispiel für Preisplan

Ein in Stripe Checkout angezeigter Preisplan

Einschränkungen der Checkout-Sitzung während der privaten Vorschau

Während der privaten Vorschau:

Kontaktieren Sie advanced-ubb-private-preview@stripe.com, um frühzeitigen Zugriff zu erhalten und Produktfeedback oder -anfragen zu teilen.

Um eine Checkout-Session mit Preisplänen zu erstellen, fügen Sie ein Objekt im Array checkout_items hinzu, dessen type auf pricing_plan_subscription_item gesetzt ist und eine pricing_plan_subscription_item-Konfiguration enthält. Wenn Sie checkout_items anstelle von line_items verwenden, müssen Sie den mode nicht angeben.

Command Line
cURL
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-09-30.preview;checkout_product_catalog_preview=v1" \
  -d customer={{CUSTOMER_ID}} \
  -d "checkout_items[0][type]"=pricing_plan_subscription_item \
  -d "checkout_items[0][pricing_plan_subscription_item][pricing_plan]"={{PRICING_PLAN_ID}} \
  -d success_url={{SUCCESS_URL}}

Wenn Ihr Preisplan eine Lizenzgebühr enthält, müssen Sie die Anzahl der Lizenzen angeben:

So rufen Sie die Lizenzgebühren-Komponenten-ID ab:

Command Line
cURL
No results
curl https://api.stripe.com/v2/billing/pricing_plans/{{PRICING_PLAN_ID}}/components \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-09-30.preview"

Erstellen Sie die Checkout-Sitzung unter Verwendung der Lizenzgebühren-Komponenten-ID:

Command Line
cURL
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-09-30.preview;checkout_product_catalog_preview=v1" \
  -d customer={{CUSTOMER_ID}} \
  -d "checkout_items[0][type]"=pricing_plan_subscription_item \
  -d "checkout_items[0][pricing_plan_subscription_item][pricing_plan]"={{PRICING_PLAN_ID}} \
  -d "checkout_items[0][pricing_plan_subscription_item][component_configurations][{{LICENSE_COMPONENT_ID}}][type]"=license_fee_component \
  -d "checkout_items[0][pricing_plan_subscription_item][component_configurations][{{LICENSE_COMPONENT_ID}}][license_fee_component][quantity]"=1

Auf der Seite werden die Details Ihres Preisplans angezeigt und die Zahlungen der Kunden erfasst. Nach Abschluss der Sitzung wird das Preisplan-Abonnement erstellt und die Kundin/der Kunde an die URL weitergeleitet, die Sie für success_url angegeben haben. Erfahren Sie mehr über die Anpassung des Weiterleitungsverhaltens mit Checkout.

Kundennutzung aufzeichnen

Nachdem Sie eine Kundin/einen Kunden für einen Preisplan mit einer Preisliste angemeldet haben, erfassen Sie die Nutzung Ihres Dienstes, indem Sie Zählerereignisse an einen Zähler senden.

  1. Gehen Sie zur Registerkarte Preisplan-Abonnements.
  2. Klicken Sie auf das Abonnement, für das Sie die Nutzung aufzeichnen möchten.
  3. Wählen Sie Anzeigen aus, um die zugrunde liegenden Preisplan-Komponenten anzuzeigen, und navigieren Sie zu der Preisliste, für die Sie die Nutzung hinzufügen möchten.
  4. Klicken Sie auf das Überlaufmenü () in der Zeile des Artikels, für den Sie die Nutzung aufzeichnen möchten, und dann auf Verbrauch anzeigen.
  5. Klicken Sie auf der Detailseite des Zählers auf + Nutzung hinzufügen und wählen Sie dann Nutzung manuell eingeben aus.
  6. Gehen Sie im Dialogfeld Nutzung hinzufügen wie folgt vor:
    • Wählen Sie einen Kunden/eine Kundin aus.
    • Geben Sie einen Wert für die Nutzung an.
    • Wählen Sie ein Datum für den Zeitstempel aus.
  7. Klicken Sie auf Absenden.

Eine Rechnungsvorschau erstellen

Erstellen Sie eine Vorschau-Rechnung, um eine Vorschau der Kundenrechnung anzuzeigen. Die Vorschau enthält die relevanten Posten aus den verschiedenen Preisplan-Komponenten.

  1. Gehen Sie zur Registerkarte Preisplan-Abonnements.
  2. Klicken Sie auf das Abonnement, für das Sie eine Rechnungsvorschau anzeigen möchten.
  3. Scrollen Sie nach unten zum Abschnitt Anstehende Rechnung. Die Rechnung in der Vorschau zeigt den Betrag des Abonnements, der dem Kunden / der Kundin am angegebenen Datum in Rechnung gestellt werden soll, und enthält die entsprechenden gemessenen Posten, die Lizenzposten und das Guthaben.

Wartungsereignisse überwachen

Preisplan-Abonnements senden Ereignisbenachrichtigungen, wenn sich der Status von Service und Einzug ändert.

Überwachen Sie diese Ereignisse und verwenden Sie sie, um Ihre Geschäftslogik zu erstellen:

v2.billing.pricing_plan_subscription.servicing_activatedDie Nutzer/in bezahlt das Abonnement, das den Dienst aktiviert.
v2.billing.pricing_plan_subscription.servicing_pausedNutzer/in unterbricht das Abonnement.
v2.billing.pricing_plan_subscription.servicing_canceledDer/die Nutzer/in kündigt den Dienst.
v2.billing.pricing_plan_subscription.collection_currentDer Einzug des Abonnements läuft.
v2.billing.pricing_plan_subscription.collection_awaiting_customer_actionDas Inkasso wartet auf Aktionen des Kunden.
v2.billing.pricing_plan_subscription.collection_pausedDer Einzug ist unterbrochen.
v2.billing.rate_card_subscription.collection_past_dueDer Einzug ist überfällig.
v2.billing.rate_card_subscription.collection_unpaidDer Einzug gilt als unbezahlt.

Um diese v2 Events zu verarbeiten, konfigurieren Sie eine Event Destination und lassen Sie sie auf Ihren Webhook Endpoint verweisen. Sie haben folgende Möglichkeiten:

Nachdem Sie ein Ziel erstellt haben, können Sie Ihren Webhook-Endpoint so einrichten, dass er diese Ereignisse verarbeitet:

server.rb
require 'stripe'

post '/v2_webhook_endpoint' do
  payload = request.body.read
  sig_header = request.env['HTTP_STRIPE_SIGNATURE']
  event = nil

  begin
    event = Stripe::Webhook.construct_event(
      payload, sig_header, endpoint_secret
    )
  rescue JSON::ParserError => e
    status 400
    return
  rescue Stripe::SignatureVerificationError => e
    status 400
    return
  end

  client = Stripe::StripeClient(
"sk_test_BQokikJOvBiI2HlWgH4olfQ2"
)

  case event.type
  when 'v2.billing.pricing_plan_subscription.servicing_activated'
    # The customer clicked Pay on Stripe Checkout, which activates the service.
    subscription_id = event.related_object.id
    subscription = client.v2.billing.pricing_plan_subscriptions
      .retrieve(subscription_id)

    # Look up your user in the database using the metadata passed into
    # Checkout Session create
    user_id = subscription.metadata["my_user_id"]
    user = User.find_by_id(user_id)

    # Fill in your logic here:
    mark_subscription_active(user, subscription)
  when 'v2.billing.pricing_plan_subscription.servicing_paused'
    # The customer paused the subscription.
    subscription_id = event.related_object.id
    subscription = client.v2.billing.pricing_plan_subscriptions
      .retrieve(subscription_id)

    # Look up your user in the database using the metadata passed into
    # Checkout Session create
    user_id = subscription.metadata["my_user_id"]
    user = User.find_by_id(user_id)

    # Fill in your logic here:
    mark_subscription_paused(user, subscription)
  when 'v2.billing.pricing_plan_subscription.servicing_canceled'
    # The customer canceled the subscription.
    subscription_id = event.related_object.id
    subscription = client.v2.billing.pricing_plan_subscriptions
      .retrieve(subscription_id)

    # Look up your user in the database using the metadata passed into
    # Checkout Session create
    user_id = subscription.metadata["my_user_id"]
    user = User.find_by_id(user_id)

    # Fill in your logic here:
    mark_subscription_canceled(user, subscription)
  end

  status 200
end

Integration testen

So testen Sie Ihre Integration:

  • Erstellen Sie eine Sandbox.
  • Erstellen Sie einen Test-Preisplan und mindestens eine zugrunde liegende Preiskomponente in Ihrer Sandbox.
  • Verwenden Sie Testkarten, um erfolgreiche und fehlgeschlagene Zahlungen zu simulieren.
  • Erstellen Sie Testzählerereignisse zur Simulation der Nutzung.
  • Verwenden Sie Test-Uhren, um die Abrechnung zu simulieren.

Erstellen Sie keine Test-Uhren in der Vergangenheit

Wenn Sie eine Test-Uhr für ein Preisplan-Abonnement erstellen, erstellen Sie nur Uhren in der Zukunft. Wenn Sie eine Uhr in der Vergangenheit erstellen, werden die Rechnungsbeträge nicht korrekt sein.

Test-Uhr mit UNIX-Zeitstempel erstellen:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/test_helpers/test_clocks \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d frozen_time=1577836800

Notieren Sie sich die ID der Test-Uhr. Erstellen Sie als Nächstes einen Testkunden/eine Testkundin mit der Uhr:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode email="test@example.com" \
  -d test_clock={{TEST_CLOCK_ID}}

Erstellen Sie ein Abrechnungsprofil:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/billing/profiles \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  --json '{
    "customer": "{{CUSTOMER_ID}}"
  }'

Erstellen Sie ein Abrechnungsintervall, um festzulegen, wann die Rechnung für den Kunden/die Kundin erstellt wird. Speichern Sie die ID.

Command Line
cURL
No results
curl -X POST https://api.stripe.com/v2/billing/cadences \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  --json '{
    "payer": {
        "billing_profile": "{{BILLING_PROFILE_ID}}"
    },
    "billing_cycle": {
        "type": "month",
        "interval_count": 3
    },
    "settings": {
        "collection": {
            "id": "{{COLLECTION_SETTINGS_ID}}"
        }
    }
  }'

Erstellen Sie ein Preisplan-Abonnement für die Testkundin/den Testkunden.

Erstellen Sie einen Abrechnungs-Intent, um die Status des Preisplan Abonnements nachzuverfolgen. Zuerst erstellen Sie einen Entwurf für den Abrechnungs-Intent. Speichern Sie die ID des Intents.

Command Line
cURL
No results
curl -X POST https://api.stripe.com/v2/billing/intents \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  --json '{
    "currency": "usd",
    "cadence": "{{CADENCE_ID}}",
    "actions": {
        "type": "subscribe",
        "subscribe": {
            "type": "pricing_plan_subscription_details",
            "pricing_plan_subscription_details": {
                "pricing_plan": "{{PRICING_PLAN_ID}}",
                "pricing_plan_version": "{{PRICING_PLAN_VERSION}}"
            }
        }
    }
  }'

Als Nächstes nehmen Sie eine Rückstellung des Abrechnungs-Intents vor:

Command Line
cURL
No results
curl -X POST https://api.stripe.com/v2/billing/intents/{{BILLING_INTENT_ID}}/reserve \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}"

Als nächstes bestätigen Sie die Abrechnungsabsicht, um das Abo für den Preisplan zu aktivieren und der Kundin bzw. dem Kunden die Rechnung gemäß Plan und Zeitraum zu stellen. (Wenn Sie die Einstellungen für den Einzug auf automatic gesetzt haben, müssen Sie einen erfolgreichen PaymentIntent haben, um den Intent zu bestätigen. Wenn Sie die Einstellungen für den Einzug auf send_invoice eingestellt haben, brauchen Sie die Zahlungsabsicht nicht zu übergeben).

Command Line
cURL
No results
curl https://api.stripe.com/payment_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount={{AMOUNT}} \
  -d currency={{CURRENCY}} \
  -d customer={{CUSTOMER_ID}} \
  -d payment_method={{PM_ID}} \
  -d return_url="example.com" \
  -d confirm=true

Zu Testzwecken können Sie payment_method auf „pm_card_visa“ setzen.

Command Line
cURL
No results
curl -X POST https://api.stripe.com/v2/billing/intents/{{BILLING_INTENT_ID}}/commit \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  --json '{
    "payment_intent": "{{PAYMENT_INTENT_ID}}"
  }'

Bezahlen Sie die durch das Abonnement generierte Rechnung. Nachdem die Rechnung bezahlt wurde, können Sie die Nutzung simulieren und die Uhr vorstellen, wodurch die Abrechnung für den nächsten Monat ausgelöst wird. Wenn Sie Checkout verwenden, können Sie die url der zurückgegebenen Checkout-Sitzung in Ihrem Browser öffnen und die Zahlung mit einer Testkarte abschließen.

Zeichnen Sie einige Testnutzungen auf:

Command Line
cURL
No results
curl -X POST https://api.stripe.com/v2/billing/meter_events \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  --json '{
    "event_name": "hypernian_tokens",
    "payload": {
        "stripe_customer_id": "{{CUSTOMER_ID}}",
        "value": 100
    }
  }'

Stellen Sie die eingefrorene Zeit der Test-Uhr um einen Monat vor. In diesem Beispiel hat die Test-Uhr derzeit einen Zeitstempel von 1577836800. Um einen Monat hinzuzufügen, fügen Sie 30 * 24 * 60 * 60 oder 2592000 Sekunden hinzu. Der neue Zeitstempel in einem Monat ist 1580428800.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/test_helpers/test_clocks/{{TEST_CLOCK_ID}}/advance \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d frozen_time=1580428800

OptionalSteuern einziehen

Um Steuern automatisch einzuziehen, erstellen Sie eine Checkout-Sitzung, die checkout_items enthält, und legen Sie automatic_tax.enabled auf „true“ fest.

Command Line
cURL
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-09-30.preview;checkout_product_catalog_preview=v1" \
  -d customer={{CUSTOMER_ID}} \
  -d "checkout_items[0][type]"=pricing_plan_subscription_item \
  -d "checkout_items[0][pricing_plan_subscription_item][pricing_plan]"={{PRICING_PLAN_ID}} \
  -d success_url={{SUCCESS_URL}}

Auf der Seite werden die Details Ihres Preisplans angezeigt und die Zahlungen der Kunden erfasst. Nachdem die Kunden die Sitzung abgeschlossen hat, werden sie an die URL weitergeleitet, die Sie für success_url angegeben haben.

OptionalRichten Sie das Kundenportal ein

Sie können Ihren Kund/innen Self-Service-Funktionen anbieten, indem Sie ein Kundenportal einrichten.

Die Verwendung des Kundenportals mit Tarifabonnements ist derzeit nur im Lesemodus möglich: Kund/innen können ihre Zahlungsmethoden für Tarifabonnements nicht kündigen oder Pläne ändern oder aktualisieren. Derzeit können Sie ein Kundenportal nur über das Dashboard konfigurieren.

Wenn das Kundenportal mit Tarifabonnements verwendet wird, können Ihre Kund/innen Folgendes einsehen:

  • Der abonnierte Plan, einschließlich Details zu dem von Ihnen angebotenen Hybridplan.
  • Anstehende Rechnungen helfen zu verstehen, was den Kund/innen am Ende des Monats in Rechnung gestellt wird.
  • Die für das betreffende Abo hinterlegte Zahlungsmethode.
  • Frühere Rechnungen, die ihnen gestellt wurden.
  • Die Rechnungsinformationen der Kund/innen.