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. Wenn Sie eine große Anzahl von Produkten und Preisen haben oder wenn Sie eine nutzerdefinierte Integration mit Elements erstellen, müssen Sie die API nicht verwenden.
- Erstellen und verwalten Sie Produkte und Preise mithilfe des Dashboards, wenn Sie keinen Code erstellen möchten oder nur wenige Produkte und Preise haben. Richten Sie Ihr Preismodell im Test-Modus 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 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.
Ein Produkt löschen
Sie können nur Produkte löschen, denen keine Preise zugeordnet sind. Alternativ können Sie ein Produkt archivieren.
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.
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.
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_
ü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_
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_
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.
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.
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.
Preis löschen
Sie können nur Preise löschen, die Sie noch nie verwendet haben. Andernfalls können Sie sie archivieren.
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.