Credit-Based Billing

​

Vad är kreditbaserad fakturering?

• AI och LLM-plattformar: Ge tokens eller genereringskrediter per plan
• API-tjänster: Tilldela API-anrop med överutnyttjad prissättning
• Infrastrukturplattformar: Utfärda beräkningstimmar eller lagringskrediter
• Kommunikationstjänster: Ge meddelande- eller minutkrediter per prenumeration
• SaaS med konsumtionsnivåer: Paketera inkluderad användning i kreditpooler

​

Centrala koncept

​

Kredittyper

​

Kreditens livscykel

​

Källor för beviljande

​

Skapa krediter

1

Navigate to Credits

Gå till Produkter på din instrumentpanel och välj fliken Krediter. Klicka på Skapa kredit för att börja.

2

Configure Basic Information

Ange ett Credit Name – detta är din interna identifierare för krediten.

3

Set General Settings

Konfigurera kredittype och visningsegenskaper:

​

Credit Type

string

obligatorisk

Välj Anpassad enhet eller Fiat-krediter.

• Custom Unit: Definiera ditt eget mått (tokens, API-anrop, beräkningstimmar). Kräver ett Unit Name (till exempel “Platform tokens”) och en inställning för Precision.
• Fiat Credits: Krediter representerar ett verkligt penningvärde. Kräver ett val av Unit Currency (USD, EUR, GBP, INR med flera).

​

Unit Name

string

Endast för krediter av typen Custom Unit. Etiketten som kunderna ser för denna kredit (till exempel “AI Tokens” eller “API Calls”). Visas i kassan och i kundportalen.

​

Precision

number

Endast för krediter med anpassad enhet. Antal tillåtna decimaler, från 0 till 10:

• 0: Heltal (bäst för räkningsbara objekt som API-anrop)
• 1: En decimal (0.0)
• 2: Två decimaler (0.00) – standard
• 3: Tre decimaler (0.000)
• Upp till 10: För enheter med hög precision (till exempel bråkdelar av tokens eller mikrokonsumtion)

Precision kan inte ändras efter att krediten har skapats.

​

Credit Expiry

string

Hur länge krediter förblir giltiga efter utfärdande:

• 7 dagar, 30 dagar (standard), 60 dagar, 90 dagar, Anpassad, eller Aldrig

Välj Anpassad för att specificera ett anpassat antal dagar (minst 1).

4

Configure Subscription Settings (Optional)

Dessa inställningar styr kreditens beteende inom återkommande prenumerationer:

​

Rollover

boolean

Låt outnyttjade krediter överföras till nästa faktureringscykel. När det är aktiverat, konfigurera:

• Max Rollover Percentage (0–100 %): Begränsa hur mycket som förs över
• Rollover Timeframe: Hur länge överförda krediter förblir giltiga (till exempel 1 Month)
• Max Rollover Count: Maximalt antal på varandra följande överföringar innan krediterna förverkas

När krediter tar slut eller prenumerationen går ut:

​

Allow Overage

boolean

Låt kunderna fortsätta använda din tjänst när deras kredit balans når noll. När det är aktiverat, konfigurera:

• Overage Limit: Maximalt antal krediter som kunder kan använda utöver sitt saldo
• Price Per Unit: Kostnad per ytterligare kredit när överförbrukning är aktiverad (med valutaväljare)

​

Overage Behavior

string

obligatorisk

Styr hur överskridande hanteras i slutet av faktureringscykeln:

• Forgive overage at reset (standard): Användning utöver kreditgränsen spåras men debiteras inte. Saldot återställs vid varje cykel.
• Bill overage at billing: Användning utöver kreditgränsen debiteras på nästa faktura, varefter saldot återställs.
• Carry over deficit: Användning utöver kreditgränsen förs vidare som ett negativt saldo till nästa cykel.
• Carry over deficit (auto-repay): Underskottet förs vidare och återbetalas automatiskt från nya krediter i nästa cykel.

5

Create Credit

Klicka på Skapa kredit för att spara. Krediten är nu tillgänglig att bifoga till vilken produkt som helst.

Din kredittillgång är redo. Bifoga den till produkter för att börja utfärda krediter till kunder.

​

Bifoga krediter till produkter

​

Prenumerationsprodukter

1

Create or Edit a Subscription Product

Gå till Produkter → Skapa produkt eller redigera en befintlig produkt. Välj Prenumeration som prissättningstyp och konfigurera ditt återkommande pris.

2

Open Entitlements Section

Expandera avsnittet Rättigheter och klicka på Bifoga-knappen bredvid Krediter.

3

Select Credits to Attach

Ett Lägg till krediter-panel öppnas. Du kan välja en befintlig kredit från rullgardinsmenyn eller klicka på Skapa ny kredit för att definiera en direkt.

Du kan koppla upp till 5 krediter per produkt. Varje kredit kan ha sin egen konfiguration.

4

Configure Credit Settings

För varje bifogad kredit konfigurerar du:

​

Credits issued per billing cycle

number

obligatorisk

Antalet krediter som beviljas till kunden varje faktureringsperiod.

​

Low Balance Threshold

number

Meddela när saldot sjunker under denna procentsats (0–100). Användbart för att varna kunder innan saldot tar slut.

​

Credits During Free Trial

number

Ställ in en annan kreditbelopp för provperioder. Aktivera Avsluta provkrediter efter provperiodens slut för att återkalla outnyttjade provkrediter när provperioden konverteras till en betald prenumeration.

​

Allow Proration

boolean

Proportionera återstående krediter när en kund uppgraderar eller nedgraderar sin prenumerationsplan.

​

Import Default Credit Settings

boolean

Använd standardinställningarna för överföring, överskridande och utgång från krediträttigheten. Stäng av det här för att anpassa inställningar specifikt för den här produkten.

5

Review and Add

Granska den bifogade krediten som visar namn, mängd och utgång. Klicka på Lägg till i prenumeration för att bekräfta.

​

Engångsbetalningsprodukter

1

Create a One-Time Product

Skapa en produkt med prissättningstypen Engångsbetalning.

2

Attach Credits

Öppna avsnittet Rättigheter och bifoga krediter. Konfigurera antalet utfärdade krediter (totalt engångs beviljande) vid köp.

​

Användningsbaserade faktureringsprodukter

1

Create a Usage-Based Product

Välj Användningsbaserad fakturering som prissättningstyp. Konfigurera grundpriset och faktureringsfrekvensen.

2

Add a Meter

Klicka på knappen + i avsnittet Select meter för att lägga till en mätare. En prenumeration kan ha upp till 50 mätare.

3

Enable Credit Billing on the Meter

Växla Fakturera användning i krediter för att bifoga en kredit till mätaren. Välj krediträttigheten från rullgardinsmenyn.

​

Free Threshold

number

Gäller endast när mätaren fakturerar i pengar. När mätaren fakturerar i krediter dras varje enhet från kreditsaldot.

​

Bill usage in Credits

boolean

När det är aktiverat, drar mätaranvändningen från kundens kreditbalans istället för att debitera per enhet.

​

Meter units per credit

number

obligatorisk

Antalet användningsenheter som krävs för att dra av 1 kredit. Till exempel, om det är inställt på 1000, då förbrukar 1 000 API-anrop 1 kredit.

4

Configure Credit Issuance

Ställ in antalet utfärdade krediter och anpassa kreditinställningarna för den här produkten vid behov.

5

Verify Attachment

När det är konfigurerat visar mätaren det bifogade kreditnamnet, enhetspriset och den fria gränsen.

​

Kreditinställningar

​

Rollover

​

Överskridande

​

Utgång

​

Användningsbaserad fakturering med krediter

​

Så fungerar kreditavdrag baserade på mätare

1. Din applikation skickar användningshändelser: Varje händelse innehåller ett kund-ID, ett händelsenamn och metadata
2. Mätare sammanställer händelser: Med aggregering enligt Count, Sum, Max eller Last
3. Krediter dras automatiskt: En bakgrundsprocess bearbetar händelser varje minut, omvandlar mätarenheter till krediter enligt din konfigurerade kurs och drar av från kundens saldo enligt FIFO-ordning (tilldelningar som löper ut tidigast först)
4. Överförbrukning spåras: Om kreditsaldot når noll och överförbrukning är aktiverad spårar systemet användningen för överförbrukning för fakturering vid cykelns slut

​

Panelen Meters

​

Kundupplevelse

​

Kassa

​

Customer Portal

• Available Balance: Aktuellt kreditsaldo visas tydligt
• Credit Tabs: Växla mellan olika kredityper (till exempel “OpenAI Credits” eller “Usage Tokens”)
• Recent Transactions: Fullständig historik med datum, transaktions-ID, typ, belopp och löpande saldo

​

Prenumerationsdetaljer

• Credit allocation per faktureringscykel (till exempel “1000 credits each cycle”)
• Remaining balance (till exempel “7500 credits remaining”)
• Renewal date för nästa kredittilldelning
• Fliken Usage History med uppdelning på mätarnivå som visar förbrukade enheter, tröskelvärden, enhetspriser och totala kostnader

​

Transaktionsdetaljer

​

Hantera krediter

​

Vyer på instrumentpanelen

​

Lista över kreditförmåner

​

Kundens kreditdetaljer

• Credit Selector - Växla mellan olika kreditförmåner
• Available Balance - Aktuellt saldo i en stor och tydlig visning
• Apply Credit/Debit - Knapp för att manuellt justera kundens saldo
• Recent Transactions - Fullständigt ledger med datum, transaktions-ID, typ, belopp och löpande saldo

​

Manuella justeringar

​

Kreditens ledger

​

Webhooks

​

API-hantering

​

Integrationsexempel

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode', // defaults to 'live_mode'
});

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_ai_pro_plan',
      quantity: 1,
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

await client.usageEvents.ingest({
  events: [{
    event_id: `gen_${Date.now()}`,
    customer_id: 'cus_abc123',
    event_name: 'ai.generation',
    timestamp: new Date().toISOString(),
    metadata: { model: 'gpt-4', tokens: 1500 }
  }]
});

​

Verkliga exempel

​

Bästa praxis

• Börja enkelt: Börja med en enda kredityp och ingen överföring. Lägg till komplexitet baserat på kundfeedback och användningsmönster.
• Sätt tydliga förväntningar: Visa kredittilldelningar, återstående saldon och priser för överförbrukning tydligt på dina produktsidor och i kundportalen.
• Använd meningsfulla enheter: Namnge krediter efter vad de representerar (till exempel “API Calls” eller “AI Tokens”) i stället för generiska termer. Det hjälper kunderna att förstå värdet.
• Konfigurera utgång efter behov: Korta utgångsperioder (7 dagar) skapar brådska men kan frustrera kunder. Längre perioder (30–90 dagar) är mer kundvänliga för de flesta SaaS-produkter.
• Övervaka låga saldon: Ange trösklar för lågt saldo för att avisera kunder innan krediterna tar slut och därmed minska oväntade avgifter för överförbrukning.
• Testa i testläge: Skapa krediter, koppla dem till testprodukter och simulera hela cykeln köp → användning → avdrag → utgång innan du går live.