RevGlanceDokumentacja

Polar

Połącz Polar tokenem dostępu organizacji i dodaj webhook, aby synchronizować dane natychmiast.

RevGlance odczytuje tokenem dostępu organizacji klientów, subskrypcje i zamówienia twojej organizacji w Polar. Nigdy niczego w Polar nie zmienia.

Połączenie

  1. W Polar otwórz Settings swojej organizacji i utwórz token dostępu organizacji (organization access token). Nazwij go RevGlance.
  2. Nadaj mu zakresy customers:read, subscriptions:read i orders:read. Dodaj też customer_sessions:write, jeśli będziesz wysyłać e-maile odzyskiwania.
  3. Skopiuj token. Zaczyna się od polar_oat_.
  4. Wklej go w polu Token dostępu organizacji i wybierz Połącz Polar.

O co pyta formularz

PoleWygląda tak
Token dostępu organizacjiPrzechowywane w postaci zaszyfrowanejpolar_oat_…

Dodawanie webhooka

  1. W RevGlance otwórz Ustawienia › Źródła, otwórz menu źródła Polar i wybierz Webhook. Skopiuj adres URL.
  2. W Polar otwórz Settings › Webhooks swojej organizacji i dodaj punkt końcowy z tym adresem URL. Wybierz zdarzenia zamówień, subskrypcji i zwrotów.
  3. Skopiuj sekret webhooka (whsec_…), wklej go w polu Sekret podpisywania w RevGlance i zapisz.

Polar podpisuje swoje wywołania zgodnie ze Standard Webhooks. RevGlance akceptuje zarówno starszy, jak i obecny sposób, w jaki Polar wyprowadza klucz z sekretu whsec_, więc działa sekret utworzony przed zmianą Polar z września 2026 i po niej.

Co synchronizuje RevGlance

  • Klienci, z krajem rozliczeniowym i metadanymi, których mogą używać filtry segmentów.
  • Subskrypcje, na potrzeby MRR, stanowisk, rabatów, okresów próbnych i anulowań, z powodem i komentarzem klienta, jeśli je podał.
  • Zamówienia i ich zwroty. Pierwsza synchronizacja odczytuje każde zamówienie; kolejne odczytują dane od trzech dni przed poprzednią, a raz w tygodniu odczytują ponownie każde zamówienie, bo zwrot widać tylko na jego zamówieniu.

Jak liczony jest Polar

  • Zamówienia liczą się przed podatkiem, z opłatą platformy Polar jako prowizją. Prowizja w innej walucie niż zamówienie jest pokazywana jako zero.
  • Zwroty liczą się przed podatkiem, tak jak płatność. Polar nie podaje daty zwrotu, więc zwrot ma datę ostatniej zmiany zamówienia.
  • Zwrot starszego zamówienia wychwytuje pełny odczyt raz w tygodniu, więc może pojawić się nawet tydzień później.
  • Obciążenia zwrotne nie są odczytywane, więc przegrane nadal liczy się jako płatność, chyba że dostawca zgłosi je też jako zwrot.
  • Nieudane płatności nie są zgłaszane, więc ta wartość pozostaje na zerze.
  • MRR to kwota subskrypcji, którą Polar już pomniejsza o cykliczny rabat. Jednorazowy rabat nie obniża MRR.
  • MRR zawiera podatek przy cenach z podatkiem: Polar nie podaje, które subskrypcje ich używają. Płatności i zwroty liczą się przed podatkiem.

E-maile odzyskiwania

Odzyskaj kieruje klientów do sesji portalu klienta Polar, gdzie mogą zaktualizować kartę. Token potrzebuje do tego zakresu customer_sessions:write; bez niego e-mail prowadzi do twojej własnej strony aktualizacji karty.