Polar

Verbinden Sie Polar mit einem Organisations-Zugriffstoken und fügen Sie einen Webhook für sofortige Synchronisierungen hinzu.

RevGlance liest mit einem Organisations-Zugriffstoken die Kunden, Abonnements und Bestellungen Ihrer Polar-Organisation. Es ändert nie etwas in Polar.

Verbinden

Öffnen Sie in Polar die Settings Ihrer Organisation und erstellen Sie ein organization access token. Nennen Sie es RevGlance.
Geben Sie ihm die Scopes customers:read, subscriptions:read und orders:read. Fügen Sie auch customer_sessions:write hinzu, wenn Sie Rückhol-E-Mails senden möchten.
Kopieren Sie das Token. Es beginnt mit polar_oat_.
Fügen Sie es unter Organisations-Zugriffstoken ein und wählen Sie Polar verbinden.

Was das Formular abfragt

Feld	Sieht so aus
Organisations-ZugriffstokenVerschlüsselt gespeichert	`polar_oat_…`

Den Webhook hinzufügen

Öffnen Sie in RevGlance Einstellungen › Quellen, öffnen Sie das Menü der Polar-Quelle und wählen Sie Webhook. Kopieren Sie die URL.
Öffnen Sie in Polar die Settings › Webhooks Ihrer Organisation und fügen Sie einen Endpunkt mit dieser URL hinzu. Wählen Sie die Ereignisse für Bestellungen, Abonnements und Rückerstattungen aus.
Kopieren Sie das Secret des Webhooks (whsec_…), fügen Sie es in RevGlance unter Signing Secret ein und speichern Sie.

Polar signiert seine Aufrufe nach dem Standard-Webhooks-Verfahren. RevGlance akzeptiert sowohl die ältere als auch die aktuelle Art, wie Polar den Schlüssel aus einem whsec_-Secret ableitet, sodass ein Secret funktioniert, das vor oder nach der Änderung von Polar im September 2026 erstellt wurde.

Was RevGlance synchronisiert

Kunden, mit ihrem Rechnungsland und ihren Metadaten, die Segmentfilter nutzen können.
Abonnements, für MRR, Plätze, Rabatte, Testphasen und Kündigungen, mit dem Grund und Kommentar des Kunden, wenn er welche angegeben hat.
Bestellungen und ihre Rückerstattungen. Die erste Synchronisierung liest jede Bestellung; spätere Synchronisierungen lesen ab drei Tagen vor der letzten und einmal pro Woche jede Bestellung erneut, weil eine Rückerstattung nur an ihrer Bestellung erscheint.

Wie Polar gezählt wird

Bestellungen zählen vor Steuern, mit der Plattformgebühr von Polar als Gebühr. Eine Gebühr in einer anderen Währung als die Bestellung erscheint als null.
Rückerstattungen zählen wie die Zahlung vor Steuern. Polar liefert kein Erstattungsdatum, daher wird eine Rückerstattung auf die letzte Änderung der Bestellung datiert.
Eine Rückerstattung einer älteren Bestellung wird durch ein vollständiges Lesen einmal pro Woche erfasst und kann daher bis zu eine Woche später erscheinen.
Rückbuchungen werden nicht gelesen, daher bleibt eine verlorene als Zahlung gezählt, sofern der Anbieter sie nicht auch als Rückerstattung meldet.
Fehlgeschlagene Zahlungen werden nicht gemeldet, daher bleibt dieser Wert bei null.
Der MRR ist der Abonnementbetrag, den Polar bereits um einen wiederkehrenden Rabatt verringert. Ein einmaliger Rabatt verringert den MRR nicht.
Der MRR enthält bei Bruttopreisen die Steuern: Polar gibt nicht an, welche Abonnements sie verwenden. Zahlungen und Rückerstattungen zählen vor Steuern.

Rückhol-E-Mails

Zurückholen schickt Kunden in eine Sitzung des Polar-Kundenportals, um ihre Karte zu aktualisieren. Dafür braucht das Token customer_sessions:write; ohne das verlinkt die E-Mail auf Ihre eigene Seite zum Aktualisieren der Karte.