Kapitel 06

Produkte in Stripe abgleichen

Deine Produkte pflegst du im Framer-CMS. Das Plugin legt sie in deinem Stripe-Konto an, hält die Preise gleich und trägt die Stripe-Preis-IDs im CMS ein.

Was beim Abgleich passiert

• Für jedes Produkt im CMS legt das Plugin ein Produkt mit Preis in deinem Stripe-Konto an, bei Varianten einen Preis pro Variante.
• Die Preis-IDs von Stripe schreibt es zurück ins CMS, in die Felder Stripe Price ID und Stripe Variant IDs. Über diese IDs weiss der Checkout, was verkauft wird.
• Hat sich ein Preis geändert, legt es in Stripe einen neuen Preis an. Bestehende Zahlungen bleiben unverändert.
• Entwürfe und gelöschte Einträge archiviert es in Stripe, damit niemand sie kaufen kann.
• Unveränderte Produkte lässt es in Ruhe.

Einmal einrichten: Produkte wählen

1. Öffne im Plugin den Bereich „Products“.
2. Wähle unter „Collection“ die Sammlung mit deinen Produkten, im Template heisst sie Products.
3. Prüfe die Zuordnung der Felder: „Name“, „Price“ und „Image“, wenn gewünscht auch „Description“ und „Slug“. In den kspr-Templates sind sie schon richtig vorgeschlagen.
4. Ordne bei Bedarf die Felder für „Sold out“, „Billing interval“ und „Variants“ zu (siehe unten).
5. Bei „Price ID field“ steht das Feld Stripe Price ID, bei „Variant IDs field“ das Feld Stripe Variant IDs. Fehlt eines in deiner Sammlung, legen „Create “Stripe Price ID”“ und „Create “Stripe Variant IDs”“ es an.
6. Wähle die „Currency“ (CHF, EUR, USD oder GBP). Das Plugin errät sie aus deinen Preisen. Zeigt ein Preis eine andere Währung, warnt es dich.

Welche Preise das Plugin versteht

Das Preisfeld darf eine Zahl sein (4.9) oder Text, wie ihn Besucher sehen: CHF 12.50, Fr. 12.50, 12,50 €, $4.90 oder 1'250.00. Pro Website gibt es eine Währung. Produkte ohne lesbaren Preis überspringt das Plugin und sagt dir, welche es sind.

Varianten

Hat ein Produkt mehrere Grössen oder Packungen, schreibst du sie ins CMS-Feld Variants, getrennt durch Strichpunkte, jeweils Name und Preis:

1 Bag = 4.90; 3 Bags = 13.50; 6 Bags = 25.00 sold out

Ein sold out am Ende markiert eine einzelne Variante als ausverkauft. Das Plugin legt für jede Variante einen Preis in Stripe an und schreibt die IDs ins Feld Stripe Variant IDs.

Ausverkauft

Schalte im CMS Sold Out ein, wenn ein Produkt nicht lieferbar ist. Liegt es noch in einem Warenkorb, zeigt die Kasse „Sold out“ und bittet, es zu entfernen.

Abos für deine Kundschaft

Mit dem CMS-Feld Billing Interval verkaufst du ein Produkt als Abo, zum Beispiel eine Snackbox jeden Monat. Werte: One-time (Einmalkauf, Standard), Week, Month oder Year. Das Feld Billing Interval Key pflegt das Plugin beim Abgleich mit, es dient zum Binden an „Add to Bag“ (Ohne Template). Mehr dazu unter Abos für deine Kundschaft.

Abgleichen

1. Klicke im Bereich „Products“ auf „Update products“. In der „Compact view“ steht der Knopf direkt auf der ersten Ansicht.
2. Das Plugin zeigt für jedes Produkt, was passiert ist: angelegt, aktualisiert, unverändert, übersprungen oder ein Fehler mit Begründung. Danach meldet es, wie viele Preis-IDs es ins CMS geschrieben hat.
3. Das Plugin erinnert dich: „Publish your site now, so the new prices are live.“ Klicke in Framer auf „Publish“ und „Update“.

Im Stripe-Dashboard findest du die Produkte danach unter „Produkte“. Im Testmodus siehst du sie nur, wenn oben der Testmodus eingeschaltet ist.

Wann du erneut abgleichst

• Du hast ein neues Produkt oder eine Variante angelegt.
• Du hast einen Preis, einen Namen, ein Bild oder das Abo-Intervall geändert.
• Du hast ein Produkt gelöscht oder auf Entwurf gesetzt.
• Du hast die Steuer-Einstellungen geändert (Versand und Optionen).
• Du wechselst vom Testmodus in den Livemodus (siehe Checkout testen und live schalten).

Danach immer veröffentlichen. Als Faustregel: CMS ändern, „Update products“, veröffentlichen, in dieser Reihenfolge.

Produkte ohne Preis-ID

Ein Produkt, das noch nicht abgeglichen ist, lässt sich trotzdem in den Warenkorb legen. Beim Bezahlen meldet der Checkout dann „Shop not set up yet“. So kannst du am Design arbeiten, bevor Stripe verbunden ist.