Auf Creem installieren

Creem ist ein Merchant of Record für SaaS und digitale Produkte, und Rekomi ist direkt damit integriert. Du legst im Creem-Dashboard einen Webhook an, der auf die Rekomi-URL deines Workspaces zeigt, und fügst dann das Webhook-Signing-Secret und einen API-Schlüssel in Rekomi ein. Ab dann fließen Verkäufe, Abo-Verlängerungen, Erstattungen und Rückbuchungen in Rekomi, ohne dass du Relay-Code schreiben oder pflegen musst. Du bist noch am Abwägen? Lies Warum Rekomi für Creem →.

Eine Sache vorweg: Der API-Schlüssel, den du einfügst, dient nur dazu, die Verbindung zu prüfen und regelmäßig einen schreibgeschützten Gesundheitscheck auszuführen. Er liest nie deine Verkäufe; die kommen über den signierten Webhook. Ein minimaler Schlüssel mit Lesezugriff auf Products ist alles, was Rekomi braucht. Du gibst also nie einen Schlüssel aus der Hand, der an dein Geld herankäme.

Was du brauchst

• Einen Creem-Store im Produktionsmodus. Webhook und API-Schlüssel kommen beide aus deinem Produktions-Dashboard (nicht aus dem Test Mode; die Testumgebung von Creem ist eine eigene Welt mit eigenen creem_test_-Schlüsseln, und Rekomi lehnt Testzugangsdaten auf einer Produktionsverbindung mit einer eigenen Fehlermeldung ab, bevor irgendetwas gespeichert wird).
• Einen API-Schlüssel mit Lesezugriff auf Products. Öffne in Creem Developers > API Keys und erstelle einen Schlüssel. Lesezugriff auf Products reicht: Die Prüfung und der Gesundheitscheck von Rekomi sind ein einziger günstiger Lesezugriff. Beachte, dass Creem bei einem ungültigen oder widerrufenen Schlüssel mit demselben 403 antwortet wie bei einem Schlüssel ohne die Berechtigung. Nennt der Fehler beim Verbinden also den Lesezugriff auf Products und dein Schlüssel scheint richtig eingeschränkt, erstelle einen neuen Schlüssel und versuche es noch einmal.
• Fünf Minuten. Kein OAuth-Hin-und-Her und kein Code; der ganze Ablauf besteht aus zweimal Einfügen.

In Rekomi verbinden

Schritt 1. Öffne /dashboard/setup/creem. Die Seite zeigt die Webhook-URL deines Workspaces.

Schritt 2. Öffne in deinem Creem-Dashboard Developers > Webhooks und klicke auf Add Webhook. Gib ihm einen Namen (z. B. „Rekomi“), füge die URL aus Schritt 1 ein und wähle alle Ereignisse aus. Das ist wichtig: Das Webhook-Formular von Creem hat eine Ereignisauswahl, und Rekomi bestätigt Ereignistypen, die es nicht nutzt, und ignoriert sie. Eine Teilauswahl lässt aber Verkäufe stillschweigend wegfallen, ohne irgendwo einen Fehler zu zeigen; das einzige Anzeichen wäre, dass keine neuen Ereignisse mehr ankommen. Wähle alles aus.

Schritt 3. Kopiere das Webhook-Signing-Secret von der Seite Developers > Webhook in Creem und füge es genau so in Rekomi ein, wie es angezeigt wird, mit Präfix und allem.

Schritt 4. Füge deinen API-Schlüssel ein und klicke auf Creem verbinden. Rekomi prüft den Schlüssel live gegen Creem, bevor es ihn annimmt. Ein Schlüssel aus dem Test Mode bekommt eine eigene Fehlermeldung, ein ungültiger, widerrufener oder zu eng eingeschränkter Schlüssel dagegen eine gemeinsame Meldung, die alle drei Ursachen nennt, weil Creem bei jeder dasselbe 403 liefert.

Attribution: rekomi_ref in den Checkout-Metadaten mitgeben (Pflicht)

Creem hostet den Checkout auf seiner eigenen Domain, deshalb muss die Affiliate-Empfehlung vom Browser des Besuchers in den Checkout-Datensatz gelangen. Für die Attribution von Neukunden über Links ist dieser Schritt Pflicht: Ohne ihn kommt ein Verkauf über einen Link ohne Empfehlung an, und es wird keine Provision gutgeschrieben (zwei Dinge schreiben trotzdem von sich aus gut: ein eingelöster Affiliate-Gutscheincode, siehe die Hinweise unten, und eine E-Mail-Adresse des Käufers, die zu einem auf deiner Website erfassten Lead passt, siehe den Fallback am Ende dieses Abschnitts).

Stelle zuerst sicher, dass das Rekomi-Tracking-Skript auf deiner Marketing-Website installiert ist, damit der Affiliate-Klick erfasst wird und window.Rekomi.getReferral() einen Wert liefert, wenn ein Besucher über einen Affiliate-Link kommt. Es ist dasselbe Skript, das jede Rekomi-Installation nutzt; das Rezept für deine Website-Plattform im Installationsbereich erklärt es. Ein eigenes Skript für Creem gibt es nicht: Die direkte Verbindung, die du oben eingerichtet hast, erfasst den Verkauf. Wähle dann das Rezept, das dazu passt, wie du verkaufst:

Checkout-Sessions über die API von Creem anlegen. Lies die Empfehlung in deinem Frontend mit window.Rekomi.getReferral() aus, schick sie mit der Checkout-Anfrage an dein Backend und setze sie beim Anlegen der Checkout-Session in metadata:

{
  "product_id": "prod_your_product",
  "metadata": { "rekomi_ref": "REFERRAL_FROM_YOUR_FRONTEND" }
}

Payment Links. Ergänze den Link um den Metadaten-Parameter in eckigen Klammern; Creem überträgt die Metadaten des Links auf den Checkout:

const ref = window.Rekomi?.getReferral?.();
const url = new URL("https://www.creem.io/payment/prod_your_product");
if (ref) url.searchParams.set("metadata[rekomi_ref]", ref);
// use url.toString() as the href on your Buy button

Hinweis: Das Feld heißt rekomi_ref, nicht creem_ref (Creem reserviert creem_ref für seine eigene Affiliate-Funktion).

Abgleich über die Lead-E-Mail (Fallback). Erreicht ein Checkout Rekomi ohne rekomi_ref in den Metadaten und ohne Affiliate-Gutscheincode und enthält das Ereignis die E-Mail-Adresse des Kunden, gleicht Rekomi diese Adresse zusätzlich mit den Leads ab, die das Rekomi-Skript in den letzten 90 Tagen auf deiner eigenen Website erfasst hat (das Tag, das Rekomi ausgibt, enthält data-rkmi-email-capture="auto", das die in deinem Registrierungsformular eingetippte E-Mail-Adresse als Lead erfasst; siehe Lead-Tracking), und schreibt dem Affiliate gut, der diesen Lead gebracht hat. Ein Gutscheincode oder eine Empfehlung in den Metadaten hat immer Vorrang, wenn vorhanden, genauso wie der bisherige Verlauf des Kunden, und ein Affiliate, der mit seiner eigenen E-Mail-Adresse kauft, bekommt keine Gutschrift.

So werden Verkäufe und Verlängerungen erfasst

• Einmalige Verkäufe werden erfasst, wenn Creem den abgeschlossenen Checkout meldet, mit dem Bestellbetrag.
• Abonnements erfassen die erste Abbuchung als erste Conversion wie bei einem Einmalkauf und jede Verlängerung als wiederkehrende Conversion, jeweils mit dem abgebuchten Transaktionsbetrag. Checkout-Metadaten bleiben am Abonnement erhalten, Verlängerungen werden also ohne Zusatzaufwand demselben Affiliate gutgeschrieben. Kommt eine Verlängerung doch einmal ohne sie an, greift Rekomi auf den Attributionsverlauf des Kunden zurück.
• Testphasen beginnen mit einem Ereignis im Abo-Lebenszyklus und ohne Geld; eine Provision gibt es erst ab der ersten echten Abbuchung. Kündigungen kommen als Kündigungssignale an, für Provisionsregeln, die bei Kündigung stoppen.
• Provisionen werden in beiden Steuermodi von Creem auf den Verkaufsbetrag vor Steuern berechnet. Creem ist ein Merchant of Record und zieht daher die Steuer ein; deine Affiliates verdienen am Verkauf, nicht an der Steuer. Das funktioniert unabhängig davon, wie deine Produkte bepreist sind: Bei Preisen ohne Steuer kommt die Steuer auf deinen Preis obendrauf, bei Preisen inklusive Steuer enthält dein Listenpreis die Steuer schon. Rekomi ermittelt den Nettobetrag aus dem, was der Kunde tatsächlich bezahlt hat, abzüglich der Steuerposition, sodass ein Produkt mit Preis inklusive Steuer keine Provision auf seine Mehrwertsteuer zahlt.
• Alles wird anhand der zugrunde liegenden IDs von Bestellung, Transaktion, Erstattung und Streitfall dedupliziert, erneute Zustellungen und manuelles Neusenden bei Creem werden also nie doppelt gezählt.

Erstattungen und Rückbuchungen

Erstattungen machen die Provision automatisch und anteilig auf den Anteil vor Steuern rückgängig: Eine Erstattung von 50% holt 50% der Provision zurück, und mehrere Teilerstattungen holen so lange weiter zurück, bis die ursprüngliche Provision aufgebraucht ist, nie darüber hinaus. Das gilt auch für anteilige Erstattungen bei einem Downgrade: Stuft ein Kunde mitten im Zeitraum herunter und erstattet Creem den ungenutzten Teil, wird die Provision ebenfalls anteilig zurückgeholt. Das ist so gewollt (der Affiliate verdient an dem, was der Kunde tatsächlich bezahlt hat).

Streitfälle (Rückbuchungen) holen das strittige Geld immer zurück. Creem führt bei einer Rückbuchung meist in deinem Namen eine volle Erstattung durch, was für dasselbe Geld sowohl ein Erstattungs- als auch ein Streitfallereignis erzeugen kann. Die Rückforderung von Rekomi ist auf die ursprüngliche Provision begrenzt, das doppelte Signal führt also nie zu einer doppelten Rückforderung.

Währungen

Creem bepreist derzeit in USD und EUR (die Währungsliste zu erweitern ist Sache von Creem, keine Grenze von Rekomi). Rekomi erfasst Conversions in der Währung, die Creem meldet; bei 135+ unterstützten Währungen ist alles, was Creem hinzufügt, mit ziemlicher Sicherheit schon abgedeckt. Kommt im seltenen Fall ein Betrag in einer Währung außerhalb der erlaubten Liste an, wird dieses Ereignis übersprungen und markiert, statt geraten zu werden, damit eine Provision nie auf einen verfälschten Betrag berechnet wird.

Sicherheit

• Jede Webhook-Zustellung wird per Signatur geprüft, bevor irgendetwas verarbeitet wird. Creem signiert Zustellungen auf zwei Arten, mit einem älteren HMAC-Header und nach dem Standard-Webhooks-Schema, und Rekomi prüft die Variante, die die Zustellung mitbringt; bei allem Fehlerhaften gilt Fail-closed.
• Ein ehrlicher Hinweis: Das ältere Schema enthält keinen Zeitstempel. Der Schutz vor Replays beruht auf diesem Weg daher auf der Deduplizierung von Ereignissen durch Rekomi (eine erneut abgespielte Zustellung wird erkannt und ignoriert) und nicht auf einem Zeitfenster. Das Standard-Webhooks-Schema fügt zusätzlich ein Zeitfenster von 300 Sekunden hinzu.
• Signing-Secret und API-Schlüssel werden verschlüsselt gespeichert und nie von der API zurückgegeben. Beim Trennen werden beide gelöscht, und die Webhook-URL wird stillgelegt.
• Test Mode und Produktion sind getrennt: Ereignisse, deren Modus nicht zu deiner Verbindung passt, werden übersprungen und nie als Geld erfasst.

Gut zu wissen

• Eine Conversion-Quelle pro Workspace. Creem Connect schließt Stripe (über die Rekomi-App für Stripe), Paddle, Braintree, Shopify, Lemon Squeezy, Chargebee, Polar, Recurly, Gumroad, Dodo Payments, Mollie und die S2S-API aus, damit derselbe Verkauf nie doppelt gezählt wird. Trenne die eine Verbindung, bevor du eine andere herstellst.
• Creem-API-Schlüssel laufen nicht ab. Meldet der Gesundheitscheck die Verbindung als unterbrochen, wurde der Schlüssel in Creem gelöscht oder neu erzeugt, oder er hat bei einer Änderung der Berechtigungen den Lesezugriff auf Products verloren; ein routinemäßiger Ablauf ist es nie. Verbinde mit einem aktuellen Schlüssel neu.
• Der Gesundheitscheck prüft den Schlüssel, nicht den Webhook. Creem hat keine API zur Verwaltung von Webhooks, ein gelöschter Rekomi-Endpunkt fällt dem Gesundheitscheck also nicht auf; das einzige Anzeichen ist, dass keine Ereignisse mehr ankommen. Die Einrichtungsseite liest für dich den Zeitpunkt des letzten Ereignisses aus: Sie bleibt gelb mit „Verbunden, aber es ist noch kein Ereignis eingetroffen.“, bis eine signierte Zustellung ankommt, und warnt erneut, wenn länger als eine Woche keine Ereignisse kommen. Beide Zustände führen zur selben Lösung: Füge die URL unter Developers > Webhooks mit allen Ereignissen erneut hinzu.
• Zum Austauschen der Zugangsdaten musst du nicht trennen. Löschst du den Webhook in Creem und legst ihn neu an, bekommst du ein neues Signing-Secret, und bis du es einfügst, scheitert jede Zustellung an der Signaturprüfung, während die Verbindung weiter gesund aussieht (der API-Schlüssel ist nicht betroffen). Nutze Zugangsdaten aktualisieren auf der Einrichtungsseite. Deine Webhook-URL bleibt erhalten, auf der Seite von Creem ändert sich also nichts. Würdest du stattdessen trennen, würde die URL ausgetauscht, und du müsstest alles neu einrichten.
• Die Wiederholungsstufen reichen über mehrere Stunden. Creem wiederholt eine fehlgeschlagene Zustellung 30 Sekunden, 5 Minuten, 30 Minuten und 6 Stunden nach dem ersten Versuch (fünf Zustellungen über etwa 6.5 Stunden; den Ablauf hat der Creem-Support bestätigt) und hört dann auf. Kann Rekomi ein Geldereignis kurzzeitig nicht verarbeiten, antwortet es absichtlich mit einem Fehler, damit Creem erneut zustellt. Für alles, was länger dauert als diese Stufen, hat das Creem-Dashboard im Bereich Developers die Möglichkeit, manuell neu zu senden, und Rekomi erfasst neu gesendete Ereignisse sicher, ohne doppelt zu zählen.
• Die Attribution über Gutscheincodes läuft. Die Webhooks von Creem enthalten den Rabattcode, den der Käufer eingelöst hat, und ein Code, der zum Gutscheincode eines Affiliates in Rekomi passt, schreibt diesem Affiliate auch ohne erfassten Klick gut. Der eingelöste Code hat Vorrang vor Link-Signalen (einen Code im Checkout einzutippen ist die deutlichste Aussage des Käufers darüber, wer ihn geschickt hat), und ein unbekannter oder widerrufener Code fällt ohne Schaden auf die normale Link-Attribution über rekomi_ref zurück.

Im Test Mode üben

Der Test Mode von Creem ist eine eigene Umgebung, und Rekomi-Verbindungen für die Produktion lehnen Testzugangsdaten bewusst ab. Eine vollständige Probe läuft deshalb auf einem Staging-Setup. Was du in der Produktion prüfen kannst, ohne Geld auszugeben:

1. Verbinde und klicke dann auf der Einrichtungsseite auf Verbindung prüfen: Das prüft deinen API-Schlüssel live.
2. Lege den Webhook mit allen Ereignissen an und sende dann, falls angeboten, von der Webhook-Seite in Creem eine Testzustellung; eine Zustellung mit gültiger Signatur aktualisiert „letztes Ereignis“ auf der Einrichtungsseite.
3. Tätige einen echten Kauf über einen Affiliate-Link, bei dem ?via= auf den Link-Slug eines freigegebenen Affiliates gesetzt ist, prüfe, ob die Conversion innerhalb einer Minute im Performance-Tab der Kampagne erscheint, erstatte den Kauf dann und prüfe, ob die Provision zurückgeholt wird.

Fehlerbehebung

Banner „Deine Creem-Verbindung ist unterbrochen.“ oder E-Mail zum Neuverbinden. Der gespeicherte API-Schlüssel wird nicht mehr akzeptiert: Er wurde in Creem gelöscht oder neu erzeugt, oder er hat den Lesezugriff auf Products verloren. Erstelle einen neuen Schlüssel (Lesezugriff auf Products reicht) und verbinde unter /dashboard/setup/creem neu; dein Tracking-Verlauf bleibt erhalten.

„That is a creem_test_ key...“ (ein Schlüssel aus dem Test Mode) Du hast einen Schlüssel aus dem Test Mode in eine Produktionsverbindung eingefügt (oder umgekehrt). Schlüssel lassen sich zwischen den Umgebungen von Creem nicht austauschen; füge einen Live-Schlüssel mit creem_ aus deinem Produktions-Dashboard ein.

Der Fehler sagt, der Schlüssel sei „ungültig, widerrufen oder hat keine Leseberechtigung für Products“. Creem antwortet bei allen drei Ursachen mit demselben 403, Rekomi kann sie also nicht unterscheiden. Rekomi braucht nur Lesezugriff auf Products; scheint dein Schlüssel richtig eingeschränkt, erstelle einen neuen Schlüssel mit dieser Berechtigung und verbinde erneut.

Ereignisse kommen nicht mehr an, aber die Verbindung wirkt gesund. Der Gesundheitscheck prüft den API-Schlüssel, nicht den Webhook. Prüfe, ob der Endpunkt in Creem unter Developers > Webhooks noch existiert, auf die richtige URL zeigt und alle Ereignisse ausgewählt hat (eine Teilauswahl ist der klassische stille Fehler). Das Creem-Dashboard zeigt Zustellversuche und lässt dich neu senden. Hast du den Webhook irgendwann neu angelegt, hat sich das Signing-Secret geändert: Füge das aktuelle über Zugangsdaten aktualisieren ein.

Verkäufe kommen an, aber kein Affiliate bekommt eine Gutschrift. Der Checkout hat Rekomi erreicht, aber ohne rekomi_ref. Prüfe, ob dein Aufruf zum Anlegen des Checkouts metadata.rekomi_ref setzt (oder deine Payment Links ?metadata[rekomi_ref]= enthalten) und ob das Tracking-Skript gelaufen ist, bevor der Käufer weitergeklickt hat (damit window.Rekomi.getReferral() einen Wert hatte).

Nach einem Ausfall fehlt eine Conversion. Die Wiederholungsstufen von Creem enden nach etwa 6.5 Stunden. Öffne die Zustellung im Creem-Dashboard im Bereich Developers und sende sie erneut; Rekomi erfasst sie sicher, ohne doppelt zu zählen.

Verwandte Seiten

• Rekomi in der offiziellen Dokumentation von Creem, die eigene Anleitung von Creem zu dieser Integration
• Referenz der S2S-Tracking-API
• Checkout-Tracking ohne Code und ohne Stripe
• Umgang mit Erstattungen