Discounts

​

Vad är Rabattkoder?

​

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
• Riktad kontroll: Begränsa efter produkt, prenumerationscykler och kundberättigande
• Kampanjstyrning: Schemalagda startdatum, utgångsdatum samt övergripande användningsgränser och gränser per kund
• Prissättning per valuta: Ange det fasta avdraget, beloppsgränsen och minimisumman per valuta

​

Skapa Rabattkoder

​

Konfiguration i Dashboard

• Rabattnamn (obligatoriskt): Intern etikett för Dashboard.
• Kod (obligatoriskt): Strängen som kunder anger i Checkout. Generera en slumpmässig kod eller ange en egen (minst 3 tecken, konverteras automatiskt till versaler).
• Typ (obligatoriskt): Procent (en procentuell rabatt) eller Belopp (ett fast avdrag).
• Belopp (obligatoriskt): För procent anges den procentuella rabatten i Dashboard (t.ex. 15 för 15 %). Via API är samma värde uttryckt i baspunkter (1500). För belopp anges det fasta avdraget i kodens standardvaluta.
• Startdatum (valfritt): Schemalägg när koden ska aktiveras. Lämna tomt för att aktivera den omedelbart.
• Utgångsdatum (valfritt): Datum efter vilket koden inte längre kan lösas in.
• Användningsgräns (valfritt, under Avancerat): Maximalt totalt antal inlösningar för alla kunder.
• Användningsgräns per kund (valfritt, under Avancerat): Maximalt antal inlösningar för en enskild kund. Måste vara mindre än eller lika med den övergripande användningsgränsen när båda anges.
• Kundberättigande (valfritt): Begränsa vem som får lösa in koden — alla kunder, förstagångskunder, befintliga kunder eller en manuellt vald lista.
• Valutaalternativ (valfritt): Rabattbeloppet för varje valuta du säljer i. Se Alternativ per valuta.
• Produktbegränsning (valfritt): Begränsa koden till specifika produkter.
• Gräns för prenumerationscykler (valfritt, under Avancerat): Antalet faktureringscykler som rabatten gäller för. Lämna tomt för obegränsad giltighet.
• Behåll vid planändring (valfritt): Behåll rabatten aktiv när en prenumeration byter plan (preserve_on_plan_change).
• Metadata (valfritt): Lägg till anpassade nyckel–värde-par för intern spårning.
• Kräv ett minsta ordervärde (valfritt, under Avancerat): Minsta delsumma i kundvagnen (per valuta) för att koden ska tillämpas.

​

Rabatttyper

​

Kundbehörighet

​

Valutaalternativ

• Belopp — för en beloppsrabatt, det fasta avdraget i valutan; för en procentbaserad rabatt, den maximala rabattgränsen. Mappas till max_amount_possible i API:t.
• Standard — markera en valuta som standardvaluta. Valutor utan konfiguration konverteras från denna standardvaluta.

• Minsta delsumma — koden tillämpas endast när kundvagnen når denna delsumma i den valutan. 0 betyder att ingen miniminivå gäller.

​

Checkout-upplevelse

​

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ändningsfall

• Introduktionserbjudanden: Tidsbegränsade lanseringskampanjer för nya produkter
• Bulk eller B2B: Avtalade rabatter för utvalda produktuppsättningar
• Retention-aktiviteter: Återvinningskoder i arbetsflöden för att förebygga kundbortfall
• Säsongskampanjer: Helg- 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 rabattkodsfältet

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.
• Begränsa klokt: Begränsa till specifika produkter för att undvika marginalförlust.
• Validera tidigt: Kontrollera kodens tillämplighet innan Checkout bekräftas.
• Övervaka effekten: Följ användning och konvertering per kampanj.