Mit Produkten und Preisen loslegen
Beginnen Sie mit der Modellierung Ihres Unternehmens mit Produkten und Preisen bei Stripe.
Produkte und Preise sind zentrale Ressourcen für verschiedene Stripe-Integrationen. Dazu gehören Checkout-Sitzungen, Payment Links, Abonnements und Rechnungen.
Stellen Sie zunächst sicher, dass Sie die wesentlichen Ziele Ihres Integrationsprojekts kennen, und treffen Sie alle Designentscheidungen, bevor Sie mit dem Erstellen der Integration beginnen. Wenn Sie beispielsweise eine Abonnement-Integration erstellen möchten, finden Sie unter Entwerfen einer Integration mehr Informationen über Designentscheidungen und Preismodelle. Darauf basierend können Sie Ihr Geschäftsmodell optimal auf Stripe übertragen.
Als Nächstes müssen Sie entscheiden, ob Sie neue Produkte und Preise in Stripe erstellen oder einen vorhandenen Produktkatalog aus einem anderen System in Stripe importieren möchten. Erstellen Sie neue Produkte und Preise im Dashboard, wenn Sie einen kleinen Produktkatalog haben oder keinen Code verwenden möchten. Wenn Sie einen sehr umfangreichen Produktkatalog haben, verwenden Sie die Products API, um Ihren Katalog programmgesteuert zu importieren.
Mehrere Produkte und Preise
Sie können zur Darstellung Ihres Produktkatalogs beliebig viele Produkte erstellen. Sie können auch mehrere Preise für die einzelnen Produkte erstellen. Ob Sie mehrere Produkte oder mehrere Preise erstellen sollten, hängt von verschiedenen Faktoren ab. Grundsätzlich empfiehlt es sich jedoch:
Erstellen Sie mehrere Preise für ein einzelnes Produkt, wenn Sie denselben Artikel zu verschiedenen Preisen verkaufen. Wenn Sie beispielsweise eine Abonnementstufe zu monatlichen und jährlichen Raten anbieten, erstellen Sie ein Produkt für die Stufe und einen Preis für die monatliche Rate und ein weiteres für die jährliche Rate. Sehen Sie sich ein Beispiel für ein good-better-best Flatrate-Preismodell an. (Wenn Sie denselben Artikel in verschiedenen Währungen verkaufen, erstellen Sie einen einzigen Multi-Währungspreis) anstatt mehrere Preise zu erstellen.
Mehrere Produkte zu erstellen, wenn die Artikel in Ihrer Anwendung unterschiedliche Bereitstellungen und Fulfillments erfordern. Beim Preismodell mit den Stufen „Gut/besser/am besten“ etwa erstellen Sie für jede Stufe ein anderes Produkt. Entsprechend würden Sie bei verschiedenen Ausführungen eines Produkts, z. B. unterschiedlichen Farben oder Größen eines T-Shirts, ein Produkt für die jeweilige Ausführung erstellen.
Test-Modus
Sie können Produkte aus dem Test-Modus in den Live-Modus kopieren, sodass Sie sie nicht neu erstellen müssen. Mit dem Produkt verknüpfte Preise werden ebenfalls kopiert. Klicken Sie in der Ansicht „Produktdetail“ im Dashboard in der oberen rechten Ecke auf In Live-Modus kopieren.
Sie können Testprodukte nur einmal in den Live-Modus kopieren. Wenn Sie nach dem Kopiervorgang Aktualisierungen an dem Testprodukt vornehmen, werden die Änderungen im Live-Produkt nicht widergespiegelt.
Produkte und Preise erstellen
Neue Produkte und Preise lassen sich am einfachsten über das Dashboard erstellen. Wenn Sie die API verwenden möchten, lesen Sie den Leitfaden zur Verwaltung von Produkten und Preisen. In diesem Abschnitt werden nur die Dashboard-Schritte beschrieben.
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 wird beim Bezahlvorgang im Kundenportal und in Angeboten angezeigt.
- (Optional) Add an Image of your product. Use a JPEG, PNG, or WEBP file that’s smaller than 2MB. The image appears at checkout.
- (Optional) Wenn Sie Stripe Tax verwenden, wählen Sie einen Steuercode für Ihr Produkt aus. Weitere Informationen über die entsprechende Kategorie für Ihr Produkt finden Sie unter Steuercodes.
- (Optional) Geben Sie eine Zahlungsbeschreibung in der Abrechnung ein. Diese überschreibt alle Kontobeschreibungen für wiederkehrende Zahlungen. Wählen Sie eine Beschreibung, die Ihre Kund/innen auf einem Kontoauszug erkennen würden.
- (Optional) Geben Sie eine Artikelbezeichnung ein. Dies beschreibt, 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.
Um ein Produkt im Dashboard zu speichern, müssen Sie außerdem mindestens einen Preis hinzufügen. Sie können auch mehrere Preise für ein Produkt erstellen. Mehr Informationen finden Sie unter Preis erstellen.
Preis erstellen
Um einen Preis im Dashboard zu erstellen, müssen Sie zuerst ein Produkt erstellen. Sie können mehrere Preise für ein Produkt 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 Preise: Stellen Sie Ihren Kundinnen/Kunden Rechnungen basierend auf deren Nutzungsverhalten Ihres Dienstes während des Abrechnungszeitraums.
(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. Kund/innen sehen diese Beschreibung nicht.
- Klicken Sie auf Preis erstellen, um den Preis zu speichern. Sie können den Preis später bearbeiten.
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 zu 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. Speichern Sie unbedingt die id des neu erstellten Preises. Sie müssen diese id übergeben, wenn Sie in Ihrer Integration Produkte und Preise verwenden.
Bestätigen Sie den Import, indem Sie das Dashboard prüfen oder die API zum Auflisten aller Produkte verwenden.
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
Wahrscheinlich 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_ 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_ an.
Aktualisieren Sie dann den alten Preis, um ihn als active=false zu kennzeichnen.
Produkte und Preise verwenden
Nachdem Sie nun Produkte und Preise in Stripe haben, können Sie diese in einer Integration verwenden.