Stripe Connect (Verkaufs-Tracking)

Stripe Connect ist der Standardweg und der einfachste, um Verkäufe in Rekomi zu bringen. Du erlaubst Rekomi einmal, dein Stripe-Konto zu lesen, und ab dann landet jeder bezahlte Checkout und jede Erstattung automatisch in Rekomi. Kein Snippet auf der Danke-Seite für das Verkaufsereignis, kein Abgleich pro Verkauf, keine Tabelle zum Monatsende.

Die meisten Marken nutzen diesen Weg: Wenn deine Abrechnung ohnehin über Stripe läuft, ist das Conversion-Backend nur einen Klick entfernt.

Direkt in Stripe verwalten. Die Rekomi-App für Stripe ist für den Stripe App Marketplace freigegeben, wird gerade ausgerollt und bringt Attribution, Freigaben von Provisionen und den Auszahlungsstatus direkt in dein Stripe Dashboard. Dasselbe native Tracking, nur ein anderer Einstieg.

Die zwei Hälften des Trackings

Das ist das Einzige, was du vorab verstehen solltest, denn es erklärt, warum das Verbinden von Stripe nicht immer der einzige Schritt ist:

1. Das Verkaufssignal (Stripe Connect). Über die Verbindung zu deinem Stripe-Konto erfährt Rekomi, dass ein Verkauf stattgefunden hat, mit Betrag, Währung und der Information, ob er später erstattet wurde. Rekomi erfasst den Betrag vor Steuern: Meldet Stripe eine Steuerzeile zur Zahlung, bleibt diese Steuer außen vor. So werden nie Provisionen auf Steuern gezahlt, die du einnimmst.
2. Attribution (Klick-Tracking oder Gutscheincodes). Die Stripe-Verbindung allein sagt Rekomi nicht, welchem Affiliate der Verkauf gutgeschrieben wird. Diese Information reist mit dem Verkauf mit und kommt auf einem dieser Wege an:
   • über das Klick-Cookie, das das Tracking-Snippet setzt und das als Metadatum rekomi_affiliate_id an das Abonnement oder die Rechnung weitergegeben wird (siehe Auf Stripe installieren), oder
   • über einen Gutscheincode, den der Affiliate teilt und den Stripe beim Verkauf festhält, oder
   • bei beehiiv, Kit, MailerLite, Ontraport und GoHighLevel über die Plattformverbindung unter Integrationen, die das Tag ausliest, das die Plattform bei der Anmeldung am Kunden gespeichert hat.

Stripe Connect ist also das Conversion-Backend, und das Snippet oder die Gutscheincodes sind die Attributionsschicht. Deshalb hakt das Onboarding „Zahlungsanbieter verbinden“ ab, sobald Stripe verknüpft ist, führt dich aber trotzdem durch die Installation des Snippets: Erst das Snippet benennt den Affiliate. Ein Verkauf ohne Attributions-Metadaten, ohne Affiliate-Gutscheincode und ohne frühere Attributionshistorie dieses Kunden wird zwar von Stripe erfasst, hat aber schlicht niemanden, dem er gutgeschrieben werden kann.

So verbindest du Stripe

In der Einrichtung hat der Schritt Zahlungsanbieter verbinden (/dashboard/setup/connect-sales) einen Button Stripe verbinden: ein Klick, keine Zwischenseite. Damit ist das Backend für das Conversion-Tracking fertig; Auszahlungen an Affiliates richtest du getrennt davon in deinen Auszahlungseinstellungen ein. Später erreichst du den Schritt auch über deine Einstellungen.

Nach dem Klick leitet dich Rekomi zur Zustimmungsseite von Stripe für die Rekomi-App. Dort wählst du das Stripe-Konto, über das du deine Kunden schon abrechnest, und bestätigst die Berechtigungen der App. Diese eine Autorisierung ist die Verbindung: Stripe schickt dich mit verknüpftem Konto zurück ins Dashboard, deine Verkaufs- und Erstattungsereignisse fließen ab sofort, und als Bonus erscheinen die Bereiche der App in deinem Stripe Dashboard. Unter /dashboard/setup/payments landet die Verbindung, und dort verwaltest du sie danach.

Status nach dem Verbinden:

• Nicht verbunden: Es ist noch kein Stripe-Konto verknüpft.
• Verbunden: Rekomi empfängt deine Verkaufs- und Erstattungsereignisse. Das Dashboard zeigt die ID des verbundenen Kontos (acct_...).

Ein Stripe-Konto ist mit genau einer Rekomi-Organisation verknüpft. Verbindest du später ein anderes Stripe-Konto, löst Rekomi die alte Verbindung und empfängt deren Ereignisse nicht mehr. Deinstalliere die Rekomi-App im Stripe Dashboard des alten Kontos, damit auch dort die Berechtigung entfernt wird.

Was Rekomi mit deinen Ereignissen macht

Sobald die Verbindung steht, liefert Stripe die Ereignisse deines Kontos über den Ereignisstrom der Rekomi-App an Rekomi. Rekomi reagiert auf:

• Verkäufe (erfolgreich bezahlte Rechnungen): Ist dem Verkauf ein Affiliate zugeordnet (über Metadaten, einen Gutscheincode oder die Attributionshistorie des Kunden), erfasst Rekomi eine Conversion, sobald die Rechnung bezahlt ist, und die Provision landet im Journal dieses Affiliates.
• Erstattungen (charge.refunded): Rekomi holt die Provision anteilig zurück und aktualisiert das ausstehende Guthaben des Affiliates noch am selben Tag. Einen Button „als erstattet markieren“ gibt es nicht, denn Stripe ist die maßgebliche Quelle. Kündigungen von Abonnements (customer.subscription.deleted) werden für die Berichte erfasst, holen aber nichts zurück: Eine bereits verdiente Provision bleibt verdient, solange die zugrunde liegende Zahlung nicht erstattet wird. Siehe Tracking und Attribution.

Doppelt zugestellte Ereignisse bewirken nichts: Jede Ereignis-ID von Stripe wird nur einmal verarbeitet.

Was Rekomi sehen kann und was nicht

Mit der Verbindung bekommt Rekomi Lesezugriff auf die Abrechnungsaktivität deines Kontos (Zahlungen, Rechnungen, Abonnements, Erstattungen). Die Kartennummern deiner Kunden sieht Rekomi nicht, und über die Verbindung fließt nie Geld auf dein Stripe-Konto oder von ihm weg: Auszahlungen an Affiliates werden über die Auszahlungsmethode finanziert, die du in Rekomi hinterlegst, nicht über dein Stripe-Guthaben. Du kannst den Zugriff jederzeit widerrufen (siehe „Trennen und neu verbinden“ unten).

Trennen und neu verbinden

Zum Trennen deinstallierst du die Rekomi-App in deinem Stripe Dashboard (Settings, dann Installed apps). Dein Stripe-Konto selbst bleibt unverändert; Rekomi empfängt einfach keine neuen Ereignisse mehr. Bereits erfasste Verkäufe bleiben in den Journalen der Affiliates, und wenn du die App wieder installierst, ist die Verbindung zum selben Workspace wiederhergestellt.

Um zu einem anderen Stripe-Konto zu wechseln, starte den Verbindungsablauf noch einmal und wähle auf der Zustimmungsseite das neue Konto.

Wann Stripe Connect nicht das richtige Backend ist

Stripe Connect passt am besten, wenn deine Verkäufe über Stripe laufen. Wenn nicht, oder wenn du nicht verbinden kannst, nimm eine der Alternativen. Sie vertragen sich untereinander; wähle die, die dazu passt, wo deine Verkäufe entstehen:

• Server-zu-Server-Tracking: Dein Backend schickt jede Conversion direkt an Rekomi. Am besten für In-App-Käufe in mobilen Apps, einen eigenen Checkout oder eine Abrechnung ohne Stripe.
• Gutscheincodes: Jeder Affiliate bekommt einen eigenen Code; Einlösungen werden automatisch zugeordnet. Funktioniert mit und ohne Stripe Connect und braucht keinen Code auf deiner Website.
• Browser-Pixel: für Checkouts ohne Stripe, bei denen du keinen serverseitigen Code ausführen kannst (Webflow, Memberstack, Lemon Squeezy).
• Plattformverbindung: Bei beehiiv, Kit, MailerLite, Ontraport und GoHighLevel schreibt die CRM-Verbindung Verkäufe anhand des Anmeldedatensatzes der Plattform gut, und bei Kit Commerce und Ontraport bringt sie auch die Verkäufe selbst mit.

Technischer Überblick

Für Entwickler und technisch Neugierige: Das passiert unter der Haube.

Verbinden (Autorisierung)

Workspaces autorisieren sich über den OAuth-Ablauf von Stripe Apps: POST /api/integrations/stripe-app/authorize erzeugt die Zustimmungs-URL des Marketplace für die Rekomi-App und leitet die Marke dorthin weiter. Mit der Zustimmung wird die App auf dem gewählten Konto installiert, und der Callback verknüpft dieses Konto (acct_...) mit deiner Organisation, über OAuth-Tokens, die auf dieses Konto beschränkt sind. Der Parameter state ist ein verschlüsseltes, signiertes Token (ASP.NET Data Protection), das an deine Organisation und an eine einmal verwendbare Nonce mit 10 Minuten Gültigkeit gebunden ist. So lässt sich der Callback weder wiederholen noch zwischen Organisationen vertauschen.

Ein eindeutiger Index stellt sicher, dass ein Stripe-Konto genau einer Organisation zugeordnet ist. Wer die Zustimmung für dasselbe Konto erneut durchläuft, repariert die bestehende Verknüpfung (mit frischen Tokens), statt eine doppelte anzulegen.

Empfang der Ereignisse (der Webhook-Weg)

Rekomi stellt einen einzigen Stripe-Webhook-Endpunkt bereit, der jede Zustellung gegen zwei Signing Secrets auf Plattformebene prüft: eines für die Plattformabrechnung von Rekomi selbst und eines für den Application Webhook, der die Ereignisse aller Konten mit installierter Rekomi-App liefert. Weil gegen Plattform-Secrets geprüft wird, richtest du keinen eigenen Stripe-Webhook ein, damit Rekomi Verkäufe empfängt. Die Installation der App nimmt dein Konto in den Ereignisstrom auf.

Hier geht es nur darum, wie Rekomi Ereignisse von Stripe empfängt. Wenn Rekomi Conversions wieder hinaus an deine eigenen Systeme schicken soll (um die Attribution zu spiegeln, in ein Data Warehouse zu synchronisieren usw.), ist das eine separate, optionale Rekomi-Funktion: siehe ausgehende Webhooks und Zapier. Jede Conversion über Gutscheincode, Link oder S2S ist außerdem ohnehin mit dem Tag „Quelle“ in deinem Dashboard sichtbar, die meisten Marken brauchen also gar keine Integration.

Bei einem Ereignis eines verbundenen Kontos setzt Stripe das Feld account des Ereignisses auf dein acct_.... Rekomi findet deine Organisation, indem es diesen Wert mit der gespeicherten ID des verbundenen Kontos abgleicht, und leitet das Ereignis an die Verarbeitung von Conversions oder Erstattungen weiter. Signaturen werden mit einer Toleranz von 300 Sekunden gegen Wiederholungen (Replay) geprüft, und verarbeitete Ereignis-IDs werden dedupliziert. Wiederholte und erneut abgespielte Zustellungen sind also unbedenklich.

Rangfolge der Attribution

Wenn ein Verkaufsereignis eintrifft, ermittelt Rekomi den Affiliate in dieser Reihenfolge:

1. Ein Affiliate-Gutscheincode beim Verkauf, wenn die Kampagne so eingestellt ist, dass Gutscheincodes Vorrang vor der Klick-Attribution haben.
2. rekomi_affiliate_id in den Metadaten des Abonnements oder der Rechnung, beim Checkout aus dem Klick-Cookie eingetragen.
3. Die Attributionshistorie des Kunden: Verlängerungen und Wiederholungskäufe werden dem Affiliate gutgeschrieben, der diesen Kunden ursprünglich vermittelt hat.
4. Ein Affiliate-Gutscheincode beim Verkauf, wenn die Kampagne nicht so eingestellt ist (nur genutzt, wenn keiner der Punkte oben greift).
5. Ein Abgleich der E-Mail-Adresse mit einem Lead, den der Affiliate zuvor erfasst hat.
6. Die Abfrage bei der Plattform: Bei Verbindungen zu beehiiv, Kit, MailerLite, Ontraport und GoHighLevel mit eingeschaltetem Verkäufe gutschreiben liest Rekomi das Tag aus, das die Plattform bei der Anmeldung am Kunden gespeichert hat. Immer als Letztes, nie als Überschreibung.

Greift nichts davon, hat der Verkauf keinen zuordenbaren Affiliate, und es entsteht keine Provision. Deshalb sind das Klick-Snippet (das die Attributions-Metadaten einträgt) oder Gutscheincodes neben Stripe Connect Pflicht und kein optionaler Feinschliff. Ausgenommen sind die fünf genannten Plattformen: Dort trägt die Verbindung die Attribution, und das Snippet liefert nur zusätzlich die Klickzahlen.

Verwandte Seiten

• Auf Stripe installieren: Attributions-Metadaten in deine Checkout Sessions eintragen und Attribution über Gutscheincodes für Payment Links (die Attributionshälfte)
• Tracking und Attribution: das vollständige Modell über alle Quellen
• Auszahlungen: wie Auszahlungen an Affiliates finanziert und ausgeführt werden
• Attribution über Gutscheincodes