Sie möchten migrieren? Ihre bestehende Integration können Sie weiter nutzen, neue Funktionen werden jedoch nicht unterstützt. Alle neuen Pläne oder wiederkehrenden Preise, die Sie erstellen, können über den Parameter plan Ihrer bestehenden API-Aufrufe genutzt werden.
Produkt- und Preisübersicht
Preise sind eine neue, grundlegende Größe in Stripe. Sie funktionieren mit Abonnements, Rechnungen und Checkout. Jeder Preis ist mit einem einzelnen Produkt verknüpft und jedes Produkt kann mehrere Preise haben. Verschiedene physische Waren oder Servicestufen sollten durch Produkte repräsentiert werden. Die Preisgebung für dieses Produkt sollte dann durch die Preise repräsentiert sein.
Diese Preise definieren den Grundpreis, die Währung und—für wiederkehrende Produkte—den Abrechnungszyklus. So können Sie Preise ändern und hinzufügen, ohne immer die Details Ihrer angebotenen Produkte verändern zu müssen. So können Sie also beispielsweise ein einzelnes „Gold“-Produkt zum Preis von 10 US$ pro Monat, 100 US$ im Jahr, 9 EUR pro Monat und 90 EUR pro Jahr anbieten. Oder Sie bieten ein T-Shirt in blau für 20 US$ und 15 EUR an.
Pläne und SKUs (client-only) lassen sich mit der neuen Integration verwenden, sofern Prices akzeptiert werden. Sie können entweder ein Produkt und einen Preis über die API oder über das Dashboard anlegen.
Einmalzahlungen
Für die Client- und Serverintegration gelten folgende Änderungen für Einmalzahlungen:
Statt Ad-hoc-Posten (d. h. Einstellung des Namens, Betrags und der Währung), müssen Sie für eine Checkout-Sitzung ein Produkt erstellen und in der Regel auch einen Preis.
Statt jedes Feld eines line_items zu definieren, nutzt Checkout die zugrunde liegenden Produkt- und Preisobjekte, um Namen, Beschreibung, Betrag, Währung und Bilder zu ermitteln. Sie können Produkte und Preise mit der API oder mit dem Dashboard erstellen.
Ohne Preise
Mit Preisen
line_items.name
product.name
line_items.description
product.description
line_items.amount
price.unit_amount
price_data.unit_amount (wenn zum Zeitpunkt der Erstellung der Checkout Session definiert)
line_items.currency
price.currency
price_data.currency (wenn zum Zeitpunkt der Erstellung der Checkout Session definiert)
line_items.images
product.images (zeigt das erste eingestellte Bild)
Serverseitiger Code für Inline-Items
Bisher konnten Sie nur einmalige Artikel inline erstellen. Mit Preisen können Sie weiterhin Ihre Artikel inline konfigurieren, sie können aber darüber hinaus auch mit price_data Ihre Preise dynamisch definieren, wenn Sie die Checkout Session erstellen.
Wenn Sie die Checkout Session mit price_data erstellen, verweisen Sie auf eine bestehende Produkt-ID mit price_data.product oder definieren Sie Ihre Produktdaten dynamisch mit price_data.product_data. Das folgende Beispiel zeigt den Workflow für die Erstellung eines Einmal-Artikels.
Mit der neuen Integration können Sie im Vorfeld einen Produkt- und Preiskatalog anlegen und müssen nicht stattdessen jedes Mal, wenn Sie eine Checkout-Sitzung erstellen, einen Betrag, eine Währung und einen Namen festlegen.
Sie können ein Produkt und einen Preis entweder mit der Prices API oder über das Dashboard anlegen. Um eine Checkout Session zu erstellen, brauchen Sie die Preis-ID. Das folgende Beispiel zeigt, wie Sie ein Produkt und einen Preis über die API anlegen:
Für die Client- und Server-Integration gelten folgende Änderungen für wiederkehrende Zahlungen:
Alle Artikel werden an ein einziges line_items-Feld übergeben, statt an subscription_data.items.
mode ist nun ein Pflichtfeld. Setzen Sie mode=subscription, wenn die Session nur wiederkehrende Artikel enthält.
Der Code der Client-Seite bleibt derselbe. Bestehende Pläne können überall dort verwendet werden, wo Preise akzeptiert werden.
Serverseitiger Code für Pläne
Hier ein „Vorher-Nachher“-Beispiel zur Erstellung einer Checkout Session mit einer Testversion und mit einem bestehenden Plan, für die jeweils alternativ auch einfach ein Preis festgelegt werden kann. Der Plan wird dann an line_items übergeben, anstatt an subscription_data.items.
Serverseitiger Code für wiederkehrenden Preis mit Einrichtungsgebühr
Wenn Sie wiederkehrende Pläne mit einer einmaligen Einrichtungsgebühr haben, erstellen Sie das Produkt und den Preis, der die Einmalgebühr repräsentiert, bevor Sie die Checkout Session anlegen. In der Zuweisungstabelle finden Sie Informationen darüber, wie die alten line_items-Felder in der neuen Integration zugewiesen werden. Sie können Produkt und Preis entweder über die Prices API oder das Stripe-Dashboard anlegen. Alternativ können Sie auch Einmal-Artikel inline anlegen. Das folgende Beispiel nutzt eine bestehende Preis-ID:
Statt einer Auflistung mit display_items nutzt das Checkout Session-Objekt line_items. Das Feld line_items wird nicht automatisch dargestellt, wie es bei display_items der Fall war, sondern Sie können es mit Erweitern bei Erstellung einer Checkout Session einbinden:
Da line_items einbindbar ist, listet der Webhookcheckout.session.completed die Artikel nicht mehr standardmäßig auf. Das kleinere Antwortobjekt ermöglicht es Ihnen, Ihre Checkout-Webhooks schneller zu empfangen. Mit dem neuen line_items-Endpoint können Sie Ihre Artikel abrufen:
Welcome to the Stripe Shell!
Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Log in to your
Stripe account and press Control + Backtick (`) on your keyboard to start managing your Stripe
resources in test mode.
- View supported Stripe commands:
- Find webhook events:
- Listen for webhook events:
- Call Stripe APIs: stripe [api resource] [operation] (e.g., )
Stripe Shell wurde für die Verwendung am Desktop konzipiert.