Voraussetzungen
- Ein Paddle-Konto (kostenlos zu erstellen)
Deinen Paddle-API-Schlüssel erhalten
- Melde dich in deinem Paddle-Dashboard an
- Gehe zu Entwickler-Tools → Authentifizierung
- Klicke auf API-Schlüssel generieren
- Kopiere den Schlüssel — er beginnt mit
pdl_live_
Zuerst testen? Verwende stattdessen das Sandbox-Dashboard. Sandbox-Schlüssel beginnen mit
pdl_test_ und es wird kein echtes Geld belastet.Paddle mit Komerza verbinden
- Gehe in deinem Komerza-Dashboard zu Zahlungsmethoden
- Suche Paddle und klicke auf Konfigurieren
- Füge deinen API-Schlüssel (aus Schritt 1) ein
- Klicke auf Speichern
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
Wenn der Status Inaktiv anzeigt, überprüfe, ob dein API-Schlüssel mit
pdl_live_ beginnt (oder pdl_test_ für Sandbox).So funktioniert es
- Ein Kunde wählt Paddle beim Checkout aus
- Er wird zur sicheren, von Paddle gehosteten Checkout-Seite weitergeleitet
- Nach der Zahlung wird er mit einer Bestätigung zu deinem Shop zurückgeleitet
- 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:- Erstelle ein Sandbox-Konto
- Verwende deinen Sandbox-API-Schlüssel (
pdl_test_...) - Es werden keine echten Kosten berechnet — du kannst den vollständigen Ablauf sicher testen
- 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) |