> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Paddle einrichten

> Paddle-Zahlungen in deinem Komerza-Shop konfigurieren

Akzeptiere Zahlungen über Paddle in deinem Komerza-Shop. Paddle übernimmt die Checkout-UI — deine Kunden werden zu einer sicheren, von Paddle gehosteten Zahlungsseite weitergeleitet und nach Abschluss der Zahlung zurück zu deinem Shop gebracht.

## Voraussetzungen

* Ein [Paddle-Konto](https://www.paddle.com/) (kostenlos zu erstellen)

<Steps>
  <Step title="Deinen Paddle-API-Schlüssel erhalten">
    1. Melde dich in deinem [Paddle-Dashboard](https://vendors.paddle.com/) an
    2. Gehe zu **Entwickler-Tools → Authentifizierung**
    3. Klicke auf **API-Schlüssel generieren**
    4. Kopiere den Schlüssel — er beginnt mit `pdl_live_`

    <Note>
      **Zuerst testen?** Verwende stattdessen das [Sandbox-Dashboard](https://sandbox-vendors.paddle.com/). Sandbox-Schlüssel beginnen mit `pdl_test_` und es wird kein echtes Geld belastet.
    </Note>
  </Step>

  <Step title="Paddle mit Komerza verbinden">
    1. Gehe in deinem Komerza-Dashboard zu **Zahlungsmethoden**
    2. Suche **Paddle** und klicke auf **Konfigurieren**
    3. Füge deinen **API-Schlüssel** (aus Schritt 1) ein
    4. Klicke auf **Speichern**

    Komerza erstellt automatisch den Webhook-Endpunkt in deinem Paddle-Konto. Keine manuelle Webhook-Konfiguration erforderlich.
  </Step>

  <Step title="Verbindung überprüfen">
    Gehe im Dashboard zu **Zahlungsmethoden → Paddle**. Der Status zeigt:

    * **Aktiv** — Alles ist verbunden und funktioniert
    * **Inaktiv** — Überprüfe, ob dein API-Schlüssel korrekt ist

    <Note>
      Wenn der Status **Inaktiv** anzeigt, überprüfe, ob dein API-Schlüssel mit `pdl_live_` beginnt (oder `pdl_test_` für Sandbox).
    </Note>
  </Step>
</Steps>

## So funktioniert es

1. Ein Kunde wählt Paddle beim Checkout aus
2. Er wird zur sicheren, von Paddle gehosteten Checkout-Seite weitergeleitet
3. Nach der Zahlung wird er mit einer Bestätigung zu deinem Shop zurückgeleitet
4. Komerza erhält einen Webhook von Paddle zur Zahlungsbestätigung und liefert die Bestellung automatisch aus

## Zahlungen verwalten

* **Rückerstattungen** — Du kannst vollständige Rückerstattungen über Komerza ausstellen. Die Rückerstattung wird über Paddles System verarbeitet und der Kunde erhält sein Geld zurück.
* **Streitfälle** — Wenn ein Kunde einen Streitfall bei seiner Bank eröffnet, erhältst du eine Benachrichtigung in Komerza. Die Bestellung wird als strittig markiert und du kannst über Paddles Dashboard antworten.

## Sandbox-Tests

Wenn du vor dem Go-Live testen möchtest:

1. Erstelle ein [Sandbox-Konto](https://sandbox-vendors.paddle.com/)
2. Verwende deinen Sandbox-API-Schlüssel (`pdl_test_...`)
3. Es werden keine echten Kosten berechnet — du kannst den vollständigen Ablauf sicher testen
4. Trenne die Verbindung und verbinde dich mit deinem Produktions-API-Schlüssel erneut, wenn du bereit bist

## Paddle trennen

Gehe zu **Zahlungsmethoden → Paddle** und klicke auf **Trennen**. Dadurch wird auch der Webhook-Endpunkt aus deinem Paddle-Konto entfernt. Deine bestehenden Bestellungen sind nicht betroffen — nur neue Checkouts werden Paddle nicht mehr anbieten.

## Fehlerbehebung

| Problem                              | Lösung                                                                                                              |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| Zahlungen werden nicht abgeschlossen | Überprüfe, ob dein API-Schlüssel gültig ist und mit `pdl_live_` beginnt (oder `pdl_test_` für Sandbox)              |
| Inaktiver Status                     | Überprüfe deinen API-Schlüssel unter **Zahlungsmethoden → Paddle**                                                  |
| Keine Streitfall-Benachrichtigungen  | Kontaktiere den Support — der Webhook muss möglicherweise neu erstellt werden (Paddle trennen und erneut verbinden) |