Rabatte

​

Was sind Rabattcodes?

• Saisonale Kampagnen: Black Friday, Produkteinführungen oder Jubiläen
• Akquisitionsangebote: Anreize für Ersterwerb oder Empfehlungsbelohnungen
• Bindung: Rückgewinnungs- oder Treuebelohnungen für bestehende Kunden
• B2B-Deals: Vereinbarte oder ausgehandelte Preise über private Codes

​

Hauptvorteile

• Flexible Rabatte: Prozentbasierte oder feste Rabatte
• Kombinierbare Codes: Wende bis zu 20 Codes pro Checkout, Zahlung oder Abonnement an — kombiniere Kampagnen (z. B. WELCOME10 + BLACKFRIDAY20), ohne individuelle Codes erstellen zu müssen
• Gezielte Kontrolle: Beschränke die Verwendung nach Produkt, Abonnementzyklen und Kundenberechtigung
• Kampagnenverwaltung: Geplante Startdaten, Ablaufdaten sowie allgemeine und kundenbezogene Nutzungslimits
• Preise je Währung: Lege den festen Abzugsbetrag, das Betragslimit und den Mindestzwischensumme je Währung fest
• Nahtloser Checkout: UI-Feld und API-Unterstützung über Checkout Sessions

​

Rabattcodes erstellen

​

Dashboard-Einrichtung

• Discount Name (erforderlich): Interner Name und im Dashboard angezeigter Name
• Code (erforderlich): Die Zeichenfolge, die Kunden beim Checkout eingeben, oder generiere über die bereitgestellte Schaltfläche einen zufälligen Code
• Type (erforderlich): Wähle Percentage (prozentualer Rabatt) oder Amount (fester Abzug)
• Amount (erforderlich): Der Prozentwert oder der feste Betrag für einen Amount-Rabatt
• Start Date (optional): Plane die Aktivierung des Codes für einen späteren Zeitpunkt; lasse das Feld leer, um ihn sofort zu aktivieren
• Expiration Date (optional): Datum, nach dem der Code ungültig wird
• Usage Limit (optional): Maximale Gesamtzahl der Einlösungen über alle Kunden hinweg
• Per-Customer Usage Limit (optional): Maximale Anzahl der Einlösungen durch einen einzelnen Kunden. Wenn beide Limits festgelegt sind, muss dieses kleiner oder gleich dem allgemeinen Nutzungslimit sein
• Customer Eligibility (optional): Beschränke, wer den Code einlösen darf — alle Kunden, Erstkunden, bestehende Kunden oder eine manuell ausgewählte Liste
• Currency Options (optional): Werte je Währung — siehe Optionen je Währung
• Product Restriction (optional): Beschränke die Gültigkeit auf ausgewählte Produkte
• Subscription Cycle Limit (optional): Anzahl der Abrechnungszyklen, für die der Rabatt gilt
• Preserve on Plan Change (optional): Rabatt aktiv halten, wenn sich der Plan des Abonnements ändert (preserve_on_plan_change)
• Metadata (optional): Füge benutzerdefinierte Schlüssel-Wert-Paare für internes Tracking oder Integrationen hinzu

​

Rabattarten

​

Kundenberechtigung

​

Optionen je Währung

• Amount — Bei einem Amount-Rabatt ist dies der Abzug selbst; bei einem Percentage-Rabatt begrenzt er den maximalen Abzugsbetrag des Codes. Wird über die API auf max_amount_possible abgebildet.
• Minimum subtotal — Der Code gilt nur, wenn der Warenkorb diese Zwischensumme erreicht. 0 bedeutet, dass kein Mindestbetrag gilt.
• Default — Ein Eintrag kann als Standard markiert werden, aus dem andere, nicht konfigurierte Währungen umgerechnet werden.

​

Checkout-Erlebnis

1. Käufer geben den Code in das Checkout-Feld ein.
2. Berechtigte Rabatte werden angewendet und die Summen sofort aktualisiert.

​

Rabattcodes kombinieren

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
  customer: { email: 'user@example.com' },
  return_url: 'https://yoursite.com/return'
});

​

API-Verwaltung

​

Häufige Anwendungsfälle

• Einführungsangebote: Zeitlich begrenzte Launch-Aktionen für neue Produkte
• Großkunden oder B2B: Vertraglich vereinbarte Rabatte für ausgewählte Produktgruppen
• Kundenbindung: Rückgewinnungscodes in Abläufen zur Vermeidung von Abwanderung
• Saisonale Kampagnen: Feiertags- oder veranstaltungsbezogene Aktionen

​

Integrationsbeispiele

​

Einen Rabatt mit Metadaten erstellen

const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});

​

Rabatte in Checkout Sessions anwenden

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  discount_codes: ['BLACKFRIDAY2024', 'NEWUSER5'], // stacked in array order
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​

Rabatte bei Planänderungen anwenden

await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_codes: ['UPGRADE20']
});

​

Rabattcodefeld ausblenden

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  feature_flags: {
    allow_discount_code: false
  },
  return_url: 'https://yoursite.com/return'
});

​

Best Practices

• Klar benennen: Verwende erkennbare Codes, die zu den Kampagnennamen passen
• Zeitlich begrenzen: Füge Ablaufdaten hinzu, um Dringlichkeit zu erzeugen und Missbrauch zu verhindern
• Gezielt einsetzen: Beschränke die Gültigkeit auf bestimmte Produkte, um Margenverluste zu vermeiden
• Früh validieren: Prüfe die Anwendbarkeit des Codes, bevor du den Checkout bestätigst
• Auswirkungen überwachen: Verfolge Nutzung und Conversion nach Kampagne