Paddle verbinden
Fügen Sie einen schreibgeschützten Paddle-API-Key ein, um Software- und SaaS-Verkäufe, Erstattungen und Steuern nach Produkt und Land zu importieren.
Paddle ist der Merchant of Record für Software, die Sie außerhalb der App-Stores verkaufen: Desktop-Apps, Web-Apps, SaaS-Pläne und Lizenzen. Die Verbindung erfolgt über einen einzigen schreibgeschützten API-Key statt über OAuth. Sie erstellen den Key im Paddle-Dashboard, fügen ihn in Revenue Sensor ein und wählen, welche Paddle-Produkte synchronisiert werden sollen. Der Key wird verschlüsselt gespeichert und verlässt unseren Server nie; Ihr Paddle-Login ist nie beteiligt.
Bevor Sie beginnen
- Zugriff auf das Paddle-Dashboard des Verkäuferkontos, dessen Verkäufe Sie erfassen möchten, mit der Berechtigung, unter Developer tools API-Keys zu erstellen.
- Wissen, ob Sie das Live-Konto oder die Sandbox möchten. Paddle vergibt für beide getrennte Keys, und der Key entscheidet, welches Konto wir lesen; mehr gibt es nicht auszuwählen.
Einen schreibgeschützten API-Key erstellen
- 1
Developer tools öffnen
Gehen Sie im Paddle-Dashboard zu Developer tools → Authentication und erstellen Sie einen neuen API-Key. Geben Sie ihm einen Namen, den Sie später wiedererkennen, etwa „Revenue Sensor“.
- 2
Nur Leseberechtigungen erteilen
Aktivieren Sie Lesezugriff für Transactions, Adjustments, Products und Addresses. Addresses steht unter Customers und liefert uns das Land des Käufers — lassen Sie es also aktiviert, auch wenn es unpassend klingt. Schreibberechtigungen werden nicht benötigt.
- 3
Den Key einmal kopieren
Paddle zeigt den Key nur ein einziges Mal beim Erstellen an. Kopieren Sie ihn sofort; wenn er verloren geht, widerrufen Sie ihn und erstellen Sie einen neuen.
Das Konto verbinden
- 1
Key einfügen
Integrations → Paddle → Connect in der Revenue-Sensor-Konsole, dann den API-Key einfügen. Revenue Sensor erkennt am Präfix, ob es ein Live- oder ein Sandbox-Key ist, und bestätigt, welches Konto verwendet wird, bevor Sie fortfahren.
- 2
Ihre Produkte auswählen
Synchronisiert werden Paddle-Produkte, keine Store-Apps. Wählen Sie die Produkte, die in der Übersicht erscheinen sollen; jedes erhält eine eigene Zeile beim Umsatz und kann einer App zugeordnet werden, wenn es zu einer gehört. Abgerufen wird nur, was Sie auswählen, und nur das zählt für Ihren Plan.
- 3
Die erste Synchronisierung laufen lassen
Paddle behält Ihre vollständige Historie, daher füllt die erste Synchronisierung bis zu ein Jahr bezahlter Transaktionen und Erstattungen nach. Das dauert meist ein paar Minuten, und Sie können die Seite währenddessen verlassen.
Was importiert wird
| Feld | Hinweise |
|---|---|
| Umsatz | Bezahlte Transaktionen, verbucht am Tag, an dem das Geld eingezogen wurde, nicht am Tag der Rechnungsstellung. Ausgewiesen pro Produkt, pro Tag und pro Käuferland, ohne Steuern. Paddles eigene Gebühr wird nicht abgezogen — genau wie Google Play brutto vor Googles Gebühr angezeigt wird. |
| Steuern | Paddle zieht als Merchant of Record Umsatz- und Mehrwertsteuer ein und weist sie auf jeder Position aus. Steuern werden daher separat importiert, und für diese Quelle steht die Ansicht inklusive Steuern zur Verfügung. |
| Erstattungen und Chargebacks | Genehmigte Erstattungen und Chargebacks mindern den Umsatz am Tag ihrer Genehmigung; der Betrag wird zusätzlich als Erstattungswert zur Einordnung mitgeführt. Ein zurückgenommener Chargeback bucht das Geld wieder ein. Gutschriften und Chargeback-Warnungen gelten nicht als Erstattungen. |
| Land | Aus der Rechnungsadresse des Kunden. Es wird nur der Ländercode verwendet. |
Jede Paddle-Währung wird unterstützt
Transaktionen werden in der Währung importiert, in der sie berechnet wurden, und wie jede andere Quelle umgerechnet. Währungen ohne Dezimalstellen wie JPY und KRW werden korrekt gelesen, sodass ein japanischer Verkauf nicht mit einem Hundertstel seines Werts erscheint.
Echtzeit-Updates (optional)
Revenue Sensor synchronisiert Paddle alle 30 Minuten. Wenn Sie einen neuen Verkauf oder eine Erstattung lieber innerhalb von ein bis zwei Minuten sehen möchten, richten Sie in Paddle ein Notification-Ziel auf uns ein. Die Zahlen stammen weiterhin aus Paddles API; der Webhook sagt uns nur, dass wir früher synchronisieren sollen.
- 1
Die Webhook-URL kopieren
Öffnen Sie die Paddle-Verbindung in der Revenue-Sensor-Konsole. Der Bereich „Real-time updates“ zeigt eine URL, die nur für diese Verbindung gilt; kopieren Sie sie.
- 2
Ein Notification-Ziel anlegen
Gehen Sie in Paddle zu Developer tools → Notifications → New destination. Fügen Sie die URL ein, wählen Sie Webhook als Typ und abonnieren Sie die Ereignisse transaction, adjustment und subscription.
- 3
Das Secret speichern
Paddle zeigt beim Anlegen des Ziels ein Signatur-Secret an. Fügen Sie es im Bereich „Real-time updates“ ein und speichern Sie. Wir prüfen damit jede Zustellung und verwerfen alles Unsignierte; es wird verschlüsselt gespeichert und nie wieder angezeigt.
Fehlerbehebung
- Der Key wird abgelehnt: Prüfen Sie, ob er Lesezugriff auf alle vier Bereiche Transactions, Adjustments, Products und Addresses hat. Ein Key ohne Addresses besteht die Grundprüfung, scheitert aber bei der Synchronisierung.
- Es werden keine Produkte angezeigt: Der Key gehört zu einem anderen Konto oder zur Sandbox, obwohl Sie Live erwartet haben (oder umgekehrt). Das Präfix des Keys verrät, welches.
- Ein Verkauf fehlt: Importiert werden nur bezahlte, abgeschlossene Transaktionen. Entwürfe, unbezahlte Rechnungen und stornierte Transaktionen sind noch kein Umsatz.
- Der Umsatz wirkt höher als Ihre Auszahlung: Das ist zu erwarten. Steuern werden separat geführt und Paddles Gebühr wird nicht abgezogen, die Zahl ist also der Bruttoumsatz vor Paddles Anteil.
- Eine Erstattung erscheint an einem anderen Tag als der Verkauf: Erstattungen werden am Tag ihrer Genehmigung verbucht und nicht auf den ursprünglichen Kauf zurückdatiert.