> ## 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.
# v1.86.0 (2 mars 2026)
> Kreditbaserad fakturering med överföring, övertrassering och utgångskontroller, enhetlig design- och temaanpassningsnav, återbetalnings- och tviststatus i List Payments API, återbetalningstabelL i Customer Portal och kopiera till live-läge för mätare
## Ny funktionalitet
### 1. **Kreditbaserad fakturering**
Dodo Payments stöder nu **kreditbaserad fakturering**, ett flexibelt system för att utfärda, hantera och spåra krediträttigheter över prenumerationer, engångsprodukter och fakturering baserad på användning. Istället för att debitera per användning eller begränsa åtkomst via funktionsflaggor fördelar du en pool med krediter som kunderna använder när de nyttjar din tjänst.
**Vad du kan göra**
| Funktion | Beskrivning |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Anpassade enheter eller fiat-krediter** | Definiera krediter i din egen enhet (API-anrop, tokens, beräkningstimmar) eller som faktisk valuta (USD, EUR) |
| **Prenumerationskrediter** | Utfärda krediter per faktureringscykel med automatisk återutgivning vid förnyelse |
| **Engångskrediter** | Tilldela en fast kreditbalans vid köp, idealiskt för påfyllnadspaket eller kampanjbundles |
| **Avdrag baserat på användning** | Koppla krediter till mätare för automatisk avdrag baserat på realtidsförbrukning |
| **Överföring** | Tillåt oanvända krediter att föras vidare med konfigurerbar maxprocent, tidsram och antal överföringar |
| **Kontroller för övertrassering** | Låt kunder fortsätta använda tjänsten efter saldot är slut, med alternativ att efterge, fakturera eller föra vidare underskottet |
| **Utgång** | Ange kreditgiltighet från 7 dagar till aldrig, med anpassade dagar |
**Kreditlivscykel**
1. **Krediter utfärdas** - Ges när en kund köper en produkt med tillhörande krediträttigheter. För prenumerationer återutges krediter varje faktureringscykel.
2. **Krediter konsumeras** - Dras av när kunder använder din tjänst. Mätare drar automatiskt av krediter baserat på realtids-händelser, eller så kan du dra av manuellt via panelen eller API:t.
3. **Krediter förfaller eller överförs** - I slutet av faktureringscykeln (eller efter den konfigurerade utgångsperioden) förfaller oanvända krediter eller överförs beroende på dina inställningar.
4. **Hantering av övertrassering** - Om krediter tar slut mitt i cykeln kan du tillåta fortsatt användning och välja hur övertrassering hanteras i slutet av cykeln.
**Fästa krediter vid produkter**
Krediter fästs som **rättigheter** i skapandeprocessen för produkter. Du kan fästa upp till **3 krediter per produkt**, och krediter fungerar med alla tre prissättningsmetoder: prenumerationer, engångsbetalningar och fakturering baserad på användning.
```typescript theme={null}
// Create a checkout session for a product with attached credits
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'
});
```
**Avdrag baserat på användning**
När krediter kopplas till mätare drar systemet automatiskt av krediter baserat på ingående användningshändelser. Konfigurera **meter units per credit**-hastigheten för att styra omvandlingen (t.ex. 1 000 API-anrop = 1 kredit).
```typescript theme={null}
// Send usage events that deduct credits automatically
await fetch('https://test.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: `gen_${Date.now()}`,
customer_id: 'cus_abc123',
event_name: 'ai.generation',
timestamp: new Date().toISOString(),
metadata: { model: 'gpt-4', tokens: 1500 }
}]
})
});
```
**Kundupplevelse**
Kunder kan visa och hantera sina kreditbalanser i **Customer Portal** under Credits-sektionen, med tillgängligt saldo, transaktionshistorik och användningsuppdelningar. Krediter visas också i kassan, prenumerationsdetaljer och betalningstransaktionssidor.
**Webhooks**
Kreditbaserad fakturering utlöser webhook-händelser för varje förändring i kreditlivscykeln:
| Händelse | Beskrivning |
| --------------------------- | ---------------------------------------------------------- |
| `credit.added` | Krediter beviljade till en kund |
| `credit.deducted` | Krediter förbrukade genom användning eller manuellt avdrag |
| `credit.expired` | Oanvända krediter förfallna |
| `credit.rolled_over` | Krediter förts vidare till ett nytt tilldelningssegment |
| `credit.rollover_forfeited` | Krediter förlorade vid max antal överföringar |
| `credit.overage_charged` | Avgifter för övertrassering applicerade |
| `credit.manual_adjustment` | Manuell kredit-/debitjustering gjord |
| `credit.balance_low` | Saldo sjönk under konfigurerad tröskel |
Börja med enkla inställningar: ingen överföring, ingen övertrassering, och lägg till komplexitet när du lär dig hur kunder använder krediter. De flesta inställningar kan uppdateras när som helst utan att påverka befintliga tilldelningar.
Läs mer: [Credit-Based Billing](/features/credit-based-billing) | [Credit Webhook Payloads](/developer-resources/webhooks/intents/credit) | [Credit Entitlements API](/api-reference/credit-entitlements/create-credit-entitlement)
### 2. **Design- och tema-anpassning**
Vi introducerar den nya **Design**-sidan, ett enhetligt nav för att anpassa utseendet på din kassa, butik och Customer Portal från en och samma plats. Välj förbyggda teman, konfigurera typografi och färger, och tillämpa sektion-visa överskridanden – allt med liveförhandsvisning innan du sparar.
**Höjdpunkter**
| Funktion | Beskrivning |
| ------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Enhetligt designnav** | Konfigurera utseendet för kassa, butik och Customer Portal från en sida |
| **Förbyggda teman** | Börja med ett kuraterat tema (Dodo Pulses, Terminal, Bumblebee eller Bubblegum) och anpassa därifrån |
| **Ljus- och mörkerläge** | Definiera separata färgpaletter för respektive läge |
| **Liveförhandsvisning** | Se hur dina ändringar ser ut i kassan, Customer Portal och butik innan du sparar |
| **Sektion-visa överskridanden** | Finjustera individuella sektioner utan att påverka övriga |
| **Programmatisk kontroll** | Överstyr teman vid kassa via API eller Checkout SDK |
**Kom igång**
Navigera till **Design** i huvudmenyn i Merchant Dashboard. Sidan har fyra flikar:
| Flik | Syfte |
| ------------------- | ------------------------------------------------------------------- |
| **General** | Företagsnamn, logotyp, temaval och globala avancerade inställningar |
| **Checkout** | Överstyr temainställningar specifikt för kassasidan |
| **Storefront** | Överstyr temainställningar och konfigurera butikslayouten |
| **Customer Portal** | Överstyr temainställningar för Customer Portal |
**Avancerade inställningar**
Expandera Avancerade inställningar på fliken General för detaljerad kontroll över typografi (primära/sekundära Google Fonts, teckenstorlek, teckenbredd), färgkonfiguration (separata paletter för ljust och mörkt läge som täcker bakgrunder, text, knappar och ramar) och border-radius för att kontrollera rundheten på UI-element.
**Förbyggda teman**
Fyra kuraterade teman levereras färdiga:
* **Dodo Pulses** - Standardtemat med limegröna accenter och ren sans-serif-typografi
* **Terminal** - Utvecklarorienterat med monospace-typografi och kungligt blå accenter
* **Bumblebee** - Varma amber- och guldaccenter med fet, premium känsla
* **Bubblegum** - Lekfulla rosa och magenta accenter med helt rundade hörn
Efter att ha valt ett förbyggt tema kan du vidare anpassa individuella egenskaper i Avancerade inställningar. Alla icke specificerade egenskaper återgår till temats standardvärden.
Läs mer: [Design & Theme Customization](/features/design) | [Checkout Features](/features/checkout) | [Storefront](/features/storefront)
### 3. **Återbetalningsstatus och tviststatus i List Payments API**
Listendpointen `GET /payments` innehåller nu fälten `refund_status` och `dispute_status` i varje betalningspost, så att du snabbt kan se återbetalnings- och tviststatus utan att hämta individuella betalningsdetaljer.
| Fält | Typ | Beskrivning |
| ---------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `refund_status` | `partial \| full \| null` | Sammanfattning av återbetalningsstatusen för denna betalning. `null` om inga lyckade återbetalningar finns |
| `dispute_status` | `string \| null` | Den senaste tviststatusen för denna betalning. `null` om inga tvister finns |
**`dispute_status`-värden**: `dispute_opened`, `dispute_expired`, `dispute_accepted`, `dispute_cancelled`, `dispute_challenged`, `dispute_won`, `dispute_lost`
Använd dessa fält för att bygga instrumentpaneler för tvister och återbetalningar, utlösa varningar vid statusändringar för tvister, eller lyfta fram betalningar som behöver uppmärksamhet.
Läs mer: [List Payments API](/api-reference/payments/get-payments)
### 4. **Återbetalningstabellen i kundportalen**
Kundportalen innehåller nu en dedikerad avsnitt för **Återbetalningar** där kunder kan se alla återbetalningar kopplade till sina betalningar. Varje post visar återbetalningsbeloppet, status, datum och den ursprungliga betalningen det utfärdades mot, vilket ger kunder full transparens i sin återbetalningshistorik utan att behöva kontakta support.
Återbetalningstabellen är automatiskt tillgänglig i kundportalen för alla företag. Ingen konfiguration behövs.
Läs mer: [Kundportal](/features/customer-portal)
### 5. **Kopiera till live-läge för mätare**
Du kan nu **kopiera mätare från testläge till live-läge** direkt från instrumentpanelen. När du har slutfört testningen av en mätarkonfiguration i testläge, använd kopieringsåtgärden för att återskapa den till live-läge med alla inställningar bevarade: aggregationstyp, eventnamn, filter och kreditassociationer. Detta eliminerar behovet av att manuellt återskapa mätare när du flyttar från utveckling till produktion.
Bygg och validera dina mätarkonfigurationer i testläge först, kopiera dem sedan till live-läge när du är redo att gå till produktion. Detta säkerställer att din faktureringskonfiguration testas innan den hanterar verklig kundanvändning.
Läs mer: [Användningsbaserad Fakturering](/features/usage-based-billing/introduction) | [Mätare](/features/usage-based-billing/meters)