> ## 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.81.0 (6 februari 2026)

> Tredjepartsanalys, anpassning av checkouttema, förhindra planändring vid betalningsfel och balansbokförings-API

## Nya funktioner

### 1. **Stöd för tredjepartsanalys**

Spåra kundbeteende i Storefront, Checkout och Customer Portal med Google Analytics 4, Google Tag Manager och Meta Pixel. Lägg till dina spårnings-ID:n i **Settings → Analytics** för att börja samla e-handelshändelser.

**Stödda plattformar**

| Plattform          | ID-format              |
| ------------------ | ---------------------- |
| Google Analytics 4 | `G-XXXXXXXXXX`         |
| Google Tag Manager | `GTM-XXXXXXX`          |
| Meta Pixel         | Numeric (10-20 digits) |

**Spårade händelser**

Händelser som `purchase`, `add_payment_info`, `view_item` och `view_item_list` skickas automatiskt till dina analysplattformar när kunder bläddrar och genomför köp.

<Check>
  Stöds i Storefront, värdad Checkout, overlay/inline Checkout och Customer Portal.
</Check>

Läs mer: [Third-Party Analytics](/features/analytics)

### 2. **Anpassning av checkouttema**

Anpassa checkoutens utseende via `customization.theme_config`-parametern när du skapar checkoutsessioner. Konfigurera färger, typsnitt, hörnradie och knapptext för både ljusa och mörka lägen.

**Konfigurationsalternativ**

| Egenskap           | Beskrivning                         |
| ------------------ | ----------------------------------- |
| `light` / `dark`   | Färgscheman för varje läge          |
| `font_primary_url` | Anpassad typsnitt-URL               |
| `font_size`        | `xs`, `sm`, `md`, `lg`, `xl`, `2xl` |
| `radius`           | Hörnradie (t.ex. `8px`)             |
| `pay_button_text`  | Anpassad knapptext                  |

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  customization: {
    theme_config: {
      radius: '8px',
      pay_button_text: 'Complete Purchase',
      light: { button_primary: '#0066ff', text_primary: '#1a1a1a' },
      dark: { button_primary: '#3385ff', text_primary: '#ffffff' }
    }
  },
  return_url: 'https://yoursite.com/return'
});
```

Läs mer: [Checkout Theme Customization](/features/checkout#checkout-theme-customization)

### 3. **Förhindra planändring vid betalningsfel**

Ny `on_payment_failure`-parameter för ändringar av prenumerationsplaner styr beteendet när betalningen misslyckas.

| Läge             | Beteende                                                                |
| ---------------- | ----------------------------------------------------------------------- |
| `prevent_change` | Behåll prenumerationen på nuvarande plan tills betalningen lyckas       |
| `apply_change`   | Tillämpa planändringen omedelbart oavsett betalningsresultat (standard) |

```typescript theme={null}
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  on_payment_failure: 'prevent_change'
});
```

<Tip>
  Använd `prevent_change` för kritiska uppgraderingar där du vill säkerställa betalning innan premiumfunktioner aktiveras.
</Tip>

Läs mer: [Handling Payment Failures](/developer-resources/subscription-upgrade-downgrade#handling-payment-failures)

## API-uppdateringar

### Balance Ledger API

Ny `GET /balances/ledger`-slutpunkt för att hämta ditt kontos posteringar med filtrering och paginering.

| Parameter                           | Beskrivning                                                      |
| ----------------------------------- | ---------------------------------------------------------------- |
| `created_at_gte` / `created_at_lte` | Filtrera efter datumintervall                                    |
| `event_type`                        | Filtrera efter `payment`, `refund`, `dispute`, `payout` med mera |
| `currency`                          | Filtrera efter valutakod                                         |
| `reference_object_id`               | Filtrera efter specifikt betalnings-/återbetalnings-/tvist-ID    |

Läs mer: [Balance Ledger API](/api-reference/balance-ledger/list-ledger-entries)

### Betalningssvar: `refund_status`

Lade till fältet `refund_status` i `GET /payments/{payment_id}`-svaret för att snabbt kontrollera om en betalning har återbetalats utan att separat fråga refunds-endpointen.