Credit-Based Billing

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

​

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 Kreditnamn - 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.

• Anpassad enhet - Definiera din egen metrisk (tokens, API-anrop, beräkningstimmar). Kräver ett Enhetsnamn (t.ex. “Plattformstokens”) och en Precision-inställning.
• Fiat-krediter - Krediter representerar verkligt valuta värde. Kräver en Valutaenhet-val (USD, EUR, GBP, INR, etc.).

​

Unit Name

string

Endast för anpassade enhetskrediter. Etiketten kunderna ser för denna kredit (t.ex. “AI Tokens”, “API-anrop”). Visas i kassan och kundportalen.

​

Precision

number

Endast för anpassade enhetskrediter. Antal tillåtna decimaler:

• 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)

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 Procent (0–100%) - Begränsa hur mycket som överförs
• Rollover Tidsram - Hur länge överförda krediter förblir giltiga (t.ex. 1 månad)
• Max Rollover Antal - Maximalt antal på varandra följande överföringar innan krediter 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:

• Överskridandegräns - Maximalt antal krediter kunderna kan förbruka utöver sitt saldo
• Pris Per Enhet - Kostnad per ytterligare kredit när överskridande är aktiverat (med valutaväljare)

​

Overage Behavior

string

obligatorisk

Styr hur överskridande hanteras i slutet av faktureringscykeln:

• Förlåt överskridande vid återställning (standard) - Användning bortom kreditgränsen spåras men debiteras inte. Saldo återställs vid varje cykel.
• Fakturera överskridande vid fakturering - Användning bortom kreditgränsen debiteras på nästa faktura, sedan återställs saldot.
• Bär över underskott - Användning bortom kreditgränsen förs över som ett negativt saldo till nästa cykel.
• Bär över underskott (automatiska återbetalningar) - Underskott förs över och återbetalas automatiskt med 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 bifoga upp till 3 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

Notera när krediter faller under den här mängden. Användbart för att varna kunder innan de 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 Välj mätare för att lägga till en mätare. En prenumeration kan ha upp till 3 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

obligatorisk

Antalet enheter som är fria innan krediter börjar dras av.

​

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ändningsfakturering med krediter

​

Hur mätarbaserat kreditavdrag fungerar

1. Din applikation skickar användningshändelser - Varje händelse inkluderar ett kund-ID, händelsenamn och metadata
2. Mätare aggregerar händelser - Använder räkning, summa, max, sista eller unik räkning aggregering
3. Krediter dras av automatiskt - En bakgrundsprocess hanterar händelser varje minut, konverterar mätarenheter till krediter med din konfigurerade ränta, och drar av från kundens balans med FIFO-ordning (äldsta beviljanden först)
4. Överskridande spåras - Om kreditbalansen når noll och överskridande är aktiverat, spårar systemet överskridande användning för fakturering i slutet av cykeln

​

Måttpanel

​

Kundupplevelse

​

Kassan

​

Kundportalen

• Tillgänglig Balans - Nuvarande kreditbalans visad framträdande
• Kredittabbar - Växla mellan olika kredittyper (t.ex. “OpenAI Credits”, “Usage Tokens”)
• Senaste Transaktioner - Full historik med datum, transaktions-ID, typ, belopp och löpande balans

​

Prenumerationsdetaljer

• Kreditallokering per faktureringscykel (t.ex. “1000 krediter varje cykel”)
• Återstående balans (t.ex. “7500 krediter kvar”)
• Förnyelsedatum för nästa kreditutfärdande
• Användningshistorik-flik med nivåuppdelning som visar förbrukade enheter, trösklar, enhetspriser och totala kostnader

​

Transaktionsdetaljer

​

Hantera krediter

​

Instrumentpanelsvyer

​

Krediträttighetslista

​

Kundens kreditdetaljer

• Kreditväljare - Växla mellan olika kredittillgångar
• Tillgänglig Balans - Nuvarande saldo i stor, framträdande visning
• Tillämpa Kredit/Debitering - Knapp för att manuellt justera kundens balans
• Senaste Transaktioner - Full huvudbok med datum, transaktions-ID, typ, belopp och löpande balans

​

Manuella justeringar

​

Kreditliggare

​

Webhooks

​

API-hantering

​

Integrations Exempel

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: 'prod_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 kredit typ och ingen överföring. Lägg till komplexitet baserat på kundfeedback och användningsmönster.
• Klart definiera förväntningar: Visa kreditallokeringar, återstående saldon, och prissättning för överskridande tydligt på dina produktsidor och kundportaler.
• Använd meningsfulla enheter: Namnge krediter efter vad de representerar (t.ex. “API-anrop”, “AI-tokens”) istället för generiska termer. Detta hjälper kunder att förstå värdet.
• Konfigurera utgång noggrant: Kortsiktiga utgångsfönster (7 dagar) driver på brådska men kan frustrera kunder. Längre fönster (30–90 dagar) är mer kundvänliga för de flesta SaaS-produkter.
• Övervaka låga saldon: Ställ in låga saldotrösklar för att varna kunder innan de tar slut, vilket minskar risken för överraskande överskridandeavgifter.
• Testa i testläge: Skapa krediter, bifoga dem till testprodukter, och simulera hela köp → användning → avdrag → utgångscykel innan du går live.