Discounts

​

Vad är Rabattkoder?

• Säsongskampanjer: Black Friday, produktlanseringar eller jubileer
• Förvärvserbjudanden: Första-köp incitament eller belöningar vid hänvisningar
• Behållande: Återvinnings- eller lojalitetsbelöningar för befintliga kunder
• B2B-erbjudanden: Avtalade eller förhandlade priser via privata koder

​

Viktiga Fördelar

• Flexibla rabatter: Procentbaserade rabatter eller rabatter med fast belopp
• Kombinerbara koder: Tillämpa upp till 20 koder per checkout, betalning eller prenumeration — kombinera kampanjer (t.ex. WELCOME10 + BLACKFRIDAY20) utan att skapa specialanpassade koder
• Målinriktad kontroll: Begränsa efter produkt, prenumerationscykler och kundberättigande
• Kampanjstyrning: Schemalagda startdatum, utgångsdatum samt användningsgränser totalt och per kund
• Prissättning per valuta: Ange det fasta avdraget, beloppsgränsen och minsta delsumma per valuta
• Smidig checkout: UI-fält och API-stöd via checkout sessions

​

Skapa Rabattkoder

​

Konfigurera i dashboarden

• Discount Name (obligatoriskt): Internt namn och visningsnamn i dashboarden
• Code (obligatoriskt): Strängen som kunder anger i checkout, eller generera en slumpmässig kod med den angivna knappen
• Type (obligatoriskt): Välj Percentage (procentuell rabatt) eller Amount (fast avdrag)
• Amount (obligatoriskt): Procentvärdet eller det fasta beloppet för en Amount-rabatt
• Start Date (valfritt): Schemalägg när koden ska aktiveras; lämna tomt för att aktivera den omedelbart
• Expiration Date (valfritt): Datum efter vilket koden blir ogiltig
• Usage Limit (valfritt): Maximalt totalt antal inlösningar för alla kunder
• Per-Customer Usage Limit (valfritt): Maximalt antal inlösningar för en enskild kund. Måste vara mindre än eller lika med den totala användningsgränsen när båda anges
• Customer Eligibility (valfritt): Begränsa vilka som får lösa in koden — alla kunder, förstagångskunder, befintliga kunder eller en manuellt vald lista
• Currency Options (valfritt): Värden per valuta — se Alternativ per valuta
• Product Restriction (valfritt): Begränsa giltigheten till valda produkter
• Subscription Cycle Limit (valfritt): Antalet faktureringscykler som rabatten gäller för
• Preserve on Plan Change (valfritt): Behåll rabatten aktiv när prenumerationens plan ändras (preserve_on_plan_change)
• Metadata (valfritt): Lägg till anpassade nyckel–värde-par för intern spårning eller integrationer

​

Rabattmetoder

​

Kundberättigande

​

Alternativ per valuta

• Amount — för en Amount-rabatt är detta själva avdraget; för en Percentage-rabatt anger det hur mycket koden maximalt kan dra av. Mappas till max_amount_possible via API:t.
• Minimum subtotal — koden tillämpas endast när varukorgen når denna delsumma. 0 betyder att det inte finns något minimum.
• Default — en post kan markeras som standard, så att andra, ej konfigurerade valutor konverteras från den.

​

Checkout-upplevelse

1. Kunder anger koden i checkout-fältet.
2. Berättigade rabatter tillämpas och totalsummorna uppdateras omedelbart.

​

Kombinera rabattkoder

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-hantering

​

Vanliga användningsområden

• Introduktionserbjudanden: Tidsbegränsade lanseringskampanjer för nya produkter
• Bulk eller B2B: Avtalsbaserade rabatter för utvalda produktuppsättningar
• Kundbevarande: Win-back-koder i arbetsflöden för att förebygga kundbortfall
• Säsongskampanjer: Högtids- eller evenemangsbaserade kampanjer

​

Integrationsexempel

​

Skapa en rabatt med metadata

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

​

Tillämpa rabatter i Checkout Sessions

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'
});

​

Tillämpa rabatter vid planändringar

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

​

Dölj fältet för rabattkod

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'
});

​

Bästa praxis

• Namnge tydligt: Använd igenkännbara koder som överensstämmer med kampanjnamnen
• Tidsbegränsa: Lägg till utgångsdatum för att skapa brådska och förhindra missbruk
• Avgränsa klokt: Begränsa till specifika produkter för att undvika marginalförluster
• Validera tidigt: Kontrollera kodens giltighet innan checkout bekräftas
• Övervaka effekten: Följ användning och konvertering per kampanj