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 erweiterte Anwendungsszenarien, wie das Erstellen von variablen Preisen, müssen Sie die API verwenden. Verwenden Sie die API, wenn Sie eine große Anzahl von Produkten und Preisen haben oder wenn Sie mit Elements eine nutzerdefinierte Integration erstellen.

Erstellen und verwalten Sie Produkte und Preise mithilfe der Dashboard, wenn Sie keinen Code schreiben möchten oder nur wenige Produkte und Preise haben. Richten Sie Ihr Preismodell 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 oder die Stripe-CLI 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.

Bei den folgenden API-Schritten wird ein fiktives SaaS-Tool für Zusammenarbeit (Togethere) als Beispiel verwendet, bei dem das Basisprodukt ein Projektmanagement-Dashboard ist.

Ein Produkt erstellen

Produkt und Preis erstellen

Produkt erstellen

Um ein Produkt im Dashboard zu erstellen:

Gehen Sie zu Mehr > Produktkatalog.
Klicken Sie auf +Produkt hinzufügen.
Geben Sie den Namen Ihres Produkts ein.
(Optional) Fügen Sie eine Beschreibung hinzu. Die Beschreibung erscheint während des Bezahlvorgangs, im Kundenportal und in Angeboten.
(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.
(Optional) Wenn Sie Stripe Tax verwenden, wählen Sie einen Steuercode für Ihr Produkt aus. Weitere Informationen zur entsprechenden Kategorie für Ihr Produkt finden Sie unter Steuercodes.
(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.
(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.

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 Pauschal-Preismodell an. Mit den Erweiterten Preisoptionen können Sie mehrere Preise erstellen oder ein anderes Preismodell verwenden.

Wählen Sie ein Preismodell aus. Weitere Informationen zu wiederkehrenden Preismodellen finden Sie im Leitfaden für Preismodelle.
- 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.
(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.
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.
Wählen Sie, ob Steuern im Preis inbegriffen sein sollen. Hier erfahren Sie mehr über Steuern und Abonnements.
(Optional) Geben Sie eine Preisbeschreibung ein. Kundinnen und Kunden sehen diese Beschreibung nicht.
(Optional) Klicken Sie auf Erweiterte Preisoptionen, wenn Sie mehrere Preise für Ihr Produkt festlegen möchten.
Klicken Sie auf Produkt hinzufügen, um das Produkt und den Preis zu speichern. Sie können Ihre Auswahl später bearbeiten.

Produkt bearbeiten

Um ein Produkt im Dashboard zu bearbeiten:

Gehen Sie zu Mehr > Produktkatalog.
Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü () und dann auf Produkt bearbeiten.
Nehmen Sie die gewünschten Änderungen am Produkt vor.
Klicken Sie auf Produkt speichern.

Sie können Produkte auch auf der Produktinformationsseite bearbeiten, indem Sie auf das Erweiterungsmenü () oder auf Bearbeiten klicken.

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.

Um ein Produkt zu archivieren:

Gehen Sie zu Mehr > Produktkatalog.
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:

Navigieren Sie zur Registerkarte Archiviert auf der Seite Produktkatalog>Übersicht.
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.

Produkt löschen

Sie können nur Produkte löschen, denen keine Preise zugeordnet sind. Alternativ können Sie ein Produkt archivieren.

Wenn einem Produkt ein Preis zugeordnet ist, müssen Sie den Preis löschen oder archivieren, 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:

Gehen Sie zu Mehr > Produktkatalog.
Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü () und dann auf Produkt löschen.

Preis erstellen

Sie können einzelne oder mehrere Preise für ein Produkt erstellen. Beispielsweise kann für Togethere eine „Starter“-Stufe für 10 USD pro Monat, 100 USD pro Jahr oder 9 EUR als einmaliger Kauf angeboten werden.

Notiz

Nachdem Sie einen Preis erstellt haben, können Sie nur die Felder metadata, nickname, and active aktualisieren.

Um einen Preis im Dashboard zu erstellen, müssen Sie zuerst ein Produkt erstellen. Anschließend können Sie einen Preis erstellen:

Wählen Sie ein Preismodell aus. Weitere Informationen zu wiederkehrenden Preismodellen finden Sie im Leitfaden für Preismodelle.
- 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.
(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.
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.
Wählen Sie, ob Steuern im Preis inbegriffen sein sollen. Hier erfahren Sie mehr über Steuern und Abonnements.
(Optional) Geben Sie eine Preisbeschreibung ein. Kundinnen und Kunden sehen diese Beschreibung nicht.
Klicken Sie auf Preis erstellen, um den Preis zu speichern. Sie können den Preis später bearbeiten.

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 Preis (kein Sonderangebot). Wenn Ihr Produkt nur einen Preis hat, ist dies der Standardpreis. Der Standardpreis muss ein aktiver Preis sein.

So ändern Sie den Standardpreis Ihres Produkts im Dashboard:

Gehen Sie zu Mehr > Produktkatalog.
Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü () und dann auf Produkt bearbeiten.
Suchen Sie im Abschnitt Preisinformationen den Preis, den Sie als neuen Standardpreis festlegen möchten, und klicken Sie dann auf Als Standardpreis festlegen.
Klicken Sie auf Produkt speichern.

So erstellen Sie einen neuen Preis und machen ihn zum neuen Standardpreis im Dashboard:

Gehen Sie zu Mehr > Produktkatalog.
Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie darauf, um die Seite mit den Produktinformationen zu öffnen.
Klicken Sie im Abschnitt Preisgestaltung auf die Schaltfläche Weiteren Preis hinzufügen.
Geben Sie Ihre Preisdetails ein und wählen Sie Als Standardpreis festlegen. Lesen Sie mehr über die verfügbaren Felder beim Erstellen eines Preises.
Klicken Sie auf Preis hinzufügen.

Erstellen Sie einen Inline-Preis

Um einen Inline-Preis 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:

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, Payment Links, Invoice Items, und Subscription Schedules verwenden.

Preise in mehreren Währungen erstellen

Sie können Preise mit mehreren Währungen in der API oder im Dashboard erstellen.

So erstellen Sie einen Preis mit mehreren Währungen über das Dashboard:

Gehen Sie zum Produktkatalog und wählen Sie ein Produkt aus.
Klicken Sie auf Produkt bearbeiten.
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.
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.
Um den neuen Preis zu speichern, klicken Sie auf Weiter > Produkt aktualisieren.

Gutscheine, Promo-Codes und Versandraten 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.<currency>.unit_amount anzeigen. Die API-Antwort enthält standardmäßig keine currency_options. Um sie in die Antwort aufzunehmen, erweitern Sie das Feld currency_options:

Notiz

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.

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 für das Preisobjekt 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.

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:

Notiz

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 auf diesen neuen Preis übertragen:

Runden

Das Runden erfolgt auf der Ebene der Rechnungsposten. 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 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 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.

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 so zu aktualisieren, dass er inaktiv ist.

Um einen Preis im Dashboard zu bearbeiten:

Gehen Sie zu Mehr > Produktkatalog.
Suchen Sie das Produkt, dessen Preis Sie ändern möchten, und klicken Sie darauf
Suchen Sie den Preis, den Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü () und dann auf Preis bearbeiten.
Nehmen Sie Ihre Preisänderungen vor. Sie können an dieser Stelle einen weiteren Preis hinzufügen.
Klicken Sie auf Speichern.

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.

Um einen Preis im Dashboard zu ändern:

Gehen Sie zu Mehr > Produktkatalog.
Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü ().
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:

Gehen Sie zu Mehr > Produktkatalog.
Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü ().
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.

Preis löschen

Sie können nur Preise löschen, die Sie noch nie verwendet haben. Andernfalls können Sie sie archivieren.

Um einen Preis dauerhaft aus dem Dashboard zu löschen:

Gehen Sie zu Mehr > Produktkatalog.
Suchen Sie das Produkt, das Sie ändern möchten, und klicken Sie auf das Erweiterungsmenü ().
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.

Preisinformationen anzeigen

Nachdem Sie Produkte und Preise erstellt haben, können Sie eine Preistabelle 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 vornehmen, ohne Code erstellen zu müssen.

Produkte und Preise importieren

Wenn Sie einen sehr umfangreichen Produktkatalog haben, verwenden Sie die Products 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 API, um für jedes Produkt in Ihrem System ein Produkt in Stripe erstellen. Um Produkte in Ihrem System Produkten in Stripe zuzuordnen, weisen Sie jedem Produkt, das Sie importieren, eine eindeutige ID zu. Verwenden Sie für jedes Produkt die Prices API, um einen entsprechenden Preis zu erstellen. Achten Sie darauf, die id des neu erstellten Preises zu speichern. Sie müssen diese id übergeben, wenn Sie die Produkte und Preise in Ihrer Integration verwenden.

Bestätigen Sie den Import, indem Sie das Dashboard prüfen oder die API zum Auflisten aller Produkte 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:

Navigieren Sie im Dashboard zu den Produkten und suchen Sie nach Ihrem Produkt.
Klicken Sie im Abschnitt Preise auf das Überlaufmenü () neben dem Preis und wählen Sie Preis löschen aus.
Klicken Sie oben auf der Seite auf das Überlaufmenü () 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, verwenden Sie das folgende Muster.

Suchen Sie zunächst mit der API zum Auflisten aller Preise nach dem vorhandenen Preis, um sicherzustellen, dass der Preis noch mit Ihrer Datenquelle übereinstimmt. Jedes Produkt sollte genau einen aktiven Preis haben.

Prüfen Sie als Nächstes, ob sich der Dezimalbetrag des Preises geändert hat. Das Feldunit_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, geben Sie die product-ID des ursprünglichen Produkts, die currency und den aktualisierten Preis für den unit_amount an.

Aktualisieren Sie den alten Preis und kennzeichnen Sie ihn als active=false.

Produkte und Preise in Ihrer Integration verwenden

Sie können Produkte und Preise in verschiedenen Stripe-Integrationspfaden verwenden.

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.