> ## 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. Februar 2026)

> Drittanbieter-Analysen, Checkout-Theme-Anpassung, Planänderung bei fehlgeschlagenen Zahlungen verhindern und Balance-Ledger-API

## Neue Funktionen

### 1. **Unterstützung für Drittanbieter-Analysen**

Verfolgen Sie das Kundenverhalten über Storefront, Checkout und Customer Portal mit Google Analytics 4, Google Tag Manager und Meta Pixel. Fügen Sie Ihre Tracking-IDs unter **Settings → Analytics** hinzu, um mit der Erfassung von E-Commerce-Ereignissen zu beginnen.

**Unterstützte Plattformen**

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

**Erfasste Ereignisse**

Ereignisse wie `purchase`, `add_payment_info`, `view_item` und `view_item_list` werden automatisch an Ihre Analyseplattformen gesendet, während Kund:innen stöbern und Käufe abschließen.

<Check>
  Unterstützt auf Storefront, gehostetem Checkout, Overlay/Inline Checkout und Customer Portal.
</Check>

Mehr erfahren: [Third-Party Analytics](/features/analytics)

### 2. **Checkout-Theme-Anpassung**

Passen Sie das Checkout-Aussehen über den `customization.theme_config`-Parameter beim Erstellen von Checkout-Sessions an. Konfigurieren Sie Farben, Schriftarten, Border-Radius und Schaltflächentext für den Hell- und Dunkelmodus.

**Konfigurationsoptionen**

| Property           | Description                           |
| ------------------ | ------------------------------------- |
| `light` / `dark`   | Farbschemata für jeden Modus          |
| `font_primary_url` | Benutzerdefinierte Schriftart-URL     |
| `font_size`        | `xs`, `sm`, `md`, `lg`, `xl`, `2xl`   |
| `radius`           | Border-Radius (z. B. `8px`)           |
| `pay_button_text`  | Benutzerdefinierter Schaltflächentext |

```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'
});
```

Mehr erfahren: [Checkout Theme Customization](/features/checkout#checkout-theme-customization)

### 3. **Planänderung bei fehlgeschlagenen Zahlungen verhindern**

Neuer `on_payment_failure`-Parameter für Abo-Planänderungen steuert das Verhalten, wenn eine Zahlung fehlschlägt.

| Modus            | Verhalten                                                                         |
| ---------------- | --------------------------------------------------------------------------------- |
| `prevent_change` | Behalten Sie das Abonnement beim aktuellen Plan, bis die Zahlung erfolgreich ist  |
| `apply_change`   | Wenden Sie die Planänderung sofort an, unabhängig vom Zahlungsergebnis (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>
  Verwenden Sie `prevent_change` für kritische Upgrades, bei denen Sie sicherstellen möchten, dass die Zahlung erfolgt, bevor der Zugang zu Premium-Funktionen gewährt wird.
</Tip>

Mehr erfahren: [Handling Payment Failures](/developer-resources/subscription-upgrade-downgrade#handling-payment-failures)

## API-Updates

### Balance-Ledger-API

Neue `GET /balances/ledger`-Endpunkt zum Abrufen der Ledger-Einträge Ihres Kontos mit Filterung und Paginierung.

| Parameter                           | Beschreibung                                                |
| ----------------------------------- | ----------------------------------------------------------- |
| `created_at_gte` / `created_at_lte` | Filter nach Datumsbereich                                   |
| `event_type`                        | Filter nach `payment`, `refund`, `dispute`, `payout` usw.   |
| `currency`                          | Filter nach Währungscode                                    |
| `reference_object_id`               | Filter nach bestimmter Zahlungs-/Rückerstattungs-/Streit-ID |

Mehr erfahren: [Balance Ledger API](/api-reference/balance-ledger/list-ledger-entries)

### Zahlungsreaktion: `refund_status`

Das Feld `refund_status` wurde zur `GET /payments/{payment_id}`-Antwort hinzugefügt, um schnell zu überprüfen, ob eine Zahlung erstattet wurde, ohne den refunds-Endpunkt separat abzufragen.