Coupons

Erstelle Rabattcodes, die Kunden an der Kasse eingeben können. Prozentual oder als fester Betrag, zeitlich begrenzt oder mit Einlösungslimit, einmalig oder wiederkehrend.

Coupons werden in deiner App unter Admin > Commerce > Products, im Bereich Coupons, sowie im Tab Cupones des Admin-Panels deiner veröffentlichten App verwaltet.

Aufbau eines Coupons

Feld	Hinweise
code	Der Aktionscode, den Kunden an der Kasse eingeben (z. B. LAUNCH20)
percent_off oder amount_off	Schließen sich gegenseitig aus. Prozent liegt zwischen 1 und 100. Betrag wird in der kleinsten Währungseinheit angegeben (Cent).
currency	Erforderlich für amount_off-Rabatte (dreistelliger ISO-Code). Wird bei der Erstellung akzeptiert und an Stripe weitergeleitet, aber danach nicht gespeichert oder von der API zurückgegeben.
duration	once (nur erste Zahlung), repeating (für duration_in_months) oder forever
duration_in_months	Erforderlich, wenn duration auf repeating gesetzt ist
max_redemptions	Gesamtlimit über alle Kunden hinweg
redeem_by	Ablaufdatum, nach dem der Coupon nicht mehr funktioniert
name	Anzeigename, der Kunden angezeigt wird
active	Schalter zum Aktivieren/Deaktivieren ohne Löschen

Einen Coupon erstellen

Klicke im Sub-Tab Coupons auf Add coupon und fülle die Felder aus. Ein paar häufige Konfigurationen:

Ziel	Einstellungen
20 % Rabatt dauerhaft	percent_off: 20, Duration forever
10 $ Rabatt, einmalig, läuft in 30 Tagen ab	amount_off: 1000, Currency USD, Duration once, Max Redemptions 1, Redeem-by in 30 Tagen
50 % Rabatt auf die ersten 3 Monate eines Abonnements	percent_off: 50, Duration repeating, Duration in Months 3

Oder frag einfach die KI: "Create a LAUNCH20 coupon for 20% off forever."

Einen Coupon an der Kasse anwenden

Es gibt zwei Möglichkeiten, wie ein Kunde einen Code verwenden kann:

• Auf der Stripe-Checkout-Seite — das Feld für den Aktionscode wird automatisch angezeigt, sodass Kunden den Code dort eingeben können, ohne dass du etwas tun musst.
• In deinem eigenen Warenkorb — füge deinem Warenkorb ein Aktionscode-Feld hinzu und übergib den eingegebenen Code beim Checkout-Aufruf als couponCode. Der Server validiert den Code und berechnet den Rabatt anhand deiner Commerce-Daten (niemals anhand eines vom Browser übermittelten Betrags), speichert ihn in der Bestellung und hängt den passenden Stripe-Coupon an, damit die Abbuchung korrekt ist.

Frag die KI: "Add a promo code field to the cart and apply it at checkout."

Auflisten, aktualisieren, deaktivieren

Der Sub-Tab Coupons listet alle Coupons mit der Anzahl der bisherigen Einlösungen im Verhältnis zum Limit auf, sodass du die Kampagnenleistung auf einen Blick verfolgen kannst. Die Bearbeitungsmöglichkeiten sind bewusst eingeschränkt – siehe unten –, aber du kannst jeden Coupon deaktivieren, ohne ihn zu löschen. Er funktioniert dann sofort nicht mehr an der Kasse.

Hinweise und Einschränkungen

• Codes und Rabattbeträge sind unveränderlich. Du kannst den Anzeigenamen (name) aktualisieren und active umschalten, aber nicht percent_off, amount_off oder code selbst. Erstelle einen neuen Coupon, wenn du andere Konditionen benötigst.
• times_redeemed wird automatisch hochgezählt und ist schreibgeschützt – nützlich zur Verfolgung der Kampagnenleistung.
• Coupons gelten pro Kunde, nicht pro Bestellung – wenn ein Coupon auf forever gesetzt ist und ein Kunde ein Abonnement abschließt, erhält jede Verlängerung den Rabatt.