Integrationen

Rekomi verbindet sich auf zwei Arten mit dem Rest deines Stacks. Native Abrechnungsverbindungen steuern den Geldfluss: Eingehende Verkäufe werden zu zugeordneten Conversions. Stripe ist am tiefsten integriert, verbunden über die Rekomi-App für Stripe; Paddle, Braintree, Shopify, WooCommerce, Wix, Lemon Squeezy, Chargebee, Polar, Recurly, Gumroad, Creem, Dodo Payments und Mollie sind für das Conversion-Tracking ebenfalls nativ angebunden, und jede andere Abrechnungsplattform ordnet über die Server-to-Server-API zu. CRM-Verbindungen (39 Plattformen) bringen freigegebene Affiliates in die Zielgruppe, die du schon pflegst, und bei beehiiv, Kit, MailerLite, Ontraport und GoHighLevel schreibt dieselbe Verbindung Verkäufe auch dem Affiliate gut, dessen Link den Kunden gebracht hat; siehe CRM- und E-Mail-Integrationen. Zapier steuert die Abläufe im Betrieb: Slack-Nachrichten, Mailchimp-Tags, Updates an HubSpot-Deals, Zeilen in Google Sheets, Freigaben über Typeform, alles, was du über die mehr als 8,000 Apps verknüpfen willst, mit denen Zapier funktioniert, ganz ohne Code.

Für alle nativen Abrechnungsverbindungen gilt eine Regel: eine Abrechnungsquelle pro Workspace. Ein Workspace erfasst Verkäufe immer nur aus einem verbundenen Zahlungsanbieter (oder der S2S-API); ist einer verbunden, lässt sich also kein weiterer verbinden, bis du den ersten trennst.

Zapier

Die Rekomi-App bei Zapier bietet 9 Trigger, 9 Aktionen und 4 Suchen. Damit benachrichtigst du dein Team, wenn sich ein Affiliate anmeldet, synchronisierst Conversions in dein CRM, verschickst dringende E-Mails bei fehlgeschlagenen Auszahlungen, versiehst freigegebene Affiliates in deinem E-Mail-Tool automatisch mit Tags oder gibst geprüfte Bewerber frei, sobald sie ein Typeform abschicken, alles ohne Code.

Die Verbindung braucht einen Klick: Such in Zapier nach Rekomi, klicke auf Connect, melde dich unter app.rekomi.com/oauth/authorize an, wähle deine Organisation und klicke auf Allow. Verbindungen gelten pro Zapier-Konto, jedes Teammitglied verbindet also seinen eigenen Rekomi-Login, und das Prüfprotokoll bleibt sauber. Dafür brauchst du den Plan Starter oder höher.

Die komplette Anleitung, den Katalog der Trigger, Aktionen und Suchen, sechs ausgearbeitete Beispielabläufe, die Fehlerbehandlung und das OAuth-Sicherheitsmodell findest du im Leitfaden zur Zapier-Integration.

Stripe

Stripe ist die tiefste native Verbindung, hergestellt durch die Autorisierung der Rekomi-App für Stripe. Verkäufe und Erstattungen kommen automatisch aus deinen Stripe-Ereignissen. (Paddle, Braintree, Shopify, WooCommerce, Wix, Lemon Squeezy, Chargebee, Polar, Recurly, Gumroad, Creem, Dodo Payments und Mollie sind ebenfalls nativ angebunden, mehr dazu unten; jeder andere Zahlungsanbieter wird über die S2S-API erfasst.) Wir halten nie das Geld deiner Kunden. Dieser Abschnitt erklärt den Verbindungsablauf und das Datenmodell.

Dieselbe App holt das Programm auch in dein Stripe Dashboard: vermittelte Kunden ansehen, Verkäufe zuordnen, Provisionen freigeben, anpassen, stornieren oder zurückholen, Gutschriften vergeben und Auszahlungen ausführen, ohne Stripe zu verlassen. Eine Autorisierung deckt sowohl die Tracking-Verbindung als auch die Panels im Dashboard ab.

Wo du verbindest

/dashboard/integrations zeigt den Status deiner Stripe-Verbindung. Bist du noch nicht verbunden, klicke auf „Stripe verbinden“, und Rekomi schickt dich zur von Stripe gehosteten Zustimmungsseite für die Rekomi-App.

Was Rekomi anfordert

Die App fordert eingegrenzte Berechtigungen an statt pauschalen Zugriff auf das Konto. In der Praxis nutzt Rekomi sie, um:

• Deine Abonnements, Rechnungen, Belastungen und Kunden zu lesen (um zu erkennen, welcher Kunde vermittelt wurde, wie viel er bezahlt hat und ob die Belastung später erstattet wurde).
• Promotion-Codes zu schreiben (um Affiliate-Gutscheincodes in deinem Konto anzulegen).
• Deine Kontoinformationen zu lesen (um deine Konto-ID anzuzeigen und die Verbindung gesund zu halten).

Was Rekomi speichert

Nachdem du die App bestätigt hast, speichern wir im Verbindungsdatensatz deines Workspaces:

• Die ID deines verbundenen Kontos (die Kennung acct_...)
• Kontobezogene OAuth-Tokens, verschlüsselt gespeichert
• Zeitstempel der Gesundheitschecks für die Verbindung

Deinen rohen API-Schlüssel speichern wir nie. Die Tokens sind auf die Berechtigungen der App beschränkt und verfallen, wenn du sie deinstallierst.

Stripe-Konto wechseln

Verbindest du ein anderes Stripe-Konto mit einer Organisation, die schon eines verknüpft hat, übernimmt Rekomi den Wechsel und verwirft die alte Verbindung; vom bisherigen Konto kommen also sofort keine Ereignisse mehr. Um auch die Berechtigung der App für das alte Konto zu entfernen, deinstalliere die Rekomi-App in dessen Stripe Dashboard. Die einzige harte Grenze: Ein Stripe-Konto, das schon mit einer anderen Rekomi-Organisation verknüpft ist, wird als bereits verknüpft abgelehnt. So kann ein Workspace nicht unbemerkt das Abrechnungskonto eines anderen übernehmen.

Webhooks, auf die Rekomi hört

Nach dem Verbinden verarbeitet Rekomi diese Stripe-Ereignisse:

• checkout.session.completed (für die Abrechnung deines Rekomi-Abonnements)
• customer.subscription.created, customer.subscription.updated, customer.subscription.deleted (die Abonnements deiner Kunden)
• customer.subscription.trial_will_end (für deine eigene Rekomi-Testphase)
• invoice.paid, invoice.payment_failed, invoice.upcoming (steuern die Attribution von Verkäufen)
• charge.refunded (macht die Provision anteilig rückgängig, wenn ein Kunde eine Erstattung bekommt)
• customer.updated (synchronisiert die Rechnungs-E-Mail-Adresse)
• payment_method.attached (für das Prüfprotokoll erfasst)

Der Webhook-Handler prüft Signaturen mit dem Signing Secret des Webhooks und setzt den Organisationskontext, bevor er irgendetwas schreibt; die Mandantentrennung bleibt so gewahrt.

Trennen

Zum Trennen deinstallierst du die Rekomi-App in deinem Stripe Dashboard (Settings, dann Installed apps); /dashboard/integrations verlinkt direkt dorthin. Rekomi bekommt dann keine neuen Ereignisse mehr, und bereits erfasste Verkäufe bleiben in den Konten der Affiliates. Installierst du die App erneut, wird die Verbindung zum selben Workspace wiederhergestellt.

Stripe Connect auf Seiten der Affiliates

Auch Affiliates nutzen Stripe, aber auf der Seite der Affiliates und über einen anderen Mechanismus: Sie verbinden ihr eigenes Stripe-Express-Konto, um Auszahlungen zu erhalten. Das ist ein eigener Ablauf, beschrieben unter Affiliates: Stripe Connect. Die Verbindung deiner Marke und das Auszahlungskonto eines Affiliates sind voneinander unabhängig.

Paddle

Marken mit Paddle Billing verbinden sich nativ, ohne ein Backend-Relay zu bauen. Du lässt eine Notification Destination in Paddle auf eine Webhook-URL zeigen, die nur für deinen Workspace gilt, und fügst ihr Signing Secret in Rekomi ein; Rekomi prüft jedes Ereignis und erfasst die Conversion. Das dient dem Tracking deiner Verkäufe (damit Affiliates ihre Gutschrift bekommen) und hängt nicht davon ab, wie du für Rekomi bezahlst.

Wo du verbindest

Einrichtung → Zahlungsanbieter verbinden → Paddle verbinden. Rekomi zeigt dir deine eigene Webhook-URL und genau die Ereignisse, die du aktivieren musst. Die Schritt-für-Schritt-Anleitung findest du unter Auf Paddle installieren.

So funktioniert es

• Du gibst die Affiliate-Empfehlung über customData.rekomi_ref (den Link-Slug des Affiliates) in den Paddle Checkout mit.
• Paddle sendet transaction.completed, subscription.created / subscription.updated / subscription.canceled und adjustment.created / adjustment.updated an deine Rekomi-Webhook-URL.
• Rekomi prüft die Paddle-Signature (HMAC-SHA256 über den Raw Body mit vorangestelltem Zeitstempel) mit dem Signing Secret deiner Destination, erfasst dann Verkäufe und macht Provisionen bei Erstattungen und Rückbuchungen anteilig rückgängig.

Was Rekomi speichert

Das Signing Secret der Destination und der optionale Read-Only-API-Schlüssel werden verschlüsselt gespeichert und nie von der API zurückgegeben. Rekomi speichert außerdem ein Routing-Token pro Workspace (die ID in deiner Webhook-URL) und die Zeitstempel der Gesundheitschecks.

Sicherheit

Der Webhook-Endpunkt ist öffentlich, aber jedes Ereignis muss eine gültige HMAC-Signatur über den exakten Request-Body tragen, innerhalb eines kurzen Replay-Fensters; unbekannte Tokens und falsche Signaturen werden abgelehnt. Die Organisation wird über das Routing-Token ermittelt, und der Mandantenkontext wird vor jedem Schreibvorgang gesetzt; die Mandantentrennung bleibt so gewahrt. Der optionale API-Schlüssel hat nur Lesezugriff und dient nur Gesundheitschecks und dem Abgleich, nie der Erfassung von Ereignissen.

Braintree

Marken mit Braintree (einem Unternehmen von PayPal) verbinden sich für Abonnements nativ, ohne ein Backend-Relay zu bauen. Du lässt einen Braintree-Webhook auf eine URL zeigen, die nur für deinen Workspace gilt, und fügst Zugangsdaten mit reinem Lesezugriff in Rekomi ein; Rekomi prüft jedes Ereignis und erfasst die Conversion. Das erfasst deine wiederkehrenden Verkäufe (damit Affiliates ihre Gutschrift bekommen) und hängt nicht davon ab, wie du für Rekomi bezahlst.

Eine Einschränkung, klar gesagt: Braintree löst Webhooks nur für Abonnements und Streitfälle aus, nicht für einmalige Kartenverkäufe oder Kartenerstattungen. Der native Ablauf deckt also wiederkehrende Umsätze und die automatische Rückforderung bei Rückbuchungen ab; einmalige Verkäufe laufen über die Server-to-Server-API, und bei Erstattungen einmaliger Kartenzahlungen lehnst du die Provision manuell ab.

Wo du verbindest

Einrichtung → Zahlungsanbieter verbinden → Braintree verbinden. Rekomi zeigt dir deine eigene Webhook-URL und genau die Benachrichtigungsarten, die du aktivieren musst. Die Schritt-für-Schritt-Anleitung findest du unter Auf Braintree installieren.

So funktioniert es

• Du gibst die Affiliate-Empfehlung über ein Braintree-Custom-Field namens rekomi_ref (den Link-Slug des Affiliates) an jeden Verkauf mit; ausgelesen wird es aus der Belastungstransaktion.
• Braintree sendet subscription_charged_successfully, subscription_canceled / subscription_expired und die Ereignisse dispute_* an deine Rekomi-Webhook-URL.
• Rekomi prüft die bt_signature (das Braintree SDK prüft sie offline gegen deine gespeicherten Schlüssel), erfasst dann wiederkehrende Verkäufe und macht die Provision anteilig rückgängig, wenn ein Streitfall verloren geht.

Was Rekomi speichert

Deine Braintree Merchant ID sowie der Public und der Private Key werden verschlüsselt gespeichert und nie von der API zurückgegeben (die Merchant ID wird als nicht geheime Kennung wieder angezeigt). Rekomi speichert außerdem ein Routing-Token pro Workspace (die ID in deiner Webhook-URL) und die Zeitstempel der Gesundheitschecks.

Sicherheit

Der Webhook-Endpunkt ist öffentlich, aber jedes Ereignis wird vom Braintree SDK gegen deine gespeicherten Schlüssel geprüft, bevor irgendetwas als vertrauenswürdig gilt; unbekannte Tokens und falsche Signaturen werden abgelehnt. Die Organisation wird über das Routing-Token ermittelt, und der Mandantenkontext wird vor jedem Schreibvorgang gesetzt; die Mandantentrennung bleibt so gewahrt. Bei der Erfassung wird offline geprüft (ohne Aufruf der Braintree-API), ein Ausfall der Braintree-API kann also nicht verhindern, dass geprüfte Conversions erfasst werden. Nutze für die Zugangsdaten einen Braintree-Nutzer mit reinem Lesezugriff.

Shopify

Marken mit Shopify verbinden sich nativ über die Rekomi-App für Shopify, verfügbar im Shopify App Store, ohne Änderungen am Theme und ohne ein Relay zu bauen. Installiere die App, bestätige die angeforderten Berechtigungen und wähle die Kampagne, der Bestellungen zugeordnet werden sollen; Rekomi erfasst den Affiliate-Klick und liest jede Bestellung serverseitig über den Bestell-Webhook von Shopify. Das erfasst die Verkäufe deines Shops (damit Affiliates ihre Gutschrift bekommen); dein Rekomi-Abonnement selbst wird über Shopify abgerechnet.

Die meisten Affiliate-Apps für Shopify berechnen einen Prozentsatz deiner vermittelten Verkäufe. Rekomi berechnet 3% der Provisionen, die du tatsächlich auszahlst, nicht der Verkäufe, und wickelt Auszahlungen und Steuern für dich ab.

Wo du verbindest

Installiere Rekomi Affiliate Marketing aus dem Shopify App Store. Nach der Installation öffnet sich die App auf ihrer Seite Abonnement: Wähle einen Plan, bestätige die Abbuchung auf der Abrechnungsseite von Shopify (jeder Plan startet mit einer 14-tägigen kostenlosen Testphase), und du landest mit laufender Testphase wieder auf dieser Abrechnungsseite. Die Einrichtungsanleitung führt dich dann durch die Verknüpfung deines Shops mit einer Kampagne. Die Schritt-für-Schritt-Anleitung findest du unter Auf Shopify installieren.

So funktioniert es

• Die App erfasst den Affiliate-Klick und schreibt die Empfehlung an die Bestellung, Änderungen an Theme oder Checkout sind also nicht nötig.
• Shopify sendet Webhooks für Bestellungen und Erstattungen an Rekomi; geprüfte Bestellungen werden als Conversions erfasst, und Erstattungen machen die Provision anteilig rückgängig.
• Willst du alles lieber selbst verdrahten, beschreibt die Installationsanleitung einen manuellen Fallback mit Custom Pixel und Webhook an S2S.

Was Rekomi speichert

Das bei der Installation gewährte Shopify Access Token wird verschlüsselt gespeichert und nie von der API zurückgegeben. Rekomi speichert außerdem deine Shop-Domain und die Zeitstempel der Gesundheitschecks. Die App fordert sieben Berechtigungen an: read-orders und read-customers für die Attribution und die Einladungen an Top-Kunden, read-products für den Produktkatalog und die Produktauswahl, write-discounts nur zum Anlegen der Affiliate-Rabattcodes, die du in der App erstellst, write-pixels und read-customer-events für das Web Pixel der App (den abgeschotteten Analyse-Worker, den Shopify für das Tracking von Link-Klicks ausführt; er liest nur den Empfehlungsparameter der Landing-URL und die Bestellbestätigung, nie Kundendaten) und write-store-credit nur zum Gutschreiben von Shop-Guthaben, wenn eine Kampagne damit belohnt. Rekomi ändert nie dein Theme, die Inhalte deines Storefronts, Produkte oder Bestellungen; das Pixel wird über das eigene Pixel-System von Shopify installiert, nicht über eine Änderung am Theme.

Shop-Guthaben als Belohnung

Eine Shopify-Kampagne kann Affiliates statt mit Geld mit Shop-Guthaben belohnen: Die Provision landet als Shop-Guthaben auf dem Shopify-Kundenkonto des Affiliates, und eine Erstattung nimmt sie wieder zurück. Siehe Shop-Guthaben als Belohnung.

Shopify Collabs

Shopify bringt mit Collabs ein eigenes natives Affiliate-Programm mit. Rekomi ergänzt plattformübergreifende Affiliate-Konten (ein Affiliate arbeitet für mehrere Marken), Provisionsstufen, Sub-Affiliate-Recruiting und das offene Creator-Netzwerk. Du kannst beides parallel im selben Shop betreiben.

WooCommerce

Marken mit WooCommerce verbinden sich nativ über das WordPress-Plugin von Rekomi, verfügbar im WordPress-Plugin-Verzeichnis. Installiere und aktiviere es und klicke auf der Rekomi-Seite in wp-admin auf Verbinden; danach meldet das Plugin jede Bestellung Server-to-Server, die Attribution funktioniert also bei jeder Zahlungsmethode, die dein Shop akzeptiert (WooPayments, Stripe, PayPal, Square, Nachnahme und alle anderen), im Block-Checkout und im klassischen Checkout.

Wo du verbindest

Installiere das Plugin unter Plugins > Installieren (nach „Rekomi“ suchen), öffne Rekomi in der Admin-Seitenleiste und klicke auf Mit Rekomi verbinden. Beim Verbinden wird dein Workspace automatisch angelegt, und das komplette Dashboard läuft in wp-admin. Die Schritt-für-Schritt-Anleitung findest du unter Auf WooCommerce installieren.

So funktioniert es

• Empfehlungsklicks werden First-Party in einem Cookie auf deiner eigenen Domain erfasst; das Plugin schreibt die Empfehlung im Checkout an die WooCommerce-Bestellung.
• Bestell- und Erstattungsereignisse gehen Server-to-Server von deiner Website an Rekomi: Geprüfte Bestellungen werden als Conversions erfasst, und Erstattungen holen die Provision anhand der erstatteten Bestellpositionen zurück.
• Affiliate-Gutscheincodes werden als echte WooCommerce-Gutscheine angelegt, eingelöste Codes ordnen also auch ohne Klick zu, und Verlängerungen über WooCommerce Subscriptions bringen wiederkehrende Provisionen.

Was Rekomi speichert

Der beim Verbinden ausgegebene Verbindungsschlüssel wird verschlüsselt gespeichert, und das Deaktivieren des Plugins widerruft ihn serverseitig. Bestelldaten (ID, Summen, Währung, Bestellpositionen, Gutscheincodes, Name und E-Mail-Adresse des Kunden) gehen für die Attribution an Rekomi; Rekomi ändert nie dein Theme, deine Produkte oder deinen Checkout.

Wix

Marken mit Wix verbinden sich nativ über die App Rekomi Affiliate Marketing, verfügbar im Wix App Market, ohne etwas einzufügen und ohne ein Relay zu bauen. Installiere die App, und die Einrichtung ist erledigt: Sie bindet das Tracking-Skript automatisch ein und erfasst jede bezahlte Shop-Bestellung serverseitig. Das erfasst die Verkäufe deines Shops (damit Affiliates ihre Gutschrift bekommen); dein Rekomi-Abonnement wird über Wix abgerechnet.

Die meisten Affiliate-Apps berechnen einen Prozentsatz deiner vermittelten Verkäufe. Die Pläne von Rekomi starten bei $29 im Monat mit einer 14-tägigen kostenlosen Testphase, dazu kommen 3% der Provisionen, die du tatsächlich auszahlst, kein Anteil an deinen Verkäufen, und Rekomi wickelt Auszahlungen und Steuern für dich ab.

Wo du verbindest

Installiere die App aus dem Wix App Market: Such nach „Rekomi“ oder öffne den Eintrag von Rekomi Affiliate Marketing und klicke auf Add to Site. Nach der Installation findest du alles in der Rekomi-App in deinem Wix-Dashboard: Wähle unter Abonnement einen Plan (die 14-tägige kostenlose Testphase gibt es einmal pro Wix-Konto, abgerechnet über Wix), erstelle deine Kampagne und verwalte dort Affiliates, Verkäufe und Auszahlungen. Die Schritt-für-Schritt-Anleitung findest du unter Auf Wix installieren.

So funktioniert es

• Die App bindet das Klick-Tracking automatisch ein; keine Änderungen am Theme, nichts einzufügen.
• Wix sendet Bestell-Webhooks an Rekomi; aus bezahlten Bestellungen entstehen Provisionen auf den Betrag vor Steuern, und Erstattungen passen die Provision automatisch an.
• Affiliates bekommen Produktlinks aus dem aktuellen Katalog deines Shops und persönliche Gutscheincodes, die als echte Wix-Gutscheine angelegt werden (für den ganzen Warenkorb, bis zu 20 Zeichen).
• Eine Kampagne kann Affiliates statt mit Geld mit einer Wix-Geschenkkarte belohnen (siehe Shop-Guthaben als Belohnung).

Was Rekomi speichert

Rekomi speichert die Instanz-ID der App, die deine Wix-Website mit deinem Workspace verbindet, die Bestell-IDs, Beträge und Währung zugeordneter Bestellungen und die IDs der Gutscheine, die es anlegt. Kartendaten erreichen Rekomi nie.

Deinstallieren

Das Deinstallieren der App stoppt das Tracking, kündigt aber dein Rekomi-Abonnement nicht; Wix lässt App-Abonnements unabhängig von der Installation weiterlaufen, kündige also auf der Seite für Abonnements in deinem Wix-Konto. Eine erneute Installation aus dem App Market schaltet dein bestehendes Konto, deine Kampagnen und deine Affiliates wieder scharf.

BigCommerce

Marken mit BigCommerce verbinden sich nativ über die App Rekomi Affiliate Marketing, verfügbar im BigCommerce App Marketplace. Installiere die App, und die Einrichtung ist erledigt: Sie registriert deine Bestell-Webhooks und bindet das Tracking-Skript im Storefront ein, und das ganze Programm läuft in deinem Control Panel. Dein Rekomi-Abonnement wird über BigCommerce abgerechnet.

Wo du verbindest

Öffne in deinem Control Panel Apps > App Marketplace, such nach „Rekomi“ und klicke auf Install; bestätige die Berechtigungen, wähle im Tab Abonnement einen Plan (14-tägige kostenlose Testphase, abgerechnet über BigCommerce, ein kostenpflichtiger BigCommerce-Tarif ist nötig) und erstelle deine erste Kampagne. Die Schritt-für-Schritt-Anleitung findest du unter Auf BigCommerce installieren.

So funktioniert es

• Affiliate-Links werden First-Party in deinem Storefront erfasst; der Beacon der App auf der Bestellbestätigung erfasst vermittelte Bestellungen.
• BigCommerce sendet Webhooks für Bestellungen und Erstattungen an Rekomi; aus bezahlten Bestellungen entstehen Provisionen auf die Summe vor Steuern, und Erstattungen holen die Provision anteilig zurück. Rekomi liest jede Bestellung vor der Erfassung erneut über die API, weil Webhooks von BigCommerce keine Signatur über den Body tragen.
• Affiliates bekommen persönliche Gutscheincodes, die als echte BigCommerce-Promotions angelegt werden (für den ganzen Warenkorb), und Produktlinks aus deinem Katalog.
• Eine Kampagne kann Affiliates statt mit Geld mit Shop-Guthaben in BigCommerce belohnen (siehe Shop-Guthaben als Belohnung).

Was Rekomi speichert

Das Installations-Token wird verschlüsselt gespeichert und nie von der API zurückgegeben. Rekomi speichert den Store-Hash, die Bestell-IDs, Beträge und Währung zugeordneter Bestellungen und die IDs der Promotions, die es anlegt. Rekomi fragt nie nach Zugriff auf den Checkout und ändert nie dein Theme, deine Produkte oder Bestellungen.

Lemon Squeezy

Marken mit Lemon Squeezy (einem Merchant of Record) verbinden sich nativ mit einem API-Schlüssel, ohne Webhook-Oberfläche zum Einrichten und ohne ein Relay zu bauen. Du fügst den Schlüssel in Rekomi ein; Rekomi prüft ihn, erzeugt ein Signing Secret, legt den Webhook in deinem Store an und bestätigt, dass er registriert ist. Das erfasst deine Verkäufe (damit Affiliates ihre Gutschrift bekommen) und hängt nicht davon ab, wie du für Rekomi bezahlst.

Wo du verbindest

Einrichtung → Zahlungsanbieter verbinden → Lemon Squeezy verbinden. Rekomi fragt nach dem API-Schlüssel von der Seite Settings → API in Lemon Squeezy und lässt dich, wenn dein Konto mehrere Stores hat, auswählen, welcher erfasst werden soll. Die Schritt-für-Schritt-Anleitung findest du unter Auf Lemon Squeezy installieren.

So funktioniert es

• Du gibst die Affiliate-Empfehlung über checkout[custom][rekomi_ref] an Checkout-Links in den Lemon-Squeezy-Checkout mit (oder über checkout_data.custom.rekomi_ref bei Checkouts, die per API erstellt werden).
• Lemon Squeezy sendet Ereignisse zu Bestellungen, Abonnements und Erstattungen an den Webhook, den Rekomi angelegt hat; geprüfte Ereignisse erfassen einmalige Verkäufe und erste Abo-Bestellungen als erste Conversions und Verlängerungen als wiederkehrende Conversions, wobei das doppelte Ereignis zur ersten Zahlung übersprungen wird, damit nichts doppelt zählt.
• Volle und Teilerstattungen machen die Provision automatisch anteilig rückgängig.

Was Rekomi speichert

Dein API-Schlüssel für Lemon Squeezy und das erzeugte Signing Secret des Webhooks werden verschlüsselt gespeichert und nie von der API zurückgegeben. Rekomi speichert außerdem die Store-ID, die Webhook-ID (damit beim Trennen der Webhook aus der Ferne gelöscht wird) und die Zeitstempel der Gesundheitschecks.

Ablauf des Schlüssels

API-Schlüssel von Lemon Squeezy laufen nach einem Jahr ab. Der Gesundheitscheck von Rekomi erkennt den Ablauf, zeigt ein Banner zum Neuverbinden und schickt dir eine E-Mail; fügst du einen neuen Schlüssel ein, ist die Verbindung mit vollständigem Verlauf wiederhergestellt.

Chargebee

Marken mit Chargebee (Abo-Abrechnung auf deinem eigenen Zahlungsanbieter) verbinden sich nativ mit einem Site-Namen und einem Read-Only-API-Schlüssel und einem Webhook, den du in Chargebee anlegst. Chargebee-Webhooks sind nicht signiert, deshalb erzeugt Rekomi für dich Zugangsdaten für Basic Authentication; du fügst sie zusammen mit der URL deines Workspaces in die Webhook-Einstellungen von Chargebee ein. Das erfasst deine Verkäufe (damit Affiliates ihre Gutschrift bekommen) und hängt nicht davon ab, wie du für Rekomi bezahlst.

Wo du verbindest

Einrichtung → Zahlungsanbieter verbinden → Chargebee verbinden. Rekomi fragt nach dem Site-Namen (dem acme in acme.chargebee.com) und einem Read-Only-API-Schlüssel von der Seite Settings → Configure Chargebee → API Keys and Webhooks in Chargebee, prüft das Paar live und zeigt die Webhook-URL und die Zugangsdaten, die du in Chargebee einträgst (API version V2, „Exclude card information“ angehakt). Die Schritt-für-Schritt-Anleitung findest du unter Auf Chargebee installieren.

So funktioniert es

• Du gibst die Affiliate-Empfehlung über meta_data.rekomi_ref an per API erstellten Abonnements mit oder über ein benutzerdefiniertes Abo-Feld cf_rekomi_ref, das im Hosted Checkout als subscription[cf_rekomi_ref] übergeben wird (oder als product.data["cf_rekomi_ref"] im Drop-in-Skript).
• Chargebee sendet Ereignisse zu Zahlungen, zum Lebenszyklus von Abonnements und zu Erstattungen an den Rekomi-Webhook; authentifizierte Ereignisse erfassen erste Zahlungen und einmalige Belastungen als erste Conversions und Verlängerungszahlungen als wiederkehrende Conversions, anhand der Ereignis-ID dedupliziert, damit Wiederholungen nie doppelt zählen.
• Volle und Teilerstattungen machen die Provision automatisch anteilig rückgängig. Rückbuchungen, die über das Chargeback Management von Chargebee laufen, kommen als Erstattungen an und holen die Provision ebenfalls zurück; Streitfälle, die außerhalb dieser Funktion geklärt werden, erreichen Rekomi nicht.

Was Rekomi speichert

Dein Read-Only-API-Schlüssel und das erzeugte Passwort für die Basic Authentication des Webhooks werden verschlüsselt gespeichert und nie von der API zurückgegeben (das Passwort wird genau einmal angezeigt, wenn es erzeugt wird). Rekomi speichert außerdem den Site-Namen, die daraus abgeleitete Umgebung (live oder test) und die Zeitstempel der Gesundheitschecks.

Zustand des Schlüssels

Chargebee-API-Schlüssel laufen nicht ab. Der Gesundheitscheck von Rekomi erkennt einen gelöschten oder deaktivierten Schlüssel (oder eine umbenannte Site), zeigt ein Banner zum Neuverbinden und schickt dir eine E-Mail; fügst du einen neuen Read-Only-Schlüssel ein, ist die Verbindung mit vollständigem Verlauf wiederhergestellt. Verlierst du das Webhook-Passwort, erzeuge es auf der Einrichtungsseite neu und aktualisiere den Chargebee-Webhook; das alte Passwort funktioniert dann sofort nicht mehr.

Polar

Marken, die über Polar verkaufen (Merchant of Record), verbinden sich nativ mit einem einzigen Organization Access Token. Rekomi prüft das Token, ermittelt deine Polar-Organisation und legt den Webhook-Endpunkt selbst in Polar an; auf keiner der beiden Seiten musst du einen Webhook von Hand einrichten. Das erfasst deine Verkäufe (damit Affiliates ihre Gutschrift bekommen) und hängt nicht davon ab, wie du für Rekomi bezahlst.

Wo du verbindest

Einrichtung → Zahlungsanbieter verbinden → Polar verbinden. Rekomi fragt nach einem Organization Access Token, das du in Polar unter Organization Settings → Developers nur mit den Scopes organizations:read und webhooks:write erstellst (wähle „No expiration“). Die Schritt-für-Schritt-Anleitung findest du unter Auf Polar installieren.

So funktioniert es

• Du gibst die Affiliate-Empfehlung über metadata.rekomi_ref bei per API erstellten Checkouts in den Checkout mit oder hängst reference_id an Polar-Checkout-Links an (Polar kopiert den Wert in die Metadaten der Bestellung).
• Polar sendet bezahlte Bestellungen, Ereignisse zum Lebenszyklus von Abonnements und Erstattungen an den Webhook-Endpunkt, den Rekomi angelegt hat; Ereignisse mit geprüfter Signatur erfassen Erstkäufe als einmalige Conversions und Verlängerungen als wiederkehrende Conversions, anhand der Ereignis-ID dedupliziert, damit Wiederholungen nie doppelt zählen.
• Provisionen werden auf den Nettobetrag der Bestellung berechnet: nach Rabatten, ohne die Steuer, die Polar als Merchant of Record einzieht, und abzüglich eines Kundenguthabens. Testphasen erzeugen zu ihrem Beginn eine Bestellung über $0; daraus entsteht nie eine Provision. Ist die Empfehlung zugeordnet, erfasst Rekomi sie als Lead über $0 (sichtbar in deinen Ansichten für Funnel und Leads), und die Provision entsteht mit der ersten echten Belastung.
• Volle und Teilerstattungen machen die Provision automatisch anteilig rückgängig. Polar sendet keinen Webhook für Streitfälle oder Rückbuchungen, ein verlorener Streitfall erreicht Rekomi also nie von allein; erkläre die Conversion manuell für ungültig, und die Provision wird im selben Prüfprotokoll rückgängig gemacht.

Was Rekomi speichert

Dein Organization Access Token und das von Polar erzeugte Signing Secret des Webhooks werden verschlüsselt gespeichert und nie von der API zurückgegeben. Rekomi speichert außerdem ID und Namen der Organisation, die ID des Endpunkts (damit beim Trennen der Endpunkt aus der Ferne gelöscht wird), die Umgebung und die Zeitstempel der Gesundheitschecks.

Zustand des Tokens

Organization Access Tokens, die mit „No expiration“ erstellt wurden, laufen nie zeitgesteuert ab. Der Gesundheitscheck von Rekomi erkennt ein widerrufenes Token, einen gelöschten Endpunkt und die automatische Deaktivierung durch Polar (Polar schaltet einen Endpunkt nach wiederholt fehlgeschlagenen Zustellungen ab), zeigt ein Banner zum Neuverbinden und schickt dir eine E-Mail mit der passenden Lösung: Aktiviere den Endpunkt in Polar wieder, oder verbinde mit einem neuen Token neu (das legt den Endpunkt neu an und erneuert das Signing Secret). Der Verlauf bleibt in beiden Fällen erhalten.

Recurly

Marken mit Recurly (Abo-Abrechnung auf deinem eigenen Zahlungsanbieter) verbinden sich nativ mit einer Datenregion und einem privaten API-Schlüssel mit reinem Lesezugriff und einem Webhook-Endpunkt, den du in Recurly anlegst. XML-Webhooks von Recurly sind nicht signiert, deshalb erzeugt Rekomi für dich Zugangsdaten für Basic Authentication; du fügst sie zusammen mit der URL deines Workspaces in die Einstellungen des Webhook-Endpunkts in Recurly ein. Das erfasst deine Verkäufe (damit Affiliates ihre Gutschrift bekommen) und hängt nicht davon ab, wie du für Rekomi bezahlst.

Wo du verbindest

Einrichtung → Zahlungsanbieter verbinden → Recurly verbinden. Rekomi fragt nach deiner Datenregion (US oder EU) und einem privaten API-Schlüssel mit reinem Lesezugriff von der Seite Integrations → API Credentials in Recurly, prüft den Schlüssel live gegen deine Region (und schlägt die andere Region vor, wenn der Schlüssel eindeutig dorthin gehört) und zeigt die Webhook-URL und die Zugangsdaten, die du in Recurly einträgst (Format XML, Basic Authentication). Die Schritt-für-Schritt-Anleitung findest du unter Auf Recurly installieren.

So funktioniert es

• Du gibst die Affiliate-Empfehlung über ein benutzerdefiniertes Abo-Feld rekomi_ref an das Abonnement mit (optional auch am Account gespiegelt), gesetzt über die API beim Erstellen von Abonnements oder Käufen. Benutzerdefinierte Felder gibt es nur bei Recurly Pro oder Elite; der Tarif Starter kennt sie nicht, die Attribution von Neukunden braucht also Pro oder höher.
• Recurly sendet bezahlte Rechnungen, Ereignisse zum Lebenszyklus von Abonnements, Erstattungen und Stornierungen von Zahlungen an den Rekomi-Webhook; authentifizierte Ereignisse erfassen Kaufrechnungen als erste Conversions und Verlängerungsrechnungen als wiederkehrende Conversions, dedupliziert, damit Wiederholungen nie doppelt zählen.
• Webhooks von Recurly tragen bei Benachrichtigungen zu Abonnement, Account, Zahlung oder Rechnung nie benutzerdefinierte Felder. Deshalb liest Rekomi bei der ersten Zahlung jedes Abonnements rekomi_ref mit deinem Schlüssel mit Lesezugriff in einem einzigen, begrenzten API-Aufruf aus; Verlängerungen werden ohne API-Aufruf über deine Kundenhistorie zugeordnet. Ist die API von Recurly kurz nicht erreichbar, bittet Rekomi Recurly, den Webhook erneut zu senden (bis zu 10 Versuche über etwa drei Tage, für alles Ältere gibt es in deiner Konsole einen manuellen Retry pro Benachrichtigung).
• Volle und Teilerstattungen machen die Provision automatisch anteilig rückgängig, pro Erstattungstransaktion; stornierte Zahlungen werden voll rückgängig gemacht. Rückbuchungen bei Karten holen die Provision nur über die Funktion Chargeback Management von Recurly zurück, die sich im Early Access befindet (sie kommen als erstattungsartige Ereignisse an); Streitfälle, die außerhalb dieser Funktion geklärt werden, erreichen Rekomi nicht.

Was Rekomi speichert

Dein API-Schlüssel mit reinem Lesezugriff und das erzeugte Passwort für die Basic Authentication des Webhooks werden verschlüsselt gespeichert und nie von der API zurückgegeben (das Passwort wird genau einmal angezeigt, wenn es erzeugt wird). Rekomi speichert außerdem die Region, die optionale Subdomain der Site und die Zeitstempel der Gesundheitschecks.

Zustand des Schlüssels

API-Schlüssel von Recurly laufen nicht ab. Der Gesundheitscheck von Rekomi erkennt einen gelöschten oder widerrufenen Schlüssel (wird ein Recurly-Nutzer widerrufen, werden auch seine API-Schlüssel gelöscht) oder eine falsch eingestellte Region, zeigt ein Banner zum Neuverbinden und schickt dir eine E-Mail; fügst du einen neuen Schlüssel mit reinem Lesezugriff ein, ist die Verbindung mit vollständigem Verlauf wiederhergestellt. Verlierst du das Webhook-Passwort, erzeuge es auf der Einrichtungsseite neu und aktualisiere den Endpunkt in Recurly; das alte Passwort funktioniert dann sofort nicht mehr.

Gumroad

Marken, die über Gumroad verkaufen (Merchant of Record für digitale Produkte und Mitgliedschaften), verbinden sich nativ mit einem Klick: Du bestätigst Rekomi einmal auf der Zustimmungsseite von Gumroad (Lesezugriff auf Verkäufe), und Rekomi registriert die Benachrichtigungen zu Verkäufen, Erstattungen, Streitfällen und zum Lebenszyklus von Mitgliedschaften selbst in deinem Gumroad-Konto. Auf keiner Seite wird etwas in Gumroad eingefügt. Das erfasst deine Verkäufe (damit Affiliates ihre Gutschrift bekommen) und hängt nicht davon ab, wie du für Rekomi bezahlst.

Wo du verbindest

Einrichtung → Zahlungsanbieter verbinden → Gumroad verbinden. Der Button startet die OAuth-Autorisierung; als fortgeschrittene Alternative kannst du ein Gumroad Access Token einfügen (beachte, dass Tokens aus den Applications-Einstellungen von Gumroad Zugriff auf das ganze Konto haben, deshalb ist die Freigabe nur für Verkäufe über den Button vorzuziehen). Die Schritt-für-Schritt-Anleitung findest du unter Auf Gumroad installieren.

So funktioniert es

• Du gibst die Affiliate-Empfehlung über ?rekomi_ref= am Produktlink mit; Gumroad übernimmt die Query-Parameter der Landing-URL in die Verkaufsbenachrichtigung. Affiliate-Links von Rekomi tragen den Parameter automatisch, und ein Snippet zum Anhängen deckt die Kauf-Links auf deiner eigenen Website ab. Verlängerungen von Mitgliedschaften tragen den Parameter nie; Rekomi schreibt sie anhand des ersten zugeordneten Verkaufs des Kunden gut.
• Gumroad sendet Verkäufe, Erstattungen, Streitfälle und Ereignisse zum Lebenszyklus von Mitgliedschaften an eine Rekomi-Adresse pro Workspace. Gumroad signiert diese Benachrichtigungen nicht, deshalb authentifiziert Rekomi jede Zustellung in mehreren Schichten: die geheime Adresse pro Workspace (nur für Owner des Workspaces sichtbar, bei jedem Neuverbinden erneuert), eine Bindung an die Identität des Verkäufers und ein Nachlesen, das jedes Geldereignis mit deinem Token erneut über die API von Gumroad liest und die Beträge aus dieser maßgeblichen Abfrage erfasst, nie aus der rohen Benachrichtigung.
• Verkäufe werden in USD erfasst (Gumroad rechnet jede Belastung in US-Dollar ab); erste Belastungen sind einmalige Conversions und wiederkehrende Belastungen von Mitgliedschaften wiederkehrende Conversions, dedupliziert, damit erneute Zustellungen nie doppelt zählen. Testkäufe des Verkäufers und der Start einer Testphase über $0 erzeugen nie Provisionen.
• Volle Erstattungen und Rückbuchungen holen die Provision automatisch zurück. Teilerstattungen verringern Provisionen nicht automatisch; sie werden zur Prüfung erfasst, und eine Teilerstattung, die sich auf 100% summiert, holt die Provision einmal vollständig zurück.
• Gumroad wiederholt fehlgeschlagene Zustellungen nur ein paar Mal innerhalb von etwa 14 Minuten und verwirft Zustellungen mit Zeitüberschreitung ganz. Längere Ausfälle füllst du deshalb mit dem Abruf der Gumroad-Verkaufshistorie nachträglich auf (Einstellungen → Umzug → Gumroad → Schritt 2, Von = Startdatum der Lücke).

Was Rekomi speichert

Dein Gumroad Access Token wird verschlüsselt gespeichert und nie von der API zurückgegeben. Rekomi speichert außerdem die Verkäufer-ID und den Anzeigenamen, die IDs der sechs registrierten Ressourcen-Abonnements (damit beim Trennen alle aus der Ferne gelöscht werden) und die Zeitstempel der Gesundheitschecks.

Zustand des Tokens

Gumroad Access Tokens laufen nicht ab, aber wenn du die Rekomi-App in Gumroad widerrufst, wird das Token ungültig UND die Benachrichtigungen bleiben unbemerkt aus. Der Gesundheitscheck von Rekomi erkennt den Widerruf (und eine fehlende Registrierung der Verkaufsbenachrichtigung), zeigt ein Banner zum Neuverbinden und schickt dir eine E-Mail; ein erneuter Klick auf Gumroad verbinden registriert alle sechs Feeds neu und erneuert die Webhook-Zugangsdaten, mit vollständigem Verlauf.

Creem

Marken, die über Creem verkaufen (Merchant of Record für SaaS und digitale Produkte), verbinden sich nativ mit einem Webhook und zwei Einfügungen: Du legst im Dashboard von Creem einen Webhook an, der auf deine Rekomi-URL pro Workspace zeigt und alle Ereignisse ausgewählt hat, und fügst dann das Signing Secret des Webhooks und einen API-Schlüssel in Rekomi ein. Der API-Schlüssel dient nur dazu, die Verbindung zu prüfen und einen Gesundheitscheck mit reinem Lesezugriff auszuführen (ein Schlüssel mit Lesezugriff auf Products reicht); deine Verkäufe kommen über den signierten Webhook an, nie über den Schlüssel. Das erfasst deine Verkäufe (damit Affiliates ihre Gutschrift bekommen) und hängt nicht davon ab, wie du für Rekomi bezahlst.

Wo du verbindest

Einrichtung → Zahlungsanbieter verbinden → Creem verbinden. Die Seite zeigt deine Webhook-URL und die Schritte im Dashboard (Developers → Webhooks → Add Webhook, alle Ereignisse ausgewählt) und nimmt dann das Signing Secret und den API-Schlüssel entgegen; Rekomi prüft den Schlüssel live bei Creem, bevor es ihn annimmt, mit eigenen Fehlermeldungen für einen widerrufenen Schlüssel, einen Schlüssel mit zu wenig Berechtigungen und einen Schlüssel aus dem Test Mode bei einer Produktivverbindung. Die Schritt-für-Schritt-Anleitung findest du unter Auf Creem installieren.

So funktioniert es

• Du gibst die Affiliate-Empfehlung in den Checkout-Metadaten als rekomi_ref mit: Setz sie beim Erstellen von Checkout Sessions über die API von Creem, oder häng ?metadata[rekomi_ref]= an Zahlungslinks von Creem an. Die Metadaten bleiben am Abonnement erhalten, Verlängerungen werden also demselben Affiliate gutgeschrieben; eine Verlängerung ohne die Metadaten greift auf die Attributionshistorie des Kunden zurück.
• Creem sendet Verkäufe, Ereignisse zum Lebenszyklus von Abonnements, Erstattungen und Streitfälle an den Rekomi-Webhook; jede Zustellung wird per Signatur geprüft (Creem signiert auf zwei Arten, mit einem älteren HMAC-Header und nach dem Standard-Webhooks-Schema, und Rekomi prüft, was die Zustellung mitbringt). Das ältere Schema hat keinen Zeitstempel, der Schutz vor Replays beruht auf diesem Weg also auf der Deduplizierung von Ereignissen; das Standard-Schema ergänzt ein Aktualitätsfenster von 300 Sekunden.
• Einmalige Checkouts werden als einmalige Conversions erfasst und Abo-Belastungen als erste oder wiederkehrende Conversions, dedupliziert anhand der zugrunde liegenden Bestell- und Transaktions-IDs, damit erneute Zustellungen und manuelle Neusendungen nie doppelt zählen. Provisionen werden auf den Verkaufsbetrag vor Steuern berechnet (Creem zieht als Merchant of Record die Steuer zusätzlich ein); Testphasen erzeugen ein Lebenszyklus-Ereignis über $0, das Rekomi nie als Geld behandelt.
• Erstattungen holen die Provision anteilig auf den Anteil vor Steuern zurück, auch bei anteiligen Erstattungen nach einem Downgrade. Streitfälle holen die Provision immer zurück, und weil Creem bei Rückbuchungen meist automatisch erstattet, ist die Rückforderung auf die ursprüngliche Provision begrenzt; das doppelte Signal aus Erstattung und Streitfall führt also nie zu einer doppelten Rückforderung.
• Der Test Mode ist abgeschottet: Ereignisse, deren Modus nicht zur Umgebung der Verbindung passt, werden übersprungen und nie als Geld erfasst.

Was Rekomi speichert

Dein API-Schlüssel und das Signing Secret des Webhooks werden verschlüsselt gespeichert und nie von der API zurückgegeben. Rekomi speichert außerdem die Umgebung und die Zeitstempel der Gesundheitschecks; Creem hat keinen Endpunkt für die Identität des Stores, deshalb werden weder Store-ID noch Store-Name gespeichert.

Zustand des Schlüssels

API-Schlüssel von Creem laufen nicht ab. Der Gesundheitscheck von Rekomi erkennt einen gelöschten oder neu erzeugten Schlüssel und einen Schlüssel, der bei einer Änderung der Berechtigungen den Lesezugriff auf Products verloren hat, zeigt ein Banner zum Neuverbinden und schickt dir eine E-Mail; fügst du einen neuen Schlüssel ein, ist die Verbindung mit vollständigem Verlauf wiederhergestellt. Der Check prüft den Schlüssel, nicht den Webhook: Creem hat keine API zur Verwaltung von Webhooks, ein gelöschter Endpunkt fällt also nur daran auf, dass keine neuen Ereignisse mehr kommen, und die Lösung ist, die URL im Dashboard von Creem mit allen ausgewählten Ereignissen wieder hinzuzufügen.

Dodo Payments

Marken, die über Dodo Payments verkaufen (Merchant of Record für digitale Produkte und SaaS), verbinden sich nativ mit einer einzigen Einfügung: Du fügst einen API-Schlüssel mit aktiviertem Schreibzugriff ein, und Rekomi legt den Webhook-Endpunkt selbst in deinem Dodo-Payments-Konto an und holt dir dessen Signing Secret. Nichts wird zurück in Dodo kopiert, und mit dem Secret hast du überhaupt nichts zu tun. Das erfasst deine Verkäufe (damit Affiliates ihre Gutschrift bekommen) und hängt nicht davon ab, wie du für Rekomi bezahlst.

Wo du verbindest

Einrichtung → Zahlungsanbieter verbinden → Dodo Payments verbinden. Die Seite nimmt einen API-Schlüssel mit aktiviertem Schreibzugriff entgegen (Schlüssel mit reinem Lesezugriff bestehen die Prüfung, können aber keine Webhooks anlegen, und die Fehlermeldung sagt genau das); Rekomi prüft den Schlüssel live bei Dodo, legt den Endpunkt mit genau den benötigten Ereignissen an und holt das Signing Secret, alles in einem Verbindungsschritt. Die Schritt-für-Schritt-Anleitung findest du unter Auf Dodo Payments installieren.

So funktioniert es

• Du gibst die Affiliate-Empfehlung in den Checkout-Metadaten als rekomi_ref mit: Setz sie beim Erstellen von Checkouts, Abonnements oder Zahlungen über die API von Dodo, oder häng den flachen Parameter ?metadata_rekomi_ref= an statische Zahlungslinks von Dodo an (Dodo übernimmt flache Query-Parameter der Form metadata_key=value in die Metadaten). Abo-Metadaten bleiben über die gesamte Laufzeit des Abonnements erhalten; eine Verlängerung ohne sie greift auf die Attributionshistorie des Kunden zurück.
• Dodo sendet Zahlungen, Ereignisse zum Lebenszyklus von Abonnements, Erstattungen und Streitfälle an den Rekomi-Webhook; jede Zustellung wird per Signatur geprüft (nach dem Standard-Webhooks-Schema mit einem Aktualitätsfenster von 300 Sekunden), und bei allem Fehlerhaften bleibt die Verarbeitung aus (Fail-closed).
• Jede Belastung (einmalig, erste Abo-Belastung, Verlängerung, Planwechsel, Nachzahlung nach einer Sperre) kommt als ein Zahlungsereignis an; Rekomi kennzeichnet sie als erste oder wiederkehrende Zahlung, je nachdem, ob es das Abonnement schon kennt, dedupliziert anhand der zugrunde liegenden IDs von Zahlung, Abonnement, Erstattung und Streitfall, damit Wiederholungen und manuelle Neuzustellungen nie doppelt zählen. Provisionen werden auf den Verkaufsbetrag vor Steuern berechnet, wenn Dodo die Steueraufteilung der Belastung meldet (als Merchant of Record tut es das normalerweise), und andernfalls auf den belasteten Betrag; Erstattungen und Streitfälle werden inklusive Steuer gemeldet, und jede Rückforderung ist auf den gutgeschriebenen Betrag begrenzt. Testphasen erzeugen bis zur ersten echten Belastung kein Zahlungsereignis.
• Erstattungen holen die Provision automatisch zurück, Teilerstattungen anteilig und begrenzt auf die ursprüngliche Provision; eine volle Erstattung, die ohne Betrag gemeldet wird, holt alles Verbleibende zurück. Streitfälle holen die Provision schon bei ihrer Eröffnung zurück; ein späterer Gewinn stellt sie nicht automatisch wieder her (er wird für eine manuelle Korrektur protokolliert). Zahlungen in einer Währung, die Rekomi nicht unterstützt, werden übersprungen und markiert, nie geraten.
• Live-Modus und Testmodus sind bei Dodo getrennte Welten (eigene Hosts, Schlüssel und Webhooks), und Ereignisse werden zusätzlich gegen das verbundene Business geprüft, bevor irgendetwas erfasst wird.

Was Rekomi speichert

Dein API-Schlüssel und das Signing Secret des Webhooks werden verschlüsselt gespeichert und nie von der API zurückgegeben. Rekomi speichert außerdem die Business-ID, die ID des angelegten Webhook-Endpunkts (damit beim Trennen der Endpunkt aus der Ferne gelöscht wird), die Umgebung und die Zeitstempel der Gesundheitschecks; Dodo bietet keine Abfrage des Kontonamens, deshalb wird kein Anzeigename gespeichert.

Zustand des Schlüssels

API-Schlüssel von Dodo laufen nicht ab. Der Gesundheitscheck von Rekomi prüft den Webhook-Endpunkt, den Rekomi angelegt hat (damit werden in einem Aufruf der Schlüssel, die Existenz des Endpunkts und eine Deaktivierung im Dashboard von Dodo geprüft), zeigt ein Banner zum Neuverbinden und schickt dir eine E-Mail, mit eigenem Text für einen deaktivierten Endpunkt (aktiviere ihn in Dodo wieder oder verbinde neu) und für einen widerrufenen Schlüssel (erstelle einen neuen Schlüssel mit aktiviertem Schreibzugriff und verbinde neu; Dodo hat keine API zum Erneuern des Secrets, das Neuverbinden ist also immer der Weg zur Wiederherstellung). Der Verlauf bleibt über das Neuverbinden hinweg erhalten.

Mollie

Marken, die über Mollie verkaufen (einen Zahlungsdienstleister für Unternehmen im EWR, in der Schweiz und in Großbritannien), verbinden sich nativ mit einer einzigen Einfügung: Du fügst ein Advanced Access Token mit sieben Berechtigungen ein (sechs Leseberechtigungen plus webhooks.write), und Rekomi legt einen signierten Webhook in deiner Mollie-Organisation an und speichert dessen Signing Secret für dich. Nichts wird zurück in Mollie kopiert, und mit dem Secret hast du überhaupt nichts zu tun. Das erfasst deine Verkäufe (damit Affiliates ihre Gutschrift bekommen) und hängt nicht davon ab, wie du für Rekomi bezahlst.

Wo du verbindest

Einrichtung → Zahlungsanbieter verbinden → Mollie verbinden. Die Seite nimmt ein Advanced Access Token entgegen, das ein Admin unter Developers > API keys mit angehakten webhooks.read, webhooks.write, payments.read, refunds.read, profiles.read, organizations.read und customers.read erstellt (ein normaler API-Schlüssel kann keine Webhooks verwalten und wird abgelehnt, und die Fehlermeldung sagt genau das). Erstelle das Token für alle Website-Profile der Organisation und für den Live-Modus; ein Token, das auf ein einzelnes Profil beschränkt ist, beantwortet Mollie bei den Verbindungsaufrufen mit einem 403. Rekomi prüft das Token live bei Mollie, lässt dich ein Website-Profil wählen, wenn das Token mehrere sieht, und legt den Webhook mit den benötigten Ereignissen an, alles in einem Verbindungsschritt. Der Webhook heißt „Rekomi“, gefolgt von einer kurzen ID für deinen Workspace, weil Webhook-Namen bei Mollie innerhalb einer Organisation eindeutig sein müssen. Die Schritt-für-Schritt-Anleitung findest du unter Auf Mollie installieren.

So funktioniert es

• Du gibst die Affiliate-Empfehlung als metadata.rekomi_ref mit, wenn du Zahlungen und Abonnements über die API von Mollie erstellst; Mollie reicht die Abo-Metadaten an jede Zahlung weiter, die das Abonnement erzeugt, Verlängerungen kommen also schon mit dem Eintrag an, und eine Verlängerung ohne ihn greift auf die Attributionshistorie des Kunden zurück. Mollie hat keine eigenen Gutscheincodes, deshalb wird ein Code pro Affiliate als metadata.rekomi_coupon übergeben; Rekomi liest ihn nur bei einmaligen und ersten Zahlungen, und Verlängerungen werden demselben Affiliate über die Kunden- und Abohistorie gutgeschrieben, die abweichende Provision eines Gutscheins gilt also für die erste Belastung und nicht für jeden Zyklus. Bei SaaS mit vorgeschalteter Anmeldung gleicht Rekomi die Zahlung über die E-Mail-Adresse des Käufers mit einem Lead ab, den das Tracking-Skript auf deiner Website erfasst hat (E-Mail-Erfassung im Anmeldeformular): aus billingAddress.email an der Zahlung oder, wenn die Zahlung keine enthält, aber zu einem Mollie-Kunden gehört, aus dessen Kundendatensatz über customers.read. Mit der E-Mail-Erfassung im Anmeldeformular werden Abo-Verkäufe auch ohne den Metadaten-Eintrag zugeordnet, der Eintrag bleibt aber der präzise Weg. Ein Token, das erstellt wurde, bevor customers.read zur Liste hinzukam, hat diese Berechtigung nicht. Eine Marke, die früher verbunden hat, erstellt deshalb ein neues Advanced Access Token mit allen sieben Berechtigungen und verbindet neu (der Verlauf bleibt erhalten) und übergibt bis dahin billingAddress.email an den Zahlungen, die sie selbst erstellt. Ein Affiliate, der mit seiner eigenen E-Mail-Adresse kauft, bekommt keine Gutschrift.
• Mollie sendet Zahlungen, Erstattungen und Rückbuchungen als signierte vollständige Snapshots an den Rekomi-Webhook; jede Zustellung wird per Signatur geprüft (HMAC-SHA256 über den Raw Body mit dem Secret des Webhooks), und bei allem Fehlerhaften bleibt die Verarbeitung aus (Fail-closed). Ereignisse zu Erstattungen und Rückbuchungen sind bei manchen Mollie-Konten noch in der Beta, deshalb prüft Rekomi Zahlungen, Erstattungen und Rückbuchungen zusätzlich alle 30 Minuten und erfasst alles, was der Webhook nicht geliefert hat; beide Wege nutzen dieselben Schlüssel, nichts zählt also doppelt.
• Jede bezahlte Zahlung (einmalig, erste Abo-Belastung, Verlängerung) kommt als ein Ereignis payment.paid an, einmal pro Zahlungs-ID; Mollie kennzeichnet jede Zahlung selbst als einmalig, erste oder wiederkehrende Zahlung. Eine erste Zahlung unter einer Einheit ihrer Währung (die Belastung von 0.00 oder 0.01 EUR, mit der Mollie das Mandat prüft) ist nie ein Verkauf und startet nie das Zeitfenster für wiederkehrende Provisionen. Provisionen werden auf die Summe vor Steuern berechnet, wenn die Zahlung Bestellpositionen mit Mehrwertsteuer enthält, sonst auf den belasteten Betrag (Mollie ist ein Zahlungsdienstleister und kein Merchant of Record, eine Zahlung hat also kein eigenes Steuerfeld). Mollie sendet keine Ereignisse zum Lebenszyklus von Abonnements, eine Kündigung wird deshalb daraus abgeleitet, dass ein Abonnement keine bezahlten Zahlungen mehr erzeugt.
• Erstattungen holen die Provision pro Erstattung zurück, sobald das Geld an den Kunden zurückgeht, Teilerstattungen anteilig und begrenzt auf die ursprüngliche Provision. Rückbuchungen holen die Provision zurück, sobald sie eingehen; eine spätere Rücknahme stellt sie nicht automatisch wieder her (sie wird für eine manuelle Korrektur protokolliert). Alle 28 Währungen von Mollie stehen auf der erlaubten Liste von Rekomi.
• Ein Website-Profil pro Workspace: Zahlungen aus anderen Profilen derselben Organisation werden mit einem Protokolleintrag übersprungen. Live-Modus und Testmodus werden wie das Website-Profil bei jeder Zahlung geprüft, bevor sie erfasst wird; Erstattungen und Rückbuchungen sind an die Zahlung gebunden, zu der sie gehören, eine Erstattung oder Rückbuchung gilt also nur für eine Zahlung, die dieser Workspace erfasst hat.

Was Rekomi speichert

Dein Advanced Access Token und das Signing Secret des Webhooks werden verschlüsselt gespeichert und nie von der API zurückgegeben. Rekomi speichert außerdem die Organisations-ID, die ID des gebundenen Website-Profils, die ID des angelegten Webhooks (damit beim Trennen der Webhook aus der Ferne gelöscht wird), die Liste der freigegebenen Ereignisse, den Modus, die Cursor für die Prüfung alle 30 Minuten und die Zeitstempel der Gesundheitschecks.

Zustand des Schlüssels

Der Gesundheitscheck von Rekomi liest den Webhook, den Rekomi angelegt hat (damit werden in einem Aufruf das Token, der Status des Webhooks und seine Ereignisliste geprüft), zeigt ein Banner zum Neuverbinden und schickt dir eine E-Mail, mit eigenem Text für einen blockierten oder deaktivierten Webhook (aktiviere ihn in Mollie unter Developers > Webhooks wieder oder verbinde neu) und für ein widerrufenes Token (erstelle ein neues Advanced Access Token und verbinde neu). Mollie hat keine API zum Erneuern des Secrets, und wenn du das Secret im Dashboard von Mollie erneuerst, wird das gespeicherte innerhalb eines Tages ungültig, das Neuverbinden ist also immer der Weg zur Wiederherstellung. Der Verlauf bleibt über das Neuverbinden hinweg erhalten.