Integration mit Polar

Affiliate-Software für Polar.sh, heute nativ, nicht auf einer Roadmap.

Polar.sh ist der Open-Source-Merchant-of-Record für Entwickler (das Zahlungsunternehmen unter polar.sh, nicht die Uhrenmarke), und Rekomi bindet es nativ an: Füge ein Organization Access Token ein, und Rekomi prüft es, ermittelt deine Organisation und legt den Webhook-Endpunkt selbst an. Ab dann werden Bestellungen, Abo-Verlängerungen und Erstattungen dem richtigen Affiliate automatisch gutgeschrieben und wieder abgezogen, ohne dass du auf Polars Seite etwas einrichten musst.

Polar
nativ
Rekomi
Für Entwickler, die Software, SaaS und digitale Produkte über den gehosteten Checkout von Polar.sh verkaufen.
Jeder Plan · ab $29/Monat
So funktioniert es mit Polar

Token einfügen, Empfehlung mitgeben, order.paid fließen lassen.

01 / 03
Einmal einfügen, verbunden

Erstelle in Polar ein Organization Access Token (Organization Settings > Developers) nur mit den Scopes organizations:read und webhooks:write und füge es in Rekomi ein. Rekomi prüft es live, ermittelt deine Organisation und legt den Webhook-Endpunkt selbst an, abonniert auf genau die Bestell-, Abo- und Erstattungsereignisse, die es braucht; Polar erzeugt das Signing Secret, und Rekomi speichert es verschlüsselt.

02 / 03
rekomi_ref an Checkouts hängen

Polar hostet den Checkout, die Empfehlung reist also in den Metadaten der Bestellung mit. Installiere das Head-Skript und übergib dann window.Rekomi.getReferral() als metadata.rekomi_ref bei per API erstellten Checkouts; einfache Checkout-Links auf deinen Seiten versieht das Skript automatisch mit ?reference_id=, und Polar kopiert den Wert in die Bestellung.

03 / 03
Bestellungen, Verlängerungen, Erstattungen

order.paid ist das einzige Geldereignis: Erstkäufe werden einmal verbucht, und jede Verlängerung bringt wiederkehrende Provision, auf den Nettobetrag vor Steuern. Bei Erstattungen, ganz oder teilweise, wird die Provision anteilig zurückgeholt, über dieselbe Erstattungs-Leitung, im selben Audit-Log.

Einmal einfügen, dauerhaft verifiziert

Token einfügen. Rekomi baut den Webhook selbst.

Die ganze Verbindung hängt an einem einzigen eingefügten Token. Rekomi prüft es, ermittelt deine Organisation und legt den Webhook-Endpunkt selbst an, abonniert auf genau die sieben Ereignisse, die es braucht; beim Trennen wird der Endpunkt wieder gelöscht. Jede Zustellung wird anhand des von Polar erzeugten Signing Secrets geprüft (Standard-Webhooks-HMAC-Signaturen mit 5-Minuten-Replay-Fenster), bevor irgendetwas verarbeitet wird. Und weil Polar Endpunkte deaktiviert, die dauerhaft fehlschlagen, erkennt der Gesundheitscheck von Rekomi genau diesen Zustand und mailt dir; ein Neuverbinden legt den Endpunkt frisch an, mit frischem Secret, und deine Historie bleibt erhalten.

Verbindung mit einem einzigen TokenSigniert · 5-Min-Replay-Fenster
du fügst ein
polar_oat_… · geprüft
Organisation automatisch ermittelt
Rekomi legt an
Webhook-Endpunkt · 7 Ereignisse
beim Trennen wieder gelöscht
order.paid+$29.00 wiederkehrend · netto vor Steuern
refund.updated-$11.60 · anteilige Rückforderung
subscription.uncanceledProvision läuft weiter
Auf MoR-Steuern gibt es nie Provision.
Polar zieht als Merchant of Record die Steuern ein und führt sie ab; die Provision wird auf den Nettobetrag vor Steuern berechnet, und Erstattungen werden genauso gemessen.
$0-Testbestellungen bringen nie ProvisionKennt die Sandbox · klare Fehler
Was du bekommst

Gemacht für die Art, wie Polar.sh wirklich verkauft.

Ein Geldereignis

Provisionen hängen an order.paid: Geld, das wirklich geflossen ist. Bloß angelegte Bestellungen, ausstehende Verlängerungen und die $0-Bestellung, die eine Testphase bei der Anmeldung erzeugt, bringen nie Provision; ein zugeordneter Teststart wird als $0-Lead verbucht, und die Provision kommt aus der ersten echten Abbuchung. Affiliates werden auf Umsatz bezahlt, der angekommen ist, nicht auf Umsatz, der vielleicht kommt.

Signiert und Replay-sicher

Jede Zustellung wird anhand des von Polar erzeugten Signing Secrets geprüft, mit Standard-Webhooks-HMAC-Signaturen und 5-Minuten-Replay-Fenster; Zustellungen, die die Prüfung nicht bestehen, werden abgewiesen. Die Scopes des Tokens sind nur Lesen und Webhooks, Rekomi rührt also nie Produkte, Preise oder Auszahlungen an.

Provisionen netto vor Steuern

Polar zieht als Merchant of Record die Steuern ein, und diese Steuern waren nie dein Umsatz, also gibt Rekomi nie Provision darauf. Die Provision wird auf den Nettobetrag der Bestellung berechnet, nach Rabatten und ohne Steuern, und Erstattungen werden ebenfalls vor Steuern gemessen, Rückforderungen bleiben also symmetrisch.

Rückforderung pro Erstattung

Bei Erstattungen, ganz oder teilweise, wird die Provision anteilig im selben Audit-Log storniert, und bei ausstehenden Erstattungen wird erst zurückgeholt, wenn sie durch sind. Polar sendet keinen Webhook für Streitfälle, eine verlorene Rückbuchung ist also das Einzige, was du manuell für ungültig erklärst.

Eine Verbindung, die sich selbst heilt

Polar deaktiviert Webhook-Endpunkte, die dauerhaft fehlschlagen, und der Gesundheitscheck von Rekomi erkennt genau diesen Zustand; ein widerrufenes Token wird genauso erkannt. Du bekommst eine E-Mail, und ein Neuverbinden legt den Endpunkt frisch an, mit frischem Signing Secret, die Historie bleibt intakt.

Teil eines größeren Stacks

Stripe, Paddle, Braintree und mehr sind neben Polar ebenfalls nativ, und bei jedem anderen Zahlungsanbieter läuft die Zuordnung über die sichere S2S-API.

Alle Integrationen
Preise

Feste Pläne plus 3% der Auszahlungen. Kein Anteil an deinem Umsatz.

14 Tage kostenlose Testphase in jedem Plan · 3% der Affiliate-Auszahlungen, Auszahlungen laufen über Rekomi, Steuerformulare werden eingeholt · Alle Preise

FAQ

Häufige Fragen zu Polar.

Ist die Polar-Integration nativ?

Ja, und die Verbindung ist einmal Einfügen, mehr nicht: Du fügst ein Organization Access Token ein, und Rekomi prüft es, ermittelt deine Organisation und legt den Webhook-Endpunkt direkt in Polar an, abonniert auf genau die Ereignisse, die es braucht. Beim Trennen wird der Endpunkt wieder gelöscht. Bestellungen, Abo-Verlängerungen und Erstattungen werden alle automatisch verbucht, ohne Relay-Code und ohne manuelle Webhook-Konfiguration auf Polars Seite.

Polar wie die Uhrenmarke?

Nein. Auf dieser Seite geht es um Polar.sh, den Open-Source-Merchant-of-Record, über den Entwickler Software, SaaS und digitale Produkte verkaufen: Polar hostet den Checkout, zieht Zahlung und Steuern ein und überweist an dich. Mit dem Sportuhren-Hersteller Polar hat das nichts zu tun. Verkaufst du über polar.sh-Checkout-Links oder die API, ist das deine Integration.

Fast keine Affiliate-Plattform bindet Polar an. Warum Rekomi?

Polar ist jünger als die Abrechnungsplattformen, mit denen die meisten Affiliate-Tools groß geworden sind, und Polar selbst liefert bewusst kein eingebautes Affiliate-Programm; Partner-Integrationen sind der vorgesehene Weg. Die meisten etablierten Affiliate-Plattformen haben es nicht ergänzt, wer also Affiliate-Software für Polar vergleicht, findet eine kurze Liste. Rekomi bindet Polar heute nativ an und geht weiter als ein Häkchen: Die Verbindung legt den Webhook-Endpunkt programmatisch an und entfernt ihn wieder, Provisionen hängen an order.paid (Geld, das wirklich geflossen ist, nicht bloß angelegte Bestellungen), und bei Erstattungen wird die Provision pro Erstattung zurückgeholt.

Wie werden Affiliates gutgeschrieben, wenn Polar den Checkout hostet?

Die Empfehlung reist in den Metadaten der Bestellung mit. Das Rekomi-Head-Skript speichert den Affiliate-Klick in einem First-Party-Cookie; per API erstellte Checkouts übergeben window.Rekomi.getReferral() als metadata.rekomi_ref (der kanonische Schlüssel), und einfache Polar-Checkout-Links auf deinen Seiten versieht das Skript automatisch mit ?reference_id=, was Polar in die Metadaten der Bestellung kopiert. Links, die du außerhalb deiner Website baust (E-Mails, Docs), können reference_id mit einem einzeiligen Snippet anhängen. Rekomi liest zuerst rekomi_ref, dann reference_id, und eine reference_id, die zu keinem Affiliate passt, wird einfach ignoriert.

Warum wird die Provision auf den Nettobetrag vor Steuern berechnet?

Weil Steuern nicht dein Umsatz sind. Polar ist der Merchant of Record: Es zieht Umsatzsteuer und Mehrwertsteuer selbst ein und führt sie ab, der Steueranteil einer Abbuchung gehört also nie dir, und Provision darauf würde jeden Affiliate bei jedem Verkauf in besteuerten Regionen überbezahlen. Rekomi berechnet die Provision auf den Nettobetrag der Bestellung, nach Rabatten und ohne Steuern, und Erstattungen werden ebenfalls vor Steuern gemessen, Rückforderungen bleiben also symmetrisch zur ursprünglichen Provision. Testphasen erzeugen beim Start eine $0-Bestellung; sie bringt nie Provision. Wird die Empfehlung zugeordnet, verbucht Rekomi sie als $0-Lead, und die Provision kommt aus der ersten echten Abbuchung.

Werden Verlängerungen, Erstattungen und Rückbuchungen verarbeitet?

Verlängerungen und Erstattungen, ja. order.paid ist das einzige Geldereignis: Ein Erstkauf verbucht eine einmalige Conversion, und jede Abo-Verlängerung eine wiederkehrende, die Umsatzbeteiligung läuft also über die gesamte Laufzeit des Abos weiter. Erstattungen, ganz oder teilweise, holen die Provision anteilig zurück, im selben Audit-Log, und bei ausstehenden Erstattungen wird erst zurückgeholt, wenn sie durch sind. Ein ehrlicher Hinweis: Polar sendet keinen Webhook für Streitfälle oder Rückbuchungen, ein verlorener Streitfall erreicht Rekomi also nie von allein; passiert einer, erklär die Conversion manuell für ungültig, und die Provision wird im selben Audit-Log storniert.

Was, wenn das Token widerrufen wird oder Polar den Webhook deaktiviert?

Zwei Fehlerfälle, beide überwacht. Wird das Token widerrufen, markiert der Gesundheitscheck die Verbindung, zeigt ein Banner zum Neuverbinden und mailt dir; ein frisches Token stellt sie mit intakter Historie wieder her (wähle beim Erstellen des Tokens „No expiration“, dann läuft es nie auf Zeit ab). Deaktiviert Polar den Endpunkt nach wiederholten Zustellfehlern, erkennt der Gesundheitscheck genau diesen Zustand; aktiviere ihn in Polar wieder oder verbinde einfach neu, das legt den Endpunkt frisch an, mit frischem, von Polar erzeugtem Signing Secret.

Kennt es die Sandbox von Polar?

Ja, die Verbindung kennt ihre Umgebung. Die Sandbox von Polar (sandbox.polar.sh) ist eine eigene Welt mit eigenen Konten und Tokens, und Rekomi hält beide auseinander: Ein Sandbox-Token, das dort eingefügt wird, wo ein Produktions-Token erwartet wird, wird mit einem klaren Fehler abgewiesen statt mit einem stillen Tracking-Ausfall, und die Verbindung merkt sich durchgehend, zu welcher Umgebung sie gehört.

Kann ich Polar neben einer anderen Abrechnungs-Verbindung laufen lassen?

Nein; Rekomi erlaubt pro Workspace nur eine Conversion-Quelle, damit derselbe Verkauf nie doppelt verbucht wird. Wähle eine Verbindung für deine Polar-Verkäufe und bleib dabei; verkaufst du wirklich auf zwei Plattformen, führe sie als getrennte Workspaces.

Bereit, wenn du es bist

Zehn Minuten bis zum ersten Klick.

Füge ein Polar Access Token ein, und deine Verkäufe aus dem gehosteten Checkout schreiben Affiliates noch heute Provisionen gut. 14 Tage kostenlos testen.

  • 14 Tage kostenlose Testphase
  • Jederzeit kündbar, $0 berechnet