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

• Discount Name (obligatoriskt): Intern etikett för dashboarden.
• Code (obligatoriskt): Strängen som kunder anger i kassan. Generera en slumpmässig kod eller ange en egen (minst 3 tecken, automatiskt konverterad till versaler).
• Type (obligatoriskt): Percentage (en procentuell rabatt) eller Amount (ett fast avdrag).
• Amount (obligatoriskt): För percentage, procentvärdet för rabatten i dashboarden (t.ex. 15 för 15 %). Via API är samma värde i basis points (1500). För amount, det fasta avdraget i kodens standardvaluta.
• Start Date (valfritt): Schemalägg när koden ska aktiveras i framtiden. Lämna tomt för att aktivera den omedelbart.
• Expiration Date (valfritt): Datum efter vilket koden inte längre kan lösas in.
• Usage Limit (valfritt, under Advanced): Maximalt totalt antal inlösningar för alla kunder. En multi-subscription cart räknas som en inlösning.
• Per-Customer Usage Limit (valfritt, under Advanced): 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.
• 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): Rabattbeloppet för varje valuta du säljer i. Se Per-Currency Options.
• Product Restriction (valfritt): Begränsa koden till specifika produkter.
• Subscription Cycle Limit (valfritt, under Advanced): Antalet faktureringscykler som rabatten gäller för. Lämna tomt för obegränsad giltighet.
• Preserve on Plan Change (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.
• Require a minimum order value (valfritt, under Advanced): Minsta delsumma för varukorgen (per valuta) för att koden ska gälla.

​

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 Experience

​

Stapla 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
• Volym eller B2B: Avtalade rabatter för utvalda produktuppsättningar
• Kundbevarande: Återvinningskoder i arbetsflöden för att förebygga churn
• Säsongskampanjer: Högtids- eller evenemangsbaserade kampanjer

​

Integreringsexempel

​

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.
• Begränsa klokt: Begränsa till specifika produkter för att undvika marginalförlust.
• Validera tidigt: Kontrollera kodens giltighet innan du bekräftar checkout.
• Övervaka påverkan: Följ användning och konvertering per kampanj.