# Produkte und Preise verwalten So verwalten Sie Produkte und Preise. Produkte und Preise können Sie über das Dashboard oder die API erstellen und aktualisieren. Für einige fortgeschrittene Anwendungsfälle, wie beispielsweise [die Erstellung variabler Preise](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#variable-pricing), ist die Verwendung der API erforderlich. Nutzen Sie die API, wenn Sie über eine große Anzahl von Produkten und Preisen verfügen oder wenn Sie eine [benutzerdefinierte Integration mit Elements erstellen](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md?payment-ui=elements). - Erstellen und verwalten Sie Produkte und Preise mithilfe der [Dashboard](https://dashboard.stripe.com/test/products), wenn Sie keinen Code schreiben möchten oder nur wenige Produkte und Preise haben. Richten Sie Ihr *Preismodell* (The pricing model consists of the products or services you sell, how much they cost, what currency you accept for payments, and the service period to charge (for subscriptions). To build the pricing model, you use Products—what you sell—and Prices—how much and how often to charge for your products) in einer Sandbox ein und klicken Sie auf der Produktdetailseite auf die Schaltfläche **In den Live-Modus kopieren**. - Für die Verwaltung und Erstellung können Sie die [API](https://docs.stripe.com/api.md) oder die [Stripe-CLI](https://docs.stripe.com/stripe-cli.md) verwenden. Die API ist eine direkte Methode für die Nutzung von Produktionsumsetzungen. Die Stripe CLI ist ein Entwickler-Tool, mit dem Sie Ihre Integration mit Stripe direkt von Ihrem Terminal aus erstellen, testen und verwalten können. Die folgenden API-Schritte veranschaulichen ein Beispiel für eine Software-as-a-Service-Plattform, die eine monatliche Abonnementgebühr sowie eine einmalige Einrichtungsgebühr berechnet. ## Ein Produkt erstellen #### Dashboard ### Produkt und Preis erstellen #### Produkt erstellen Um ein Produkt im Dashboard zu erstellen: 1. Gehen Sie zu **Mehr** > **Produktkatalog**. 1. Klicken Sie auf **+Produkt hinzufügen**. 1. Geben Sie den **Namen** Ihres Produkts ein. 1. (Optional) Fügen Sie eine **Beschreibung** hinzu. Die Beschreibung erscheint während des Bezahlvorgangs, im [Kundenportal](https://docs.stripe.com/customer-management.md) und in [Angeboten](https://docs.stripe.com/quotes.md). 1. (Optional) Fügen Sie ein **Bild** Ihres Produkts hinzu. Verwenden Sie eine JPEG-, PNG- oder WEBP-Datei, die kleiner als 2 MB ist. Das Bild wird beim Bezahlvorgang angezeigt. 1. (Optional) Wenn Sie [Stripe Tax](https://docs.stripe.com/tax.md) verwenden, wählen Sie einen **Steuercode** für Ihr Produkt aus. Weitere Informationen zur entsprechenden Kategorie für Ihr Produkt finden Sie unter [Steuercodes](https://docs.stripe.com/tax/tax-codes.md). 1. (Optional) Geben Sie eine **Zahlungsbeschreibung in der Abrechnung** ein. Diese Beschreibung überschreibt alle Kontobeschreibungen für wiederkehrende Zahlungen. Wählen Sie eine Bezeichnung, die Ihre Kundinnen und Kunden auf einem Kontoauszug erkennen würden. 1. (Optional) Geben Sie eine **Artikelbezeichnung** ein. Hier wird beschrieben, wie Sie Ihr Produkt verkaufen. Wenn Sie beispielsweise nach Nutzer/in berechnen, geben Sie „Nutzer/in“ ein, damit der Einzelposten die Bezeichnung „pro Nutzer/in“ für den Preis enthält. Artikelbezeichnungen erscheinen beim Bezahlvorgang, auf Rechnungen, Quittungen und im *Kundenportal* (The customer portal is a secure, Stripe-hosted page that lets your customers manage their subscriptions and billing details). #### Preis für das Produkt erstellen Um ein Produkt im Dashboard zu speichern, müssen Sie außerdem mindestens einen Preis hinzufügen. Der Produkteditor zeigt standardmäßig das Pauschalpreismodell an. Mit den **Erweiterten Preisoptionen** können Sie mehrere Preise erstellen oder ein anderes Preismodell verwenden. 1. Wählen Sie ein **Preismodell** aus. Weitere Informationen zu wiederkehrenden Preismodellen finden Sie im [Leitfaden für Preismodelle](https://docs.stripe.com/products-prices/pricing-models.md). - **Pauschalpreise**: Sie berechnen für jede Einheit denselben Preis. Wenn Sie diese Option verwenden, wählen Sie **Einmalig** oder **Wiederkehrend**. - **Paketpreise**: Sie berechnen Paketpreise oder Preise für Einheitengruppen, wie z. B. 25 USD für 5 Einheiten. Standardmäßig werden Käufe aufgerundet, sodass bei einem Kauf von 8 Einheiten 50 USD fällig werden. - **Gestaffelte Preise**: Verwenden Sie Preisstufen, um Einheiten einer Bestellung günstiger zu gestalten. So berechnen Sie z. B. für die ersten 100 Einheiten 10 USD je Einheit und anschließend 5 USD je Einheit für die nächsten 50 Einheiten. Wenn Sie diese Option nutzen möchten, wählen Sie die Währung für den Preis und füllen Sie die Staffelungstabelle aus. - **Volumenpreisgestaltung**: Berechnen Sie denselben Preis für jede Einheit basierend auf der Gesamtmenge, die Sie verkaufen. Berechnen Sie z. B. 10 USD je Einheit für 50 Einheiten und 7 USD je Einheit für 100 Einheiten. Wählen Sie die Währung für den Preis und füllen Sie die Staffelungstabelle aus, wenn Sie diese Option nutzen. - **Kundenseitige Preisfestlegung**: Der/die Zahler/in entscheidet über den Betrag, den er/sie für Ihr Produkt, Ihre Dienstleistung oder Ihr Anliegen zahlt. **Kundenseitige Preisfestlegung** ist nur mit Checkout und Payment Links kompatibel. - **Nutzungsbasierte Preisgestaltung**: Berechnen Sie Ihren Kundinnen und Kunden die Kosten basierend darauf, wie viel Ihres Services sie im Rechnungsstellungszeitraum nutzen. 1. (Optional) Wenn Sie in mehreren Währungen verkaufen, klicken Sie auf **Weitere Währung hinzufügen**, um festzulegen, wie viel in jeder Währung berechnet werden soll. 1. Wählen Sie eine **Rechnungsfrist** für Preise für wiederkehrende Verkäufe. Sie können eine selbst gewählte Zeitspanne angeben, wenn Ihnen keine der vorgegebenen zusagt. 1. Wählen Sie, ob **Steuern im Preis inbegriffen sein sollen**. Hier erfahren Sie mehr über [Steuern und Abos](https://docs.stripe.com/billing/taxes/collect-taxes.md). 1. (Optional) Geben Sie eine **Preisbeschreibung** ein. Kundinnen und Kunden sehen diese Beschreibung nicht. 1. (Optional) Klicken Sie auf **Erweiterte Preisoptionen**, wenn Sie mehrere Preise für Ihr Produkt festlegen möchten. 1. Klicken Sie auf **Produkt hinzufügen**, um das Produkt und den Preis zu speichern. Sie können [Ihre Auswahl später bearbeiten](https://docs.stripe.com/products-prices/manage-prices.md#edit-product). #### API Um ein einzelnes Produkt und einen Preis zu erstellen: ```curl curl https://api.stripe.com/v1/products \ -u "<>:" \ -d "name=Basic Dashboard" \ -d "default_price_data[unit_amount]=1000" \ -d "default_price_data[currency]=usd" \ -d "default_price_data[recurring][interval]=month" \ -d "expand[]=default_price" ``` Bei der erstmaligen Anmeldung für diesen Service wird den Kundinnen und Kunden zusätzlich eine Einrichtungsgebühr berechnet. Um die Gebühr als Produkt und Preis zu erstellen, stellen Sie dieselbe Anfrage mit einem anderen Produktnamen und anderen Preisdaten: ```curl curl https://api.stripe.com/v1/products \ -u "<>:" \ -d "name=Starter Setup" \ -d "default_price_data[unit_amount]=2000" \ -d "default_price_data[currency]=usd" \ -d "expand[]=default_price" ``` ## Produkt bearbeiten #### Dashboard Um ein Produkt im Dashboard zu bearbeiten: 1. Gehen Sie zu **Mehr** > **Produktkatalog**. 1. Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü (⋯) und dann auf **Produkt bearbeiten**. 1. Nehmen Sie die gewünschten Änderungen am Produkt vor. 1. Klicken Sie auf **Produkt speichern**. Sie können Produkte auch auf der Produktinformationsseite bearbeiten, indem Sie auf das Erweiterungsmenü (⋯) oder auf **Bearbeiten** klicken. #### API Um ein Produkt über die API zu bearbeiten: ```curl curl https://api.stripe.com/v1/products/id \ -u "<>:" \ -d "name=Updated Product" ``` ## Ein Produkt archivieren Wenn Sie ein Produkt deaktivieren möchten, damit es nicht mehr zu neuen Rechnungen oder Abonnements hinzugefügt werden kann, können Sie es archivieren. Wenn Sie ein Produkt archivieren, bleiben alle bestehenden Abonnements, die auf ein Produkt angewendet werden, aktiv, bis sie gekündigt werden. Alle bestehenden Zahlungslinks, die auf ein Produkt angewendet werden, werden deaktiviert. Sie können Produkte, denen ein Preis zugeordnet ist, nicht löschen, aber Sie können sie archivieren. #### Dashboard Um ein Produkt zu archivieren: 1. Gehen Sie zu **Mehr** > **Produktkatalog**. 1. Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü (⋯) und dann auf **Produkt archivieren**. Um ein Produkt zu dearchivieren: 1. Navigieren Sie zur Registerkarte **Archiviert** auf der Seite **Produktkatalog**\>**Übersicht**. 1. Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü (⋯) und dann auf **Produkt dearchivieren**. Sie können auch ein Produkt aus der Produktinformationsseite dearchivieren. #### API Um ein Produkt über die API zu archivieren (um beispielsweise zu signalisieren, dass er nicht zum Kauf verfügbar ist), ändern Sie den Parameter [aktiv](https://docs.stripe.com/api/products/update.md#update_product-active) in `false`. ```curl curl https://api.stripe.com/v1/products \ -u "<>:" \ -d active=false \ -d "name=My product" ``` Um die Archivierung eines Produkts über die API aufzuheben (um beispielsweise zu signalisieren, dass es nicht zum Kauf verfügbar ist), ändern Sie den Parameter [aktiv](https://docs.stripe.com/api/products/update.md#update_product-active) in `true`. ```curl curl https://api.stripe.com/v1/products/id \ -u "<>:" \ -d active=true ``` ## Produkt löschen Sie können nur Produkte löschen, denen keine Preise zugeordnet sind. Alternativ können Sie [ein Produkt archivieren](https://docs.stripe.com/products-prices/manage-prices.md#archive-product). #### Dashboard Wenn einem Produkt ein Preis zugeordnet ist, müssen Sie den Preis [löschen](https://docs.stripe.com/products-prices/manage-prices.md#delete-price) oder [archivieren](https://docs.stripe.com/products-prices/manage-prices.md#archive-price), bevor Sie das Produkt löschen können. Stripe zeichnet den Preis und das Produkt für historische Transaktionen auf. Um ein Produkt dauerhaft zu löschen: 1. Gehen Sie zu **Mehr** > **Produktkatalog**. 1. Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü (⋯) und dann auf **Produkt löschen**. #### API Verwenden Sie [Produkt löschen](https://docs.stripe.com/api/products/delete.md), um ein Produkt dauerhaft über die API zu löschen. ```curl curl -X DELETE https://api.stripe.com/v1/products/{{PRODUCT_ID}} \ -u "<>:" ``` ## Preis erstellen Sie können einzelne oder mehrere Preise für ein Produkt erstellen. Beispielsweise kann eine „Starter“-Stufe für 10 USD pro Monat, 100 USD pro Jahr oder 9 EUR als einmaliger Kauf angeboten werden. > Nachdem Sie einen Preis erstellt haben, können Sie nur die Felder `metadata`, `nickname`, and `active` aktualisieren. #### Dashboard Um einen Preis im Dashboard zu erstellen, müssen Sie zuerst ein [Produkt erstellen](https://docs.stripe.com/products-prices/manage-prices.md#create-product). Anschließend können Sie einen Preis erstellen: 1. Wählen Sie ein **Preismodell** aus. Weitere Informationen zu wiederkehrenden Preismodellen finden Sie im [Leitfaden für Preismodelle](https://docs.stripe.com/products-prices/pricing-models.md). - **Pauschalpreise**: Sie berechnen für jede Einheit denselben Preis. Wenn Sie diese Option verwenden, wählen Sie **Einmalig** oder **Wiederkehrend**. - **Paketpreise**: Sie berechnen Paketpreise oder Preise für Einheitengruppen, wie z. B. 25 USD für 5 Einheiten. Standardmäßig werden Käufe aufgerundet, sodass bei einem Kauf von 8 Einheiten 50 USD fällig werden. - **Gestaffelte Preise**: Verwenden Sie Preisstufen, um Einheiten einer Bestellung günstiger zu gestalten. So berechnen Sie z. B. für die ersten 100 Einheiten 10 USD je Einheit und anschließend 5 USD je Einheit für die nächsten 50 Einheiten. Wenn Sie diese Option nutzen möchten, wählen Sie die Währung für den Preis und füllen Sie die Staffelungstabelle aus. - **Volumenpreisgestaltung**: Berechnen Sie denselben Preis für jede Einheit basierend auf der Gesamtmenge, die Sie verkaufen. Berechnen Sie z. B. 10 USD je Einheit für 50 Einheiten und 7 USD je Einheit für 100 Einheiten. Wählen Sie die Währung für den Preis und füllen Sie die Staffelungstabelle aus, wenn Sie diese Option nutzen. - **Kundenseitige Preisfestlegung**: Der/die Zahler/in entscheidet über den Betrag, den er/sie für Ihr Produkt, Ihre Dienstleistung oder Ihr Anliegen zahlt. **Kundenseitige Preisfestlegung** ist nur mit Checkout und Payment Links kompatibel. - **Nutzungsbasierte Preisgestaltung**: Berechnen Sie Ihren Kundinnen und Kunden die Kosten basierend darauf, wie viel Ihres Services sie im Rechnungsstellungszeitraum nutzen. 1. (Optional) Wenn Sie in mehreren Währungen verkaufen, klicken Sie auf **Weitere Währung hinzufügen**, um festzulegen, wie viel in jeder Währung berechnet werden soll. 1. Wählen Sie eine **Rechnungsfrist** für Preise für wiederkehrende Verkäufe. Sie können eine selbst gewählte Zeitspanne angeben, wenn Ihnen keine der vorgegebenen zusagt. 1. Wählen Sie, ob **Steuern im Preis inbegriffen sein sollen**. Hier erfahren Sie mehr über [Steuern und Abos](https://docs.stripe.com/billing/taxes/collect-taxes.md). 1. (Optional) Geben Sie eine **Preisbeschreibung** ein. Kundinnen und Kunden sehen diese Beschreibung nicht. 1. Klicken Sie auf **Preis erstellen**, um den Preis zu speichern. Sie können den [Preis später bearbeiten](https://docs.stripe.com/products-prices/manage-prices.md#edit-price). #### API Verwenden Sie [Preis erstellen](https://docs.stripe.com/api/prices/create.md)., um Preise über die API zu erstellen. In diesem Beispiel berechnet der Dienst 10 USD pro Monat für eine „Starter“-Service-Stufe. Der Parameter `unit_amount` verwendet die niedrigste Einheit der für den Preis angegebenen Währung. In diesem Fall ist die niedrigste Einheit Cent: 10 USD sind 1.000 Cent, also ist der `unit_amount` ihres Preises `1000`. Um den Preis zu erstellen und ihm dem Produkt zuzuordnen, übergeben Sie die Produkt-ID, den Einheitsbetrag, die Währung und das Intervall: ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "product={{PRODUCT_ID}}" \ -d unit_amount=1000 \ -d currency=usd \ -d "recurring[interval]=month" ``` Die Einrichtungsgebühr für neue Kund/innen beträgt 20 USD. Da Sie diese Zahlung separat vom Abonnement und nur einmal abbuchen, müssen Sie das `interval` nicht übergeben. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "product={{PRODUCT_ID}}" \ -d unit_amount=2000 \ -d currency=usd ``` ### Als Standardpreis festlegen Der Standardpreis eines Produkts ist der häufigste Preis, den Sie Ihren Kund/innen präsentieren möchten. Beispielsweise könnte ein Produkt mehrere Preise für saisonale Verkäufe haben, aber der Standardpreis ist der reguläre (Nicht-Angebots-) Preis. Wenn Sie ein Produkt im [Dashboard](https://dashboard.stripe.com/products) erstellen, wird dieser Anfangspreis als Standardpreis festgelegt. Der Standardpreis muss ein [aktiver](https://docs.stripe.com/api/prices/object.md#price_object-active) Preis sein. #### Dashboard So ändern Sie den Standardpreis Ihres Produkts im Dashboard: 1. Gehen Sie zu **Mehr** > **Produktkatalog**. 1. Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü (⋯) und dann auf **Produkt bearbeiten**. 1. Suchen Sie im Abschnitt **Preisinformationen** den Preis, den Sie als neuen Standardpreis festlegen möchten, und klicken Sie dann auf **Als Standardpreis festlegen**. 1. Klicken Sie auf **Produkt speichern**. So erstellen Sie einen neuen Preis und machen ihn zum neuen Standardpreis im Dashboard: 1. Gehen Sie zu **Mehr** > **Produktkatalog**. 1. Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie darauf, um die Seite mit den Produktinformationen zu öffnen. 1. Klicken Sie im Abschnitt **Preisgestaltung** auf die Schaltfläche **Weiteren Preis hinzufügen**. 1. Geben Sie Ihre Preisdetails ein und wählen Sie **Als Standardpreis festlegen**. Lesen Sie mehr über die verfügbaren Felder beim [Erstellen eines Preises](https://docs.stripe.com/products-prices/manage-prices.md#create-price). 1. Klicken Sie auf **Preis hinzufügen**. #### API ```curl curl https://api.stripe.com/v1/products/{{PRODUCT_ID}} \ -u "<>:" \ -d "default_price={{PRICE_ID}}" ``` ### Erstellen Sie einen Inline-Preis Um einen [Inline-Preis](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#inline-pricing) zu erstellen, übergeben Sie beim Erstellen einer einmaligen Zahlung oder eines Abonnements `price_data` anstelle einer `price.id`. So funktioniert beispielsweise ein monatliches Abonnement für eine Kundin/einen Kunden mit einem Inline-Preis: ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price_data][unit_amount]=5000" \ -d "items[0][price_data][currency]=usd" \ -d "items[0][price_data][product]={{PRODUCT_ID}}" \ -d "items[0][price_data][recurring][interval]=month" ``` Dies erstellt einen monatlich wiederkehrenden Preis von 50 USD für das Basis-Serviceangebot. Inline-Preise können nach ihrer Erstellung nicht aktualisiert oder erneut verwendet werden. Standardmäßig werden Preise, die mit `price_data` erstellt wurden, automatisch archiviert (sie sind als `active=false` markiert). Sie können `price_data` auch mit [Checkout Sessions](https://docs.stripe.com/api/checkout/Sessions.md), [Payment Links](https://docs.stripe.com/api/payment-Link.md), [Invoice Items](https://docs.stripe.com/api/invoiceitems.md), und [Subscription Schedules](https://docs.stripe.com/api/Abonnement_schedules.md) verwenden. ### Preise in mehreren Währungen erstellen Sie können [Preise mit mehreren Währungen](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#multiple-currencies) in der [API](https://docs.stripe.com/api/prices/create.md) oder im Dashboard erstellen. #### Dashboard So erstellen Sie einen Preis mit mehreren Währungen über das Dashboard: 1. Gehen Sie zum [Produktkatalog](https://dashboard.stripe.com/test/products) und wählen Sie ein Produkt aus. 1. Klicken Sie auf **Produkt bearbeiten**. 1. Klicken Sie auf **+ Weiteren Preis hinzufügen**, um einen neuen Preis zu erstellen. Die Standardwährung ist die erste Währung auf Ihrem Preis. Alle Ihre Preise müssen die gleiche Standardwährung haben. 1. Um Ihrem Preis eine neue Währungsoption hinzuzufügen, klicken Sie auf **+ Preis nach Währung hinzufügen**. Suchen Sie in der Liste nach unterstützten Währungen und wählen Sie diese aus. - Stripe schlägt einen Wechselkurs vor, der auf den Währungswerten um 12:00 Uhr EST basiert, Sie können aber auch Ihren eigenen auswählen. Für Währungen, die größeren Schwankungen unterliegen, empfehlen wir, einen größeren Puffer hinzuzufügen. 1. Um den neuen Preis zu speichern, klicken Sie auf **Weiter** > **Produkt aktualisieren**. #### API Der Parameter [currency](https://docs.stripe.com/api/prices/create.md#create_price-currency) legt die Standardwährung für Ihren Preis fest. Alle Ihre Preise müssen die gleiche Standardwährung haben. Der Parameter [currency_options](https://docs.stripe.com/api/prices/create.md#create_price-currency_options) legt fest, welche anderen Währungen der Preis unterstützt. Dieser Codeausschnitt zeigt, wie ein Preis erstellt wird, der `usd`(US-Dollar) als Standardwährung sowie `eur` (Euro) und `jpy` (Japanischer Yen) unterstützt. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d unit_amount=1000 \ -d currency=usd \ -d product={{PRODUCT_ID}} \ -d "currency_options[eur][unit_amount]=9000" \ -d "currency_options[jpy][unit_amount]=12000" ``` [Gutscheine](https://docs.stripe.com/billing/subscriptions/coupons.md#coupons), [Promo-Codes](https://docs.stripe.com/billing/subscriptions/coupons.md#promotion-codes) und [Versandraten](https://docs.stripe.com/payments/during-payment/charge-shipping.md) unterstützen mehrere Währungen auf ähnliche Weise wie Preise. #### Preise in mehreren Währungen rendern Um Ihren Kundinnen/Kunden den Preis in ihrer Währung anzuzeigen, können Sie diesen in mehreren Währungen abrufen und sein Feld [currency_options..unit_amount](https://docs.stripe.com/api/prices/object.md#price_object-currency_options-unit_amount) anzeigen. Die API-Antwort enthält standardmäßig keine `currency_options`. Um sie in die Antwort aufzunehmen, [erweitern](https://docs.stripe.com/api/expanding_objects.md) Sie das Feld `currency_options`: ```curl curl -G https://api.stripe.com/v1/prices/{{PRICE_ID}} \ -u "<>:" \ -d "expand[]=currency_options" ``` > Um die Latenz zu verbessern und Probleme mit der Ratenbegrenzung zu vermeiden, sollten Sie den Preis zwischenspeichern, statt ihn jedes Mal neu abzurufen, wenn eine Kundin/ein Kunde Ihre Website besucht. #### Preise in mehreren Währungen verwenden Bei jedem Kauf wird eine der vom Multi-Währungs-Preis unterstützten Währungen verwendet, je nachdem, wie Sie den Preis in Ihrer Integration verwenden. #### Stripe Checkout Checkout ermittelt die lokale Währung der Kundin/des Kunden automatisch anhand der IP-Adresse, sofern der Preis diese Währung unterstützt. Wenn die lokale Währung des Kunden/der Kundin nicht unterstützt wird, verwendet Checkout die Standardwährung für den Preis. Wenn in einer Checkout-Sitzung mehrere Preise, Gutscheine, Promo-Codes oder Versandkosten verwendet werden, müssen diese alle die lokale Währung der Kundin/des Kunden unterstützen, andernfalls verwendet Checkout die Standardwährung. Sie müssen alle die gleiche Standardwährung haben, sonst gibt Stripe beim Erstellen der Checkout-Sitzung einen Fehler zurück. Alternativ können Sie den Parameter [currency](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-currency) verwenden, um Checkout explizit anzuweisen, welche Währung verwendet werden soll. Erfahren Sie mehr über das Festlegen von [Preisen in manuellen Währungen](https://docs.stripe.com/payments/checkout/localize-prices/manual-currency-prices.md) im Bezahlvorgang. #### Payment Links Payment Links ermittelt die lokale Währung der Kundin/des Kunden automatisch anhand der IP-Adresse, sofern der Preis diese Währung unterstützt. Wenn die lokale Währung des Kunden/der Kundin nicht unterstützt wird, verwendet der Zahlungslink die Standardwährung für den Preis. Wenn der Zahlungslink mehrere Preise enthält, müssen diese alle die lokale Währung der Kundin/des Kunden unterstützen, andernfalls verwendet der Zahlungslink die Standardwährung. Alle Preise müssen die gleiche Standardwährung haben, sonst gibt Stripe beim Erstellen des Zahlungslinks einen Fehler zurück. Alternativ können Sie den Parameter [currency](https://docs.stripe.com/api/payment-link/create.md#create_payment_link-currency) verwenden, um dem Zahlungslink explizit mitzuteilen, welche Währung verwendet werden soll. #### Abonnements Sie können Abonnements auf verschiedene Arten erstellen. Wie Sie Preise mit mehreren Währungen verwenden können, hängt davon ab, wie Sie Abonnements erstellen: - Wenn Sie Abonnements mit Stripe Checkout erstellen, ermittelt Checkout die lokale Währung des Kunden/der Kundin automatisch anhand seiner IP-Adresse, sofern der Preis diese Währung unterstützt. Wenn die lokale Währung des Kunden/der Kundin nicht unterstützt wird, verwendet Checkout die Standardwährung für den Preis. Wenn Sie in einer einzigen Checkout-Sitzung mehrere Preise, Gutscheine, Promo-Codes oder Versandraten verwenden, müssen diese alle die lokale Währung des/der Kund/in unterstützen, und sie müssen alle die gleiche Standardwährung haben. - Wenn Sie Abonnements mit Stripe Elements erstellen, verwenden Sie den Parameter [currency](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-currency), um dem Abonnement mitzuteilen, welche Währung für den Preis verwendet werden soll. (Wenn Sie den Parameter `currency` weglassen, wird für das Abonnement die Standardwährung für den Preis verwendet.) - [Abonnementpläne](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md) unterstützt auch Preise in mehreren Währungen. Um einen Abonnementplan mit einem Preis in mehreren Währungen zu erstellen, verwenden Sie den Parameter [phases.currency](https://docs.stripe.com/api/subscription_schedules/create.md#create_subscription_schedule-phases-currency), um dem Zeitplan mitzuteilen, welche der Währungen für den Preis verwendet werden soll. (Wenn Sie den Parameter `phases.currency` weglassen, verwenden der Zeitplan und das vom Zeitplan verwaltete Abonnement die Standardwährung für den Preis.) #### Quotes Angebote unterstützen keine Preise in mehreren Währungen. Wenn Sie ein Angebot mit einem Preis in mehreren Währungen erstellen, verwendet das Angebot immer die Standardwährung für den Preis. #### Rechnungen Wenn Sie einen Rechnungsposten erstellen, verwenden Sie den Parameter [currency](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-currency), um den Rechnungsposten anzuweisen, welche der Währungen für den Preis mit mehreren Währungen verwendet werden soll. Sie müssen den Parameter `currency` explizit übergeben, auch wenn es sich um die Standardwährung der Kundin/des Kunden handelt. Wenn Sie den Parameter `currency` weglassen, funktionieren Preise in mehreren Währungen nicht. #### Migration von Preisen in einer Währung zu Preisen mit mehreren Währungen Wenn Sie bereits einen Preis in einer einzigen Währung haben, können Sie diesem nachträglich im Dashboard mehrere Währungen hinzufügen. Wenn Sie Checkout oder Payment Links verwenden, werden Preise in mehreren Währungen automatisch wirksam. Wenn Stripe erkennt, dass der Preis die lokale Währung des Kunden/der Kundin unterstützt, wird automatisch diese Währung verwendet. Wenn Sie mehrere Preise, Gutscheine, Promo-Codes oder Versandkosten in einem einzigen Kauf verwenden, dann müssen diese alle die lokale Währung des Kunden/der Kundin unterstützen, und sie müssen alle die gleiche Standardwährung haben. Wenn Sie Abonnements direkt erstellen, werden die Preise mit mehreren Währungen erst wirksam, wenn Sie den Parameter `currency` übergeben. Wenn Sie den Parameter `currency` nicht übergeben, verwendet das Abonnement immer die Standardwährung für den Preis. ### Suchschlüssel Die meisten Unternehmen zeigen ihre Preisinformationen auf ihrer Website an. Wenn diese Preise fest kodiert sind und Sie sie ändern möchten, muss dies oft manuell geschehen und Sie müssen dazu einen neuen Code bereitstellen. Für einen einfacheren Umgang mit diesen Szenarien können Sie die Eigenschaft [lookup_key](https://docs.stripe.com/api/prices/create.md#create_price-lookup_key) für das [Preisobjekt](https://docs.stripe.com/api/prices/object.md#price_object) verwenden. Mit diesem Schlüssel können Sie: - Verschiedene Preise in Ihrem Frontend rendern. - Kund/innen mit den gerenderten Preisen abrechnen. Sie können beim Erstellen eines Preises einen `lookup_key` übergeben. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "product={{PRODUCT_ID}}" \ -d unit_amount=1000 \ -d currency=usd \ -d "recurring[interval]=month" \ -d lookup_key=standard_monthly ``` Anstatt Text wie **10 USD pro Monat** auf Ihrer Preisseite fest zu kodieren und eine Preis-ID in Ihrem Backend zu verwenden, können Sie den Preis mit dem Schlüssel `standard_monthly` abfragen und diesen dann in Ihrem Frontend rendern: ```curl curl -G https://api.stripe.com/v1/prices \ -u "<>:" \ -d "lookup_keys[]=standard_monthly" ``` > Um die Leistung zu verbessern, könnten Sie eine Caching-Schicht hinzufügen, um den Preis nur gelegentlich neu zu laden. Wenn ein Kunde/eine Kundin auf Ihre Zahlungs- oder Abonnementschaltfläche klickt, übergeben Sie den Preis von der `GET`-Anfrage in die Subscriptions API. Jetzt, da Sie verschiedene Preise rendern können und neuen Nutzer/innen 20 USD/Monat statt 10 USD/Monat berechnen möchten, müssen Sie nur einen neuen Preis erstellen und den Suchschlüssel mit [transfer_lookup_key=true](https://docs.stripe.com/api/prices/create.md#create_price-transfer_lookup_key) auf diesen neuen Preis übertragen: #### Runden Das Runden erfolgt auf der Ebene der *Rechnung* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)sposten. Wenn Sie z. B. einen Preis mit `unit_amount_decimal = 0.05` und ein Monatsabonnement für diesen [Preis] mit `quantity = 30` erstellen, erfolgt die Rundung nach dem Multiplizieren der Menge mit dem Dezimalbetrag. In diesem Fall würde die Summe `0.05 * 30 = 1.5` betragen und dann auf 2 Cent aufgerundet werden. Wenn mehrere Posten vorhanden sind, wird jeder gerundet, bevor der Gesamtbetrag für die Rechnung aufaddiert wird. Dadurch wird sichergestellt, dass den Kund/innen ein ganzzahliger Betrag mit einer kleinen Einheit berechnet wird, da Dezimalbeträge nur für die Preisbildung gelten. Exklusive Steuern werden je nach Steuersatz auf den Betrag des Einzelpostens aufgeschlagen. Wenn Sie [automatische Steuern](https://docs.stripe.com/tax/invoicing.md) aktivieren, werden exklusive Steuern angewendet und auf den Gesamtbetrag der Rechnung gerundet, einschließlich Rabatten auf Rechnungsebene. Wenn Sie manuelle Steuern entweder auf Einzelposten- oder auf Rechnungsebene verwenden, entscheiden Sie selbst, wie gerundet werden soll. In den [Rechnungseinstellungen](https://dashboard.stripe.com/settings/billing/invoice) Ihres Dashboards können Sie die Steuern entweder für die einzelnen Rechnungsposten oder auch für die gesamte Zwischensumme der Rechnung anwenden und runden. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "product={{PRODUCT_ID}}" \ -d unit_amount=2000 \ -d currency=usd \ -d "recurring[interval]=month" \ -d lookup_key=standard_monthly \ -d transfer_lookup_key=true ``` ## Einen Preis bearbeiten Mehrere Eigenschaften können für einen Preis entweder im Dashboard oder in der API aktualisiert werden. Sie können beispielsweise ändern, ob der Preis aktiv ist, oder seine Metadaten ändern. Beachten Sie, dass Sie den Betrag eines Preises in der API nicht ändern können. Stattdessen empfehlen wir, einen neuen Preis für den neuen Betrag zu erstellen, zur ID des neuen Preises zu wechseln und dann den alten Preis auf inaktiv zu setzen. #### Dashboard Um einen Preis im Dashboard zu bearbeiten: 1. Gehen Sie zu **Mehr** > **Produktkatalog**. 1. Suchen Sie das Produkt, dessen Preis Sie ändern möchten, und klicken Sie darauf 1. Suchen Sie den Preis, den Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü (⋯) und dann auf **Preis bearbeiten**. 1. Nehmen Sie Ihre Preisänderungen vor. Sie können an dieser Stelle einen weiteren Preis hinzufügen. 1. Klicken Sie auf **Speichern**. #### API Um einen Preis über die API zu bearbeiten, verwenden Sie [einen Preis aktualisieren](https://docs.stripe.com/api/prices/update.md) und geben Sie den Parameter an, den Sie ändern möchten. Wenn Sie keinen Parameter angeben, bleibt er unverändert. ```curl curl https://api.stripe.com/v1/prices/id \ -u "<>:" \ -d lookup_key=MY_LOOKUP_KEY ``` ## Preis archivieren Wenn Sie einen Preis deaktivieren möchten, damit er nicht zu neuen Rechnungen oder Abonnements hinzugefügt werden kann, können Sie ihn archivieren. Wenn Sie einen Preis archivieren, bleiben alle bestehenden Abonnements, die diesen Preis verwenden, aktiv, bis sie gekündigt werden. Alle bestehenden Zahlungslinks, die auf ein Produkt angewendet werden, werden deaktiviert. #### Dashboard Um einen Preis im Dashboard zu ändern: 1. Gehen Sie zu **Mehr** > **Produktkatalog**. 1. Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü (⋯). 1. Suchen Sie auf der Produktinformationsseite nach dem Preis, den Sie ändern möchten, klicken Sie dann auf das Erweiterungsmenü (⋯) daneben und dann auf **Preis archivieren**. Um einen Preis zu dearchivieren: 1. Gehen Sie zu **Mehr** > **Produktkatalog**. 1. Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü (⋯). 1. Suchen Sie auf der Produktinformationsseite nach dem Preis, den Sie ändern möchten, klicken Sie dann auf das Erweiterungsmenü (⋯) daneben und dann auf **Preis dearchivieren**. #### API Um die API zum Dearchivieren eines Preises zu verwenden (d. h. um anzugeben, dass er nicht für neue Käufe verwendet werden kann), ändern Sie den Parameter [active](https://docs.stripe.com/api/prices/update.md#update_price-active) in `false`. ```curl curl https://api.stripe.com/v1/prices/id \ -u "<>:" \ -d lookup_key=MY_LOOKUP_KEY \ -d active=false ``` Um die API zum Dearchivieren eines Preises zu verwenden (d. h. um anzugeben, dass er für neue Käufe verwendet werden kann), ändern Sie den Parameter [active](https://docs.stripe.com/api/prices/update.md#update_price-active) in `true`. ```curl curl https://api.stripe.com/v1/prices/id \ -u "<>:" \ -d lookup_key=MY_LOOKUP_KEY \ -d active=true ``` ## Preis löschen Sie können nur Preise löschen, die Sie noch nie verwendet haben. Andernfalls können Sie sie [archivieren](https://docs.stripe.com/products-prices/manage-prices.md#archive-price). #### Dashboard Um einen Preis dauerhaft aus dem Dashboard zu löschen: 1. Gehen Sie zu **Mehr** > **Produktkatalog**. 1. Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü (⋯). 1. Suchen Sie auf der Produktinformationsseite nach dem Preis, den Sie ändern möchten, klicken Sie dann auf das Erweiterungsmenü (⋯) daneben und dann auf **Preis löschen**. #### API Sie können einen Preis nicht über die API löschen. Sie können einen Preis [archivieren](https://docs.stripe.com/products-prices/manage-prices.md#archive-price), um ihn als `active=false` zu kennzeichnen. Dies zeigt an, dass er nicht zum Kauf verfügbar ist. ## Preisinformationen anzeigen Nachdem Sie Produkte und Preise erstellt haben, können Sie eine [Preistabelle](https://docs.stripe.com/payments/checkout/pricing-table.md) auf Ihrer Website einbetten, um Ihren Kund/innen Preisinformationen anzuzeigen. Wenn Kund/innen eine Abonnementoption wählen, werden sie direkt zum Bezahlvorgang geleitet. Sie können Konfigurationen, Anpassungen und Aktualisierungen direkt im [Dashboard](https://dashboard.stripe.com/test/pricing-tables) vornehmen, ohne Code erstellen zu müssen. ## Produkte und Preise importieren Wenn Sie einen sehr umfangreichen Produktkatalog haben, verwenden Sie die [Products](https://docs.stripe.com/api/products.md) API, um Ihren Katalog programmgesteuert zu importieren. Beim Importieren Ihres Produktkatalogs in Stripe können Sie eine beliebige Datenquelle als Ausgangsquelle verwenden, z. B. ein Produktmanagementsystem oder eine CSV-Datei. Verwenden Sie die [Products](https://docs.stripe.com/api/products.md) API, um für jedes Produkt in Ihrem System ein Produkt in Stripe zu erstellen. Um Produkte in Ihrem System Produkten in Stripe zuzuordnen, weisen Sie jedem Produkt, das Sie importieren, eine eindeutige [ID](https://docs.stripe.com/api/products/create.md#create_product-id) zu. Verwenden Sie für jedes Produkt die [Prices](https://docs.stripe.com/api/prices.md) API, um einen entsprechenden Preis zu erstellen. Speichern Sie unbedingt die `ID` des neu erstellten Preises. Sie müssen diese `ID` übergeben, wenn Sie in Ihrer Integration [Produkte und Preise verwenden](https://docs.stripe.com/products-prices/manage-prices.md#use-products-and-prices-in-your-integration). Bestätigen Sie den Import, indem Sie das [Dashboard](https://dashboard.stripe.com/products) prüfen oder die API zum [Auflisten aller Produkte](https://docs.stripe.com/api/products/list.md) verwenden. ### Importierte Preise löschen Während der Entwicklungsphase müssen Sie dieses Skript ggf. mehrere Male zu Testzwecken ausführen. Wenn Sie die gleiche Produkt-ID verwenden, wird eine Fehlermeldung mit dem Hinweis angezeigt, dass ein Produkt mit dieser ID bereits vorhanden ist. Wenn Sie das Produkt noch nicht verwendet haben, können Sie es über das Stripe-Dashboard löschen: 1. Navigieren Sie im [Dashboard](https://dashboard.stripe.com/products) zu den Produkten und suchen Sie nach Ihrem Produkt. 1. Klicken Sie im Abschnitt **Preise** auf das Überlaufmenü (⋯ Overflow menu) neben dem Preis und wählen Sie **Preis löschen** aus. 1. Klicken Sie oben auf der Seite auf das Überlaufmenü (⋯ Overflow menu) und wählen Sie **Produkt löschen** aus. ### Produkte und Preise synchronisieren Möglicherweise müssen Sie einen Import mehrmals durchlaufen. Sie können ein Skript erstellen, um den Import zu testen und bei Bedarf Ihre ursprüngliche Datenquelle mit Stripe zu synchronisieren. Um Ihr Skript idempotent und fehlerresistent zu machen, können Sie auf sichere Weise versuchen, zuerst das Produkt zu erstellen und dann zu aktualisieren, wenn es bereits existiert. Um Ihren Produktkatalog mit Stripe zu synchronisieren, verwenden Sie Webhooks oder andere Mechanismen, um in Stripe Produktaktualisierungen auszulösen. Um [ein Produkt programmgesteuert zu aktualisieren](https://docs.stripe.com/api/products/update.md), verwenden Sie das folgende Muster. Suchen Sie zunächst mit der API zum [Auflisten aller Preise](https://docs.stripe.com/api/prices/list.md) nach dem vorhandenen Preis, um sicherzustellen, dass der Preis noch mit Ihrer Datenquelle übereinstimmt. Jedes Produkt sollte genau einen aktiven Preis haben. ```curl curl -G https://api.stripe.com/v1/prices \ -u "<>:" \ -d "product={{PRODUCT_ID}}" \ -d active=true ``` Prüfen Sie als Nächstes, ob sich der Dezimalbetrag des Preises geändert hat. Das [Feld](https://docs.stripe.com/api/prices/object.md#price_object-unit_amount_decimal)`unit_amount_decimal` zeigt den Betrag für Einheiten in Cent an. Wenn die Beträge nicht übereinstimmen, müssen Sie einen neuen Preis erstellen. Wenn Sie [einen neuen Preis erstellen](https://docs.stripe.com/api/prices/create.md), geben Sie die `product`-ID des ursprünglichen Produkts, die `currency` und den aktualisierten Preis für den `unit_amount` an. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "product={{PRODUCT_ID}}" \ -d unit_amount=2000 \ -d currency=usd ``` [Aktualisieren Sie den alten Preis](https://docs.stripe.com/api/prices/update.md) und kennzeichnen Sie ihn als `active=false`. ```curl curl https://api.stripe.com/v1/prices/{{PRICE_ID}} \ -u "<>:" \ -d active=false ``` ## Produkte und Preise in Ihrer Integration verwenden Sie können Produkte und Preise in verschiedenen Stripe-Integrationspfaden verwenden. #### Stripe Checkout Geben Sie beim Erstellen einer Checkout-Sitzung die Preis-ID an. - Wenn Sie einmalige Preise verwenden, lesen Sie den Artikel zum [Erstellen einer Checkout-Sitzung](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=stripe-hosted#redirect-customers) beim Akzeptieren einer Zahlung. - Wenn Sie Abos erstellen, erfahren Sie hier, [wie Sie beim Aufbau einer Abonnementintegration eine Checkout-Sitzung erstellen](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md?payment-ui=checkout&ui=stripe-hosted#create-session). #### Payment Links Wenn Sie Payment Links verwenden, besteht der nächste Schritt darin, ein Produkt [zum Erstellen eines Zahlungslinks auszuwählen](https://docs.stripe.com/payment-links/create.md). #### Abonnements Wenn Sie Abos mit Stripe Checkout erstellen, geben Sie beim Erstellen einer [Checkout-Sitzung](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md?payment-ui=checkout&ui=stripe-hosted#create-session) die Preis-ID an. Wenn Sie Abos mit Stripe Elements erstellen, geben Sie beim [Erstellen eines Abos](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md?payment-ui=elements&api-integration=checkout#create-session) die Preis-ID an. #### Quotes Wenn Sie Quotes verwenden, besteht der nächste Schritt darin, [beim Erstellen eines Angebots über das Dashboard](https://docs.stripe.com/quotes/create.md?testing-method=without-code) ein Produkt auszuwählen. Wenn Sie Ihre Quotes-Integration programmieren, geben Sie beim [Erstellen des Angebots](https://docs.stripe.com/quotes/create.md?testing-method=with-code#create-quote-code) die `price.id` an. #### Rechnungen Wenn Sie Invoices verwenden, besteht der nächste Schritt darin, beim Erstellen einer Rechnung über das [Dashboard](https://docs.stripe.com/invoicing/dashboard.md#create-invoice) ein Produkt auszuwählen. Wenn Sie die [API](https://docs.stripe.com/invoicing/integration.md#create-invoice-code) verwenden, geben Sie die `price.id` an. ## Tests Sie können Produkte aus einer Testumgebung in den Live-Modus kopieren, sodass Sie sie nicht neu erstellen müssen. Mit dem Produkt verknüpfte Preise werden ebenfalls kopiert. Klicken Sie auf der Produktdetailseite im Dashboard oben rechts auf **In den Live-Modus kopieren**. Sie können Testprodukte nur einmal in den Live-Modus kopieren. Wenn Sie nach dem Kopiervorgang Aktualisierungen am Testprodukt vornehmen, werden die Änderungen im Live-Produkt nicht widergespiegelt.