Integrationen · Zahlungsanbieter
Polar-Bestellungen und Abos, jeweils mit ihrer Quelle.
Verbinde Polar mit einem Organisations-Token, der auf fünf Scopes beschränkt ist. Tally liest Käufe und Abo-Zyklen samt Erstattungen und verlorenen Streitfällen und verknüpft jeden über Checkout-Metadaten, die Referenz eines Checkout-Links oder die E-Mail mit dem Besucher.
14 Tage kostenlos, ohne Kreditkarte.
01Was Tally liest
- Bestellungen, sobald sie bezahlt sind und Geld enthalten: Käufe und erste Abo-Zahlungen als neu, Zyklen und nutzungsbasierte Zyklen als Verlängerungen, Tarifwechsel als Upgrades.
- Erstattungen, ob ausstehend oder erfolgreich; schlägt eine fehl oder wird storniert, kommt ihre Gegenbuchung hinzu, sodass sich beide zu null aufheben.
- Verlorene Streitfälle als Rückbuchungen, ohne ihre Steuer.
- Beträge nach Rabatten und vor Steuern, in US-Cent zum Referenzkurs des Tages.
- Sandbox-Tokens verbinden sich im Testmodus.
02Wie ein Verkauf seinen Besuch findet
- Checkout-MetadatenDie Besucher-ID in den Metadaten eines Checkouts, die Polar in Bestellung und Abo übernimmt.
- Checkout-LinksDie reference_id eines Checkout-Links landet in den Metadaten des Checkouts und verknüpft wie ein Stripe Payment Link.
- E-MailDie E-Mail des Kunden, sofort gehasht, stimmt mit einem tally('identify')-Aufruf überein. Mittlere Sicherheit.
03Was es nicht lesen kann
- Polar sendet kein Event für Streitfälle, daher wird ein verlorener Streitfall erst gelesen, wenn sich seine Bestellung das nächste Mal ändert, oder bei einem erneuten Import.
- Das Snippet markiert Polar-Checkout-Links nicht von selbst; das erledigen ein paar Zeilen auf deiner Seite, für Links, die das Embed von Polar mit data-polar-checkout kennzeichnet.
- Bestellungen ohne Geld, etwa für kostenlose Produkte, sind keine Verkäufe und zählen nicht.
04Verbinden
- Öffne in Polar „Settings“, „Access Tokens“ und erstelle einen Organisations-Token mit den fünf Scopes unten.
- Füge ihn auf der Seite „Integrations“ deiner Website ein; jeder Scope wird geprüft, und ein Token für die Sandbox wird als Testmodus erkannt.
- Tally legt einen eigenen Webhook-Endpunkt an und importiert die letzten 365 Tage, Erstattungen und verlorene Streitfälle inklusive.
- Gib die Besucher-ID in den Checkout-Metadaten mit oder als reference_id an Checkout-Links, wie es die Seite „Coverage“ zeigt.
Was das Zugriffstoken braucht
Tally verlangt ein Zugriffstoken, das nur das kann, und prüft jede Berechtigung beim Einfügen mit einem echten Aufruf, sodass eine fehlende genannt wird:
| Berechtigung | Zugriff | Wozu |
|---|---|---|
| Organizations | organizations:read | Der Name der Organisation, damit du siehst, welche verbunden ist. |
| Orders | orders:read | Jede Zahlung: Betrag, Steuer, Metadaten und die E-Mail-Adresse des Kunden (sofort gehasht, nie gespeichert). |
| Refunds | refunds:read | Erstattungen. |
| Disputes | disputes:read | Rückbuchungen: verlorene Streitfälle. |
| Webhooks | webhooks:write | Tally fügt einen eigenen Webhook-Endpoint hinzu, damit Zahlungen innerhalb von Sekunden ankommen. |
Wo du ihn erstellst: Polar, Settings, Access Tokens.
05Fragen
Zählt Tally nutzungsbasierte Abrechnung über Polar?
Ja: Eine Bestellung für einen nutzungsbasierten Abo-Zyklus ist eine Verlängerung, gezählt mit dem Betrag, den Polar berechnet hat, und dem Besuch zugerechnet, der den Kunden gewonnen hat.
Warum braucht Polar den Scope für Streitfälle?
Polar sendet kein Event für Streitfälle, daher liest Tally die Disputes API, um verlorene Streitfälle zu finden und sie als Rückbuchungen gegen den Verkauf zu zählen.
Kann ich es zuerst in der Sandbox von Polar ausprobieren?
Ja. Füge einen Sandbox-Token ein, und die Integration verbindet sich im Testmodus, mit eigenem Webhook, so kannst du einen Sandbox-Checkout von Anfang bis Ende prüfen.