Integrationen · Zahlungsanbieter
Paddle-Transaktionen, Verlängerungen und Erstattungen, mit dem Besuch verknüpft.
Verbinde Paddle Billing mit einem API-Schlüssel, der auf vier Berechtigungen beschränkt ist. Tally liest jede abgeschlossene Transaktion, unterscheidet neue Verkäufe von Verlängerungen und Upgrades und verknüpft jede mit dem Besucher, dessen ID in den Custom Data des Checkouts mitkam.
14 Tage kostenlos, ohne Kreditkarte.
01Was Tally liest
- Jede Transaktion, die Paddle abschließt: Checkouts über Paddle.js, über die API erstellte Transaktionen und Abo-Zyklen.
- Die Art aus dem Ursprung der Transaktion: Neuverkauf, Verlängerung oder Upgrade, wobei Einmalbelastungen auf ein Abo als Expansion zählen; eine Testphase, aus der ein Abo wird, zählt als neu.
- Erstattungen und Rückbuchungen aus Adjustments, sobald Paddle sie genehmigt; Gutschriften bewegen kein Geld und bleiben außen vor.
- Beträge vor Steuern, zum Referenzkurs des Tages in US-Cent umgerechnet.
- Sandbox-Schlüssel verbinden sich im Testmodus, so lässt sich ein Sandbox-Checkout von Anfang bis Ende ausprobieren.
02Wie ein Verkauf seinen Besuch findet
- Paddle.js customDataÜbergib die Besucher-ID als tally_visitor_id in customData, wenn du den Checkout öffnest. Paddle kopiert sie vom Abo in jede Verlängerung, die damit ebenfalls verknüpft ist.
- custom_data der TransaktionEine Transaktion, die dein Server erstellt, trägt denselben Eintrag in ihren custom_data.
- E-MailDie E-Mail des Kunden, sofort gehasht, stimmt mit einem tally('identify')-Aufruf auf deiner Website überein. Mittlere Sicherheit.
03Was es nicht lesen kann
- Paddle dokumentiert keinen Weg, die Besucher-ID durch seinen gehosteten Checkout oder den Standard-Zahlungslink zu reichen, daher werden diese Verkäufe nur per E-Mail verknüpft.
- Alte API-Schlüssel aus der Zeit, bevor Paddle Berechtigungen einführte, lassen sich nicht einschränken und werden daher abgelehnt.
- Eine Erstattung, die noch auf die Genehmigung von Paddle wartet, zählt erst, wenn sie genehmigt ist; eine abgelehnte nie.
- Adjustments an Transaktionen, die älter sind als die importierten 365 Tage, werden nicht übernommen.
04Verbinden
- Öffne in Paddle „Developer tools“, „Authentication“ und erstelle einen API-Schlüssel mit den vier Berechtigungen unten.
- Füge ihn auf der Seite „Integrations“ deiner Website ein; jede Berechtigung wird mit einem eigenen Aufruf geprüft.
- Tally legt in Paddle ein eigenes Benachrichtigungsziel an und importiert die Transaktionen der letzten 365 Tage.
- Ergänze tally_visitor_id in customData, wo du Paddle.js-Checkouts öffnest; die Seite „Coverage“ hat die Zeilen für deine Seite und für Transaktionen, die dein Server erstellt.
Was der API-Schlüssel braucht
Tally verlangt einen API-Schlüssel, der nur das kann, und prüft jede Berechtigung beim Einfügen mit einem echten Aufruf, sodass eine fehlende genannt wird:
| Berechtigung | Zugriff | Wozu |
|---|---|---|
| Transaction | Lesen | Jede Zahlung: Betrag, Steuer, Herkunft und Custom Data. |
| Adjustment | Lesen | Erstattungen und Rückbuchungen. |
| Customer | Lesen | Die E-Mail-Adresse des Kunden für den Abgleich mit tally('identify'): sofort gehasht, nie gespeichert. |
| Notification setting | Schreiben | Tally fügt ein eigenes Benachrichtigungsziel hinzu, damit Zahlungen innerhalb von Sekunden ankommen. |
Wo du ihn erstellst: Paddle, Developer tools, Authentication.
05Fragen
Funktioniert Tally mit Paddle Classic?
Tally liest Paddle Billing, API-Version 1, mit Schlüsseln, die Berechtigungen tragen. Ein alter Schlüssel ohne Berechtigungen wird mit einem Satz abgelehnt, der genau das sagt.
Warum braucht Paddle vier Berechtigungen?
Transaktionen für die Zahlungen, Adjustments für Erstattungen und Rückbuchungen, Kunden für den E-Mail-Abgleich und Benachrichtigungseinstellungen, damit Tally ein eigenes Ziel anlegen und binnen Sekunden von jeder Zahlung erfahren kann.
Werden Rückbuchungen gezählt?
Ja: Ein genehmigtes Rückbuchungs-Adjustment ist eine negative Rückbuchung, und ein rückgängig gemachtes kommt als positiv zurück, so heben sich beide beim zugehörigen Verkauf auf.