Integrationen · Zahlungsanbieter
Lemon-Squeezy-Bestellungen und Verlängerungen, mit ihren Besuchen verknüpft.
Verbinde einen Lemon-Squeezy-Shop mit einem API-Schlüssel. Tally liest Bestellungen und Abo-Rechnungen samt Erstattungen und verknüpft jeden Verkauf mit dem Besucher: über die ID, die in den Custom Data des Checkouts mitkam, oder über die E-Mail des Käufers.
14 Tage kostenlos, ohne Kreditkarte.
01Was Tally liest
- Bestellungen als neue Verkäufe, Abo-Rechnungen als Verlängerungen oder Tarifwechsel; die erste Zahlung eines Abos zählt einmal, als seine Bestellung.
- Erstattungen, ganz oder teilweise, aus der laufenden Erstattungssumme, die Lemon Squeezy führt; jede neue Summe fügt nur hinzu, was sich geändert hat.
- Shops im Test- und im Live-Modus gleichermaßen: Der Modus des Schlüssels entscheidet.
- Beträge ohne Steuern, in US-Cent zum Referenzkurs des Tages.
02Wie ein Verkauf seinen Besuch findet
- Custom Data im Checkout-LinkHänge checkout[custom][tally_visitor_id] an einen Checkout-Link an oder setze es in checkout_data.custom, wenn dein Server den Checkout erstellt.
- E-MailDie E-Mail des Käufers, gehasht, stimmt mit einem tally('identify')-Aufruf überein. Für Bestellungen von vor dem Verbinden ist sie die einzige Verknüpfung.
- Verlängerungen und ErstattungenEine Abo-Rechnung übernimmt die Verknüpfung ihrer ersten Bestellung; eine Erstattung zählt gegen die Bestellung oder Rechnung, zu der sie gehört.
03Was es nicht lesen kann
- Lemon Squeezy meldet keine Rückbuchungen: Es erstattet eine strittige Bestellung selbst, und das kommt als Erstattung an.
- Die API liefert keine Custom Data zurück, daher lassen sich Bestellungen von vor dem Verbinden nur per E-Mail verknüpfen.
- Das Snippet markiert Lemon-Squeezy-Checkout-Links nicht von selbst; die Seite „Coverage“ liefert die paar Zeilen, die das tun.
- API-Schlüssel haben keine Scopes; der geringste Zugriff ist daher ein Schlüssel nur für Tally, den sonst nichts nutzt.
04Verbinden
- Öffne in Lemon Squeezy „Settings“, „API“ und erstelle einen Schlüssel nur für Tally.
- Füge ihn auf der Seite „Integrations“ deiner Website ein. Ein Schlüssel sieht alle Shops seines Kontos, also nenne den Shop, wenn es mehrere gibt.
- Tally legt für diesen Shop einen Webhook mit eigenem Secret an und importiert die letzten 365 Tage.
- Ergänze die Besucher-ID in deinen Checkout-Links oder in checkout_data, wie es die Seite „Coverage“ zeigt.
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 |
|---|---|---|
| Orders | Lesen | Jeder Verkauf: Betrag, Steuer und Erstattungen sowie die E-Mail-Adresse des Kunden (sofort gehasht, nie gespeichert). |
| Subscription invoices | Lesen | Verlängerungen und Tarifwechsel. |
| Webhooks | Schreiben | Tally fügt dem Shop einen eigenen Webhook hinzu, damit Zahlungen innerhalb von Sekunden ankommen. |
Wo du ihn erstellst: Lemon Squeezy, Settings, API.
05Fragen
Kann ich mehr als einen Lemon-Squeezy-Shop verbinden?
Jeder Shop speist eine Website. Sieht ein Schlüssel mehrere Shops, wirst du gefragt, welchen du meinst, per ID, Slug, Domain oder Name, und ein Shop, der schon eine andere Website speist, wird abgelehnt.
Wie werden Teilerstattungen gezählt?
Lemon Squeezy führt statt einzelner Erstattungen einen laufenden Erstattungsbetrag, daher speichert Tally jede neue Summe als das, was sie hinzufügt. In welcher Reihenfolge sie auch eintreffen, Webhook und Import enden bei derselben Summe, mit anteilig erstatteter Steuer.
Warum haben alte Bestellungen keine Quelle?
Die API von Lemon Squeezy liefert die Custom Data eines Checkouts nicht zurück, daher lassen sich Bestellungen von vor dem Verbinden nur über die E-Mail des Käufers verknüpfen. Bestellungen ab dann tragen die Besucher-ID.