> ## 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.
# Credit-Based Billing
> Issue, manage, and track credit entitlements across subscriptions, one-time products, and usage-based billing with rollover, overage, and expiration controls.
Kreditbaserad fakturering låter dig ge kunderna en balans av krediter - API-anrop, tokens, beräkningsenheter eller någon anpassad metrisk - och dra av från den balansen när de använder din tjänst. Krediter fungerar för alla produkttyper: prenumerationer, engångsköp och användningsbaserad fakturering.
## Vad är kreditbaserad fakturering?
Kreditbaserad fakturering ger dig ett flexibelt system för att utfärda krediträttigheter till kunder som en del av dina produkter. Istället för att debitera per användning eller begränsa tillgången genom funktionsflaggor, fördelar du en pool av krediter som kunder kan använda när de använder din tjänst.
Krediter är idealiska för:
* **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
När du skapar en kredit väljer du mellan två typer:
Definiera krediter i din egen enhet - tokens, API-anrop, beräkningstimmar eller någon metrisk som är meningsfull för din produkt. Anpassade enheter använder den precision du ställer in (0 till 3 decimaler).
**Bäst för**: API-anrop, AI-tokens, beräkningstimmar, lagringsenheter, meddelanden
Krediter representerar verkligt valuta värde (t.ex. USD, EUR). Kunderna får en monetär kredit balans som minskar när de använder din tjänst till ditt definierade pris.
**Bäst för**: Förbetalda saldon, kampanjkrediter, tjänstekompensation
### Kreditens livscykel
Krediter följer en tydlig livscykel från utfärdande till konsumtion:
Krediter beviljas när en kund köper en produkt (prenumeration eller engångs) med bifogade krediträttigheter. För prenumerationer utfärdas krediter på nytt vid varje faktureringscykel.
När kunder använder din tjänst dras krediter av. För användningsbaserade produkter drar mätarna automatiskt av krediter baserat på realtidshändelser. Du kan också dra av krediter manuellt via instrumentpanelen eller API.
I slutet av faktureringscykeln (eller efter den konfigurerade utgångsperioden), går outnyttjade krediter ut eller överförs till nästa period beroende på dina inställningar.
Om krediter tar slut mitt i cykeln, kan du tillåta överskridande (fortsatt användning bortom saldot) och välja hur överskridandet hanteras - förlåt det, fakturera det eller bär underskottet framåt.
### Källor för beviljande
Krediter kan beviljas från flera källor:
| Källa | Beskrivning |
| ----------------- | ----------------------------------------------------------------------------------- |
| **Prenumeration** | Krediter utfärdade med prenumeration, utfärdade på nytt vid varje faktureringscykel |
| **Engångs** | Krediter utfärdade med en engångsbetalning |
| **API** | Krediter beviljade manuellt via API eller instrumentpanel |
| **Rollover** | Krediter överförda från en tidigare faktureringscykel |
***
## Skapa krediter
Skapa krediträttigheter i avsnittet **Produkter → Krediter** på din instrumentpanel. Varje kredit definierar enheten, precisionen, utgångsreglerna och livscykelbeteendet.
Gå till **Produkter** på din instrumentpanel och välj fliken **Krediter**. Klicka på **Skapa kredit** för att börja.
Ange ett **Kreditnamn** - detta är din interna identifierare för krediten.
Konfigurera kredittype och visningsegenskaper:
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.).
Endast för anpassade enhetskrediter. Etiketten kunderna ser för denna kredit (t.ex. "AI Tokens", "API-anrop"). Visas i kassan och kundportalen.
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.
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).
Dessa inställningar styr kreditens beteende inom återkommande prenumerationer:
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:**
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)
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.
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.
Börja med enkla inställningar - ingen överföring, inget överskridande - och lägg till komplexitet när du ser hur kunder använder krediter. De flesta inställningar kan uppdateras när som helst utan att påverka befintliga beviljningar. Observera att **precision inte kan ändras** efter att en kredit har skapats.
***
## Bifoga krediter till produkter
Krediter är kopplade till produkter som **rättigheter** i produktens skapande- eller redigeringsflöde. Du kan koppla upp till **5 krediter per produkt**. Krediter fungerar med alla tre pristyper.
### Prenumerationsprodukter
För prenumerationer utfärdas krediter **per faktureringscykel** och kan konfigureras med proportionellt, provkrediter och cykelspecifika inställningar.
Gå till **Produkter → Skapa produkt** eller redigera en befintlig produkt. Välj **Prenumeration** som prissättningstyp och konfigurera ditt återkommande pris.
Expandera avsnittet **Rättigheter** och klicka på **Bifoga**-knappen bredvid **Krediter**.
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.
För varje bifogad kredit konfigurerar du:
Antalet krediter som beviljas till kunden varje faktureringsperiod.
Notera när krediter faller under den här mängden. Användbart för att varna kunder innan de tar slut.
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.
Proportionera återstående krediter när en kund uppgraderar eller nedgraderar sin prenumerationsplan.
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.
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
För engångsbetalningar utfärdas krediter **en gång** vid köpetillfället.
Skapa en produkt med prissättningstypen **Engångsbetalning**.
Öppna avsnittet **Rättigheter** och bifoga krediter. Konfigurera **antalet utfärdade krediter** (totalt engångs beviljande) vid köp.
Engångs kreditprodukter är idealiska för kreditinläggspaket, kampanjpaket, eller förbetalda kreditköp.
### Användningsbaserade faktureringsprodukter
För användningsbaserade produkter är krediter **länkade till mätare** och dras automatiskt av baserat på realtidens konsumtionshändelser.
Välj **Användningsbaserad fakturering** som prissättningstyp. Konfigurera grundpriset och faktureringsfrekvensen.
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**.
Växla **Fakturera användning i krediter** för att bifoga en kredit till mätaren. Välj krediträttigheten från rullgardinsmenyn.
Antalet enheter som är fria innan krediter börjar dras av.
När det är aktiverat, drar mätaranvändningen från kundens kreditbalans istället för att debitera per enhet.
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.
Ställ in antalet utfärdade krediter och anpassa kreditinställningarna för den här produkten vid behov.
När det är konfigurerat visar mätaren det bifogade kreditnamnet, enhetspriset och den fria gränsen.
När krediter är länkade till mätare, drar systemet automatiskt av krediter baserat på inkommande användningshändelser. En bakgrundsprocess hanterar händelser varje minut, aggregerar dem enligt mätarens konfiguration, och tillämpar FIFO (först in, först ut) avdrag från kundens äldsta icke-utgångna beviljanden.
***
## Kreditinställningar
### Rollover
Rollover låter outnyttjade krediter föras vidare till nästa faktureringscykel istället för att gå ut.
| Inställning | Beskrivning |
| ------------------------ | -------------------------------------------------------------------------------------------------------- |
| **Rollover Aktiverat** | Växla för att låta outnyttjade krediter föras vidare |
| **Max Rollover Procent** | Begränsa hur mycket som överförs (0–100%). Vid 50% rullar endast hälften av outnyttjade krediter över |
| **Rollover Tidsram** | Hur länge överförda krediter förblir giltiga (dag, vecka, månad, år) |
| **Max Rollover Antal** | Maximalt antal gånger som krediter kan överföras i rad. Efter denna gräns förverkas återstående krediter |
**Exempel**: En kund har 200 outnyttjade krediter vid cykelslut. Med 75% rollover, bärs 150 krediter vidare och 50 förverkas.
### Överskridande
Överskridande styr vad som händer när en kunds kreditbalans når noll mitt i cykeln.
| Inställning | Beskrivning |
| ------------------------- | --------------------------------------------------------------------------------- |
| **Tillåt Överskridande** | Växla för att låta kunder fortsätta använda tjänsten utöver sin kreditbalans |
| **Överskridandegräns** | Maximalt antal krediter kunder kan förbruka utöver sitt saldo |
| **Pris Per Enhet** | Kostnad per ytterligare kredit förbrukad som överskridande (med valuta) |
| **Överskridandebeteende** | Styr vad som händer med överskridande vid slutet av faktureringscykeln (se nedan) |
**Överskridandebeteendealternativ:**
| Beteende | Beskrivning |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Förlåt överskridande vid återställning** | 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** | Överskridande 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 |
När överskridande är inaktiverat kan kunder inte använda tjänsten när deras kreditbalans når noll. Välj ett överskridandebeteende som matchar din faktureringsmodell - **Förlåt vid återställning** är standard och enklaste alternativ.
### Utgång
| Inställning | Beskrivning |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------- |
| **Kreditutgång** | Varaktighet efter utfärdande innan krediter går ut (7, 30, 60, 90, anpassade dagar, eller aldrig) |
| **Provkrediter går ut efter provperiod** | Huruvida specifika provkrediter går ut när provperioden slutar |
Utgångna krediter skapar en `CreditExpired` lägerpost. Om rollover är aktiverat tillämpas rolloverprocent innan utgång, och endast återstoden går ut.
***
## Användningsfakturering med krediter
När krediter är länkade till användarmsmätare skapar systemet en kraftfull konsumtionsbaserad faktureringsmodell. Kunderna får en kreditallokering, och användningshändelser drar automatiskt av från deras balans.
### Hur mätarbaserat kreditavdrag fungerar
1. **Din applikation skickar användarhändelser** - Varje händelse inkluderar ett kund-ID, händelsenamn och metadata
2. **Mätare aggregerar händelser** - Använder Aggregering med Antal, Summa, Max eller Senaste
3. **Krediter dras av automatiskt** - En bakgrundsarbetare bearbetar händelser varje minut, konverterar mätarvärden till krediter med din konfigurerade takt och drar från kundens saldo med FIFO-ordning (äldsta beviljanden först)
4. **Överförbrukning spåras** - Om kreditsaldot når noll och överförbrukning är aktiverad, spårar systemet överförbrukning för slutfaktureringscykel
### Måttpanel
Användningsfaktureringsinstrumentpanelen inkluderar en **Mätare**-panel som visar alla definierade mätare med deras aggregeringstyp:
| Aggregering | Beskrivning | Exempel |
| ----------- | ------------------------- | -------------------------- |
| **Antal** | Totalt antal händelser | API-anrop |
| **Summa** | Summan av ett värdefält | Totalt överförda byte |
| **Max** | Högsta registrerade värde | Högsta samtidiga användare |
| **Senaste** | Senaste värdet | Aktuell lagring använd |
***
## Kundupplevelse
### Kassan
När en kund köper en produkt med bifogade krediter, visar kassasidan de inkluderade krediterna som en del av produkterbjudandet.
Krediter visas i en **Inkluderar**-sektion under produktbeskrivningen och visar kreditmängd och typ (t.ex. "\$1000 API-anrop").
### Kundportalen
Kunderna kan se och hantera sina kreditbalanser i kundportalen under sektionen **Krediter**.
Portalen visar:
* **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
Transaktionstyper som visas för kunder inkluderar:
| Typ | Beskrivning | Belopp |
| ------------------------------ | ---------------------------------------------------- | -------- |
| **Krediter med prenumeration** | Krediter utfärdade med prenumeration köp/förnyelse | Grön (+) |
| **Engångskrediter** | Krediter från engångsköp eller manuella beviljningar | Grön (+) |
| **Användningsavdrag** | Krediter förbrukade genom användning av tjänsten | Röd (-) |
| **Överskridande** | Användning bortom kreditbalans | Röd (-) |
### Prenumerationsdetaljer
Prenumerationsdetaljsidan visar krediträttigheter tillsammans med annan planinformation.
Nyckelinformation som visas:
* **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
Transaktionssidor för betalningar inkluderar en **Rättigheter**-sektion som visar alla rättigheter som levererades med betalningen, inklusive krediter.
***
## Hantera krediter
### Instrumentpanelsvyer
#### Krediträttighetslista
Se alla dina krediträttigheter i **Produkter → Krediter**. Tabellen visar kreditnamn, utgångsinställningar och ger snabba åtgärder för redigering eller arkivering.
#### Kundens kreditdetaljer
Visa en specifik kunds kreditbalanser och transaktionshistorik från **Kunder → \[Kundnamn] → Krediter**.
Kundens kredisvy inkluderar:
* **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
Du kan manuellt kreditera eller debitera en kunds balans direkt från instrumentpanelen:
Gå till **Kunder** och välj kunden.
Klicka på fliken **Krediter** och välj lämpligt kreditgodkännande från plånboksväljaren.
Klicka **Tillämpa Kredit/Debitering** för att öppna justeringsgränssnittet.
Välj **Kredit** för att lägga till krediter eller **Debitering** för att ta bort krediter från kundens balans.
Antalet krediter att lägga till eller ta bort.
Valfri förklaring för justeringen (t.ex. "Tjänstekompensation", "Kampanjbonus").
Granska och tillämpa justeringen. Förändringen återspeglas omedelbart i kundens balans och registreras i kreditliggaren.
Manuella justeringar skapar en `ManualAdjustment` liggarinlägg med fullständig spårningshistorik.
### Kreditliggare
Varje kreditåtgärd registreras i kreditliggaren, vilket ger en komplett spårningshistorik:
| Transaktionstyp | Beskrivning |
| --------------------------- | --------------------------------------------------------------------- |
| **Kredit tillagd** | Krediter beviljade (prenumeration, engångs, eller API) |
| **Kredit avdragen** | Krediter förbrukade genom användning eller manuell debitering |
| **Kredit utgånget** | Krediter utgångna utan överföring |
| **Kredit överfören** | Krediter förda vidare till nästa period |
| **Överföring förverkas** | Överförda krediter förverkas efter maximalt överföringsantal uppnåtts |
| **Överskridande debiterat** | Användning bortom kreditbalans med tillåtet överskridande |
| **Automatisk påfyllning** | Automatisk kreditpåfyllning vid låg balans |
| **Manuell justering** | Kredit eller debitering tillämpad manuellt av handlaren |
| **Återbetalning** | Krediter återbetalade |
Varje liggarinlägg registrerar saldon före och efter transaktionen, överskridande före och efter, en beskrivning, och referens till källan (betalning, prenumeration, etc.).
***
## Webhooks
Kreditbaserad fakturering genererar webhook-händelser för varje ändring i kreditens livscykel. Använd dessa för att hålla din applikation i synk med kreditbalanser, utlösa notifikationer, eller bygga anpassade faktureringsarbetsflöden.
| Händelse | Beskrivning |
| --------------------------- | ------------------------------------------------------------- |
| `credit.added` | Krediter beviljade till en kund |
| `credit.deducted` | Krediter förbrukade genom användning eller manuell debitering |
| `credit.expired` | Outnyttjade krediter utgånget |
| `credit.rolled_over` | Krediter förda vidare till en ny rättighet |
| `credit.rollover_forfeited` | Krediter förverkas vid maximalt överföringsantal |
| `credit.overage_charged` | Överskridandeavgifter tillämpade |
| `credit.manual_adjustment` | Manuell kredit/debiteringsjustering gjord |
| `credit.balance_low` | Balans föll under konfigurerad tröskel |
Alla huvudbokshändelser (`credit.added` till `credit.manual_adjustment`) inkluderar hela `CreditLedgerEntry` nyttolasten med saldo före/efter, överskott före/efter, källreferens och `metadata` av bidragets källprenumeration eller betalning (tom för bidrag som skapats direkt via API:et). Händelsen `credit.balance_low` inkluderar tröskelkonfigurationen och aktuellt saldo.
Visa fullständiga nyttolast scheman, fältbeskrivningar och integrations exempel för alla kreditwebhook-händelser.
***
## API-hantering
Använd API:t för att skapa kredittillgångar programmatiskt med full kontroll över överföring, överskridande och utgångsinställningar.
Skapa en ny kredittillgång med överföring, överskridande, och utgångskonfiguration.
Hämta alla kredittillgångar för ditt företag.
Hämta, uppdatera, eller ta bort kredittillgångar. Raderade tillgångar kan återställas.
Hämta en specifik kredittillgång via ID.
Uppdatera överföring, överskridande, utgång eller andra inställningar.
Mjuk-radera en kredittillgång.
Återställ en tidigare raderad kredittillgång.
Bevilja krediter direkt till en kunds balans utan krav på köp, eller skapa manuella debiteringar för faktureringsjusteringar.
Kreditera eller debitera en kunds balans med full spårningshistorik och idempotensstöd.
Hämta en kunds nuvarande kreditbalans, beviljandehistorik, och komplett transaktionshistorik för någon krediträtt.
Lista alla kundbalanser för en kredittillgång.
Hämta en specifik kunds balans.
Visa alla kreditbeviljningar för en kund.
Full transaktionshistorik för en kund.
### Integrations Exempel
Initiera Dodo Payments-klienten:
```typescript theme={null}
import DodoPayments from 'dodopayments';
const client = new DodoPayments({
bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
environment: 'test_mode', // defaults to 'live_mode'
});
```
Bifoga krediter till en prenumerationsprodukt under kassan:
```typescript theme={null}
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'
});
```
Skicka användningshändelser som automatiskt drar av krediter:
```typescript theme={null}
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
**Prissättningsstruktur:**
| Plan | Pris | Krediter/månad | Överskridande |
| ---------- | --------- | ---------------- | ------------- |
| Starter | \$29/mån | 10,000 tokens | \$0.003/token |
| Pro | \$99/mån | 100,000 tokens | \$0.002/token |
| Enterprise | \$499/mån | 1,000,000 tokens | \$0.001/token |
**Konfiguration:**
* Kredit typ: Anpassad enhet ("AI Tokens")
* Precision: 0 (hela tokens)
* Överföring: 25% max, 1 månads tidsram
* Överskridande: Aktiverat, fakturera överskridande vid fakturering
* Mätare: `ai.generation` med Summa aggregering på fältet `tokens`
**Prissättningsstruktur:**
| Plan | Pris | Krediter/månad | Överskridande |
| ---------- | -------- | -------------- | -------------- |
| Gratis | \$0/mån | 1,000 anrop | Blockerat |
| Utvecklare | \$19/mån | 50,000 anrop | \$0.001/anrop |
| Företag | \$99/mån | 500,000 anrop | \$0.0005/anrop |
**Konfiguration:**
* Kredit typ: Anpassad enhet ("API Calls")
* Precision: 0 (hela anrop)
* Överföring: Inaktiverad
* Överskridande: Utvecklare+ planer tillåter överskridande (förlåt vid återställning), gratis plan inaktiverar överskridande
* Mätare: `api.request` med Räkningsaggregering
**Prissättningsstruktur:**
| Plan | Pris | Krediter/månad | Överskridande |
| --------- | -------- | --------------- | --------------- |
| Personlig | \$9/mån | 100 GB-timmar | \$0.05/GB-timme |
| Team | \$49/mån | 1,000 GB-timmar | \$0.03/GB-timme |
**Konfiguration:**
* Kredit typ: Anpassad enhet ("GB-timmar")
* Precision: 2 (två decimaler)
* Överföring: 50% max, överförs en gång
* Överskridande: Aktiverat med 200% gräns
* Mätare: `storage.usage` med Summa aggregering
***
## 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.
Kreditbaserad fakturering fungerar sömlöst med alla andra Dodo Payments funktioner - prenumerationer med prov, planändringar med proportionering, och kundportalen. Börja med en grundläggande inställning och expandera när din prissättningsmodell utvecklas.
## Centrala koncept
### Kredittyper
När du skapar en kredit väljer du mellan två typer:
### Hur mätarbaserat kreditavdrag fungerar
1. **Din applikation skickar användarhändelser** - Varje händelse inkluderar ett kund-ID, händelsenamn och metadata
2. **Mätare aggregerar händelser** - Använder Aggregering med Antal, Summa, Max eller Senaste
3. **Krediter dras av automatiskt** - En bakgrundsarbetare bearbetar händelser varje minut, konverterar mätarvärden till krediter med din konfigurerade takt och drar från kundens saldo med FIFO-ordning (äldsta beviljanden först)
4. **Överförbrukning spåras** - Om kreditsaldot når noll och överförbrukning är aktiverad, spårar systemet överförbrukning för slutfaktureringscykel
### Måttpanel
Användningsfaktureringsinstrumentpanelen inkluderar en **Mätare**-panel som visar alla definierade mätare med deras aggregeringstyp:
| Aggregering | Beskrivning | Exempel |
| ----------- | ------------------------- | -------------------------- |
| **Antal** | Totalt antal händelser | API-anrop |
| **Summa** | Summan av ett värdefält | Totalt överförda byte |
| **Max** | Högsta registrerade värde | Högsta samtidiga användare |
| **Senaste** | Senaste värdet | Aktuell lagring använd |
***
## Kundupplevelse
### Kassan
När en kund köper en produkt med bifogade krediter, visar kassasidan de inkluderade krediterna som en del av produkterbjudandet.
Portalen visar:
* **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
Transaktionstyper som visas för kunder inkluderar:
| Typ | Beskrivning | Belopp |
| ------------------------------ | ---------------------------------------------------- | -------- |
| **Krediter med prenumeration** | Krediter utfärdade med prenumeration köp/förnyelse | Grön (+) |
| **Engångskrediter** | Krediter från engångsköp eller manuella beviljningar | Grön (+) |
| **Användningsavdrag** | Krediter förbrukade genom användning av tjänsten | Röd (-) |
| **Överskridande** | Användning bortom kreditbalans | Röd (-) |
### Prenumerationsdetaljer
Prenumerationsdetaljsidan visar krediträttigheter tillsammans med annan planinformation.
Nyckelinformation som visas:
* **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
Transaktionssidor för betalningar inkluderar en **Rättigheter**-sektion som visar alla rättigheter som levererades med betalningen, inklusive krediter.
***
## Hantera krediter
### Instrumentpanelsvyer
#### Krediträttighetslista
Se alla dina krediträttigheter i **Produkter → Krediter**. Tabellen visar kreditnamn, utgångsinställningar och ger snabba åtgärder för redigering eller arkivering.
Kundens kredisvy inkluderar:
* **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
Du kan manuellt kreditera eller debitera en kunds balans direkt från instrumentpanelen: