Prenumerationer

​

Vad är Prenumerationer?

• SaaS-licenser: Appar, API:er eller plattformsåtkomst
• Medlemskap: Gemenskaper, program eller klubbar
• Digitalt innehåll: Kurser, media eller premiuminnehåll
• Supportplaner: SLA:er, framgångspaket eller underhåll

​

Nyckelfördelar

• Förutsägbar intäkt: Återkommande fakturering med automatiska förnyelser
• Flexibla cykler: Månatliga, årliga, anpassade intervall och provperioder
• Planagilitet: Proportionering för uppgraderingar och nedgraderingar
• Tillägg och platser: Koppla valfria, kvantifierbara uppgraderingar
• Smidig kassa: Hostad kassa och kundportal
• Utvecklarvänlig: Tydliga API:er för skapande, ändringar och användningsspårning

​

Skapa Prenumerationer

​

Skapande av prenumerationsprodukter

​

Produktinformation

• Produktnamn (obligatoriskt): Det visade namnet som visas i kassan, kundportalen och fakturor.
• Produktbeskrivning (obligatoriskt): Ett tydligt värdeuttalande som visas i kassan och fakturor.
• Produktbild (obligatoriskt): PNG/JPG/WebP upp till 3 MB. Används på kassan och fakturor.
• Varumärke: Koppla produkten till ett specifikt varumärke för temat och e-post.
• Skattekategori (obligatoriskt): Välj kategori (till exempel, SaaS) för att bestämma skatteregler.

​

Prissättning

• Prissättningstyp: Välj Prenumeration (denna guide). Alternativ är Engångsbetalning och Användningsbaserad fakturering.
• Pris (obligatoriskt): Grundläggande återkommande pris med valuta.
• Rabatt som gäller (%): Valfri procentuell rabatt som tillämpas på grundpriset; återspeglas i kassan och fakturor.
• Upprepa betalning varje (obligatoriskt): Intervall för förnyelser, t.ex. varje 1 Månad. Välj takten (månader eller år) och mängd.
• Prenumerationsperiod (obligatoriskt): Total period under vilken prenumerationen förblir aktiv (t.ex. 10 År). Efter denna period slutar förnyelser om de inte förlängs.
• Prova på period dagar (obligatoriskt): Ställ in provlängd i dagar. Använd 0 för att inaktivera provperioder. Den första avgiften sker automatiskt när provperioden slutar.
• Välj tillägg: Bifoga upp till 10 tillägg som kunder kan köpa tillsammans med grundplanen.

​

Avancerade inställningar

• Skatteinkluderande prissättning: Visa priser inklusive tillämpliga skatter. Slutlig skatteberäkning varierar fortfarande beroende på kundens plats.
• Generera licensnycklar: Utfärda en unik nyckel till varje kund efter köp. Se Licensnycklar-guiden.
• Leverans av digitala produkter: Leverera filer eller innehåll automatiskt efter köp. Läs mer i Leverans av digitala produkter.
• Metadata: Koppla anpassade nyckel-värde-par för intern taggning eller klientintegrationer. Se Metadata.

​

Prenumerationsprov

​

Konfigurera Prov

// Via subscription creation
const subscription = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_monthly',
  trial_period_days: 14  // Overrides product's trial period
});

// Via checkout session
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_monthly', quantity: 1 }],
  subscription_data: { trial_period_days: 14 }
});

​

Upptäck Provstatus

const subscription = await client.subscriptions.retrieve('sub_123');
const payments = await client.payments.list({
  subscription_id: subscription.subscription_id
});

// Check if subscription is in trial
const isInTrial = payments.items.length === 1 && 
                  payments.items[0].total_amount === 0;

​

Uppdatera Provperiod

await client.subscriptions.update('sub_123', {
  next_billing_date: '2025-02-15T00:00:00Z'  // New trial end date
});

​

Ändringar av Prenumerationsplaner

​

Prorationslägen

​

prorated_immediately

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

​

difference_immediately

// Upgrade: charges $50 (difference between $30 and $80)
// Downgrade: credits remaining value, auto-applied to renewals
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'difference_immediately'
});

​

full_immediately

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_monthly',
  quantity: 1,
  proration_billing_mode: 'full_immediately'
});

Unused credit from Basic = $30 × (15 remaining / 30 total) = $15.00
Prorated cost of Pro     = $80 × (15 remaining / 30 total) = $40.00
────────────────────────────────────────────────────────────────────
Immediate charge         = $40.00 − $15.00 = $25.00

Credit = Old plan − New plan = $80 − $20 = $60.00

​

Ändra planer med tillägg

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [{ addon_id: 'addon_extra_seats', quantity: 2 }]  // Add add-ons
  // addons: []  // Empty array removes all existing add-ons
});

​

Förhandsvisa planändringar

const preview = await client.subscriptions.previewChangePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

// Show customer the charge before confirming
console.log('You will be charged:', preview.immediate_charge.summary);

​

Prenumerationstillstånd

• active: Prenumerationen är aktiv och förnyas automatiskt
• on_hold: Prenumerationen är pausad på grund av misslyckad betalning. Uppdatering av betalningsmetod krävs för att återaktivera
• cancelled: Prenumerationen är avbruten och förnyas inte
• expired: Prenumerationen har nått sitt slutdatum
• pending: Prenumerationen skapas eller behandlas

​

On Hold-tillstånd

• En förnyelsebetalning misslyckas (otillräckliga medel, utgånget kort osv.)
• En avgift för planändring misslyckas
• Auktorisation av betalningsmetod misslyckas

​

Återaktivera från On Hold

1. Skapar en avgift för återstående skulder
2. Genererar en faktura
3. Bearbetar betalningen med den nya betalningsmetoden
4. Återaktiverar prenumerationen till active-tillstånd vid lyckad betalning

// Reactivate subscription from on_hold
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// For on_hold subscriptions, a charge is automatically created
if (response.payment_id) {
  console.log('Charge created:', response.payment_id);
  // Redirect customer to response.payment_link to complete payment
  // Monitor webhooks for payment.succeeded and subscription.active
}

​

API-hantering

​

Mandatgränser

​

Vanliga användningsfall

• SaaS and APIs: Skiktad åtkomst med tillägg för platser eller användning
• Content and media: Månatlig åtkomst med introduktionserbjudanden
• B2B support plans: Årliga kontrakt med premium supporttillägg
• Tools and plugins: Licensnycklar och versionerade releaser

​

Integrationsexempel

​

Checkout-sessioner (prenumerationer)

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_subscription',
      quantity: 1
    }
  ]
});

​

Planändringar med proration

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately'
});

​

Avsluta vid nästa faktureringsdatum

await client.subscriptions.update('sub_123', {
  cancel_at_next_billing_date: true
});

​

On-demand-prenumerationer

const onDemand = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_on_demand',
  on_demand: true
});

await client.subscriptions.createCharge(onDemand.id, {
  amount: 4900,
  currency: 'USD',
  description: 'Extra usage for September'
});

​

Uppdatera betalmetod för aktiv prenumeration

// Update with new payment method
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// Or use existing payment method
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'existing',
  payment_method_id: 'pm_abc123'
});

​

Återaktivera prenumeration från on_hold

// Update payment method - automatically creates charge for remaining dues
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

if (response.payment_id) {
  // Charge created for remaining dues
  // Redirect customer to response.payment_link
  // Monitor webhooks: payment.succeeded → subscription.active
}

​

Prenumerationer med RBI-kompatibla mandater

​

Mandate Limits

• Charges below Rs 15,000: Vi skapar ett on-demand-mandat för Rs 15 000 INR. Prenumerationsbeloppet debiteras periodvis enligt din prenumerationsfrekvens, upp till mandatgränsen.
• Charges Rs 15,000 or above: Vi skapar ett prenumerationsmandat (eller on-demand-mandat) för det exakta prenumerationsbeloppet.

​

Upgrade and Downgrade Considerations

• Om en uppgradering/nedgradering resulterar i ett avgiftsbelopp som överstiger Rs 15 000 och går utöver den befintliga on-demand-betalningsgränsen kan transaktionsavgiften misslyckas.
• I sådana fall kan kunden behöva uppdatera sin betalningsmetod eller ändra prenumerationen igen för att skapa ett nytt mandat med rätt gräns.

​

Authorization for High-Value Charges

• Kunden kommer att uppmanas av sin bank att godkänna transaktionen.
• Om kunden inte godkänner transaktionen kommer den att misslyckas och prenumerationen sätts i on hold.

​

48-Hour Processing Delay

• Debiteringar startas på det schemalagda datumet enligt din prenumerationsfrekvens.
• Det faktiska avdraget från kundens konto sker först efter 48 timmar från betalningsstart.
• Detta 48-timmarsfönster kan utökas upp till 2–3 extra timmar beroende på bankernas API-svar.

​

Mandate Cancellation Window

• Kunder kan avbryta mandatet via sina bankappar.
• Om en kund avbryter mandatet under denna period förblir prenumerationen aktiv (detta är ett speciellt fall som gäller indiska kort och UPI AutoPay-prenumerationer).
• Den faktiska avdragningen kan dock misslyckas, och i så fall sätter vi prenumerationen on hold.

• Att fördröja aktivering av förmåner tills betalningsbekräftelse
• Att införa nådperioder eller tillfällig åtkomst
• Att övervaka prenumerationstillstånd vid mandatavbokningar
• Att hantera prenumerationstillstånd i din applikationslogik

​

Bästa praxis

• Börja med tydliga nivåer: 2–3 planer med tydliga skillnader
• Kommunicera priser: Visa totalsummor, proration och nästa förnyelse
• Använd provperioder med eftertanke: Konvertera med onboarding, inte bara tid
• Utnyttja tillägg: Håll basplaner enkla och erbjud tillägg
• Testa förändringar: Verifiera planändringar och proration i testläge