Rabatte

​

Was sind Rabattcodes?

​

Hauptvorteile

• Flexible Rabatte: Prozentuale Rabatte oder Rabatte mit festem Betrag
• Kombinierbare Codes: Wenden Sie bis zu 20 Codes pro Checkout, Zahlung oder Abonnement an
• Gezielte Steuerung: Beschränkung nach Produkt, Abonnementzyklen und Kundenberechtigung
• Kampagnenverwaltung: Geplante Startdaten, Ablaufdaten sowie allgemeine und kundenbezogene Nutzungslimits
• Preise pro Währung: Legen Sie den festen Abzugsbetrag, die Betragsobergrenze und den Mindestzwischensumme pro Währung fest

​

Rabattcodes erstellen

​

Einrichtung im Dashboard

• Rabattname (erforderlich): Interne Bezeichnung für das Dashboard.
• Code (erforderlich): Die Zeichenfolge, die Kunden beim Checkout eingeben. Generieren Sie einen zufälligen Code oder geben Sie einen eigenen ein (mindestens 3 Zeichen, automatisch in Großbuchstaben umgewandelt).
• Typ (erforderlich): Percentage (prozentualer Rabatt) oder Amount (fester Abzugsbetrag).
• Amount (erforderlich): Bei Percentage der prozentuale Rabatt im Dashboard (z. B. 15 für 15 %). Über die API wird derselbe Wert in Basispunkten angegeben (1500). Bei Amount der feste Abzugsbetrag in der Standardwährung des Codes.
• Start Date (optional): Planen Sie die Aktivierung des Codes für ein zukünftiges Datum. Lassen Sie das Feld leer, um ihn sofort zu aktivieren.
• Expiration Date (optional): Datum, nach dem der Code nicht mehr eingelöst werden kann.
• Usage Limit (optional, unter Advanced): Maximale Gesamtzahl der Einlösungen über alle Kunden hinweg. Ein Warenkorb mit mehreren Abonnements zählt als eine Einlösung.
• Per-Customer Usage Limit (optional, unter Advanced): Maximale Anzahl der Einlösungen durch einen einzelnen Kunden. Wenn beide Limits festgelegt sind, muss dieser Wert kleiner oder gleich dem allgemeinen Nutzungslimit sein.
• Customer Eligibility (optional): Beschränken Sie, wer den Code einlösen darf — alle Kunden, Erstkunden, bestehende Kunden oder eine manuell ausgewählte Liste.
• Currency Options (optional): Der Rabattbetrag für jede Währung, in der Sie verkaufen. Siehe Optionen pro Währung.
• Product Restriction (optional): Beschränken Sie den Code auf bestimmte Produkte.
• Subscription Cycle Limit (optional, unter Advanced): Anzahl der Abrechnungszyklen, für die der Rabatt gilt. Für eine unbegrenzte Gültigkeit leer lassen.
• Preserve on Plan Change (optional): Rabatt aktiv halten, wenn ein Abonnement den Tarif wechselt (preserve_on_plan_change).
• Metadata (optional): Benutzerdefinierte Schlüssel-Wert-Paare für die interne Nachverfolgung anhängen.
• Require a minimum order value (optional, unter Advanced): Mindestzwischensumme des Warenkorbs (pro Währung), ab der der Code angewendet wird.

​

Rabattarten

​

Kundenberechtigung

​

Optionen pro Währung

• Betrag — bei einem Rabatt vom Typ Betrag der feste Abzug in dieser Währung; bei einem prozentualen Rabatt die maximale Rabattobergrenze. Wird in der API auf max_amount_possible abgebildet.
• Standard — Legen Sie eine Währung als Standard fest. Nicht konfigurierte Währungen werden aus dieser Standardwährung umgerechnet.

• Mindestzwischensumme — Der Code wird nur angewendet, wenn der Warenkorb diese Zwischensumme in der jeweiligen Währung erreicht. 0 bedeutet, dass kein Mindestwert festgelegt ist.

​

Checkout-Erlebnis

​

Rabattcodes stapeln

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ßhandel oder B2B: Vertraglich vereinbarte Rabatte für ausgewählte Produktsets
• Kundenbindung: Rückgewinnungscodes in Workflows zur Abwanderungsprävention
• Saisonale Kampagnen: Auf Feiertagen oder Veranstaltungen basierende Aktionen

​

Integrationsbeispiele

​

Rabatt mit Metadata 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 Tarifä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'
});

​

Bewährte Vorgehensweisen

• Klar benennen: Verwenden Sie einprägsame Codes, die zu den Kampagnennamen passen.
• Zeitlich begrenzen: Fügen Sie Ablaufdaten hinzu, um Dringlichkeit zu erzeugen und Missbrauch zu verhindern.
• Gezielt beschränken: Beschränken Sie den Code auf bestimmte Produkte, um Margenverluste zu vermeiden.
• Früh validieren: Prüfen Sie die Anwendbarkeit des Codes, bevor Sie den Checkout bestätigen.
• Auswirkungen überwachen: Verfolgen Sie Nutzung und Konversion nach Kampagne.