Recurly-Affiliate-Programm: So startest du 2026 eins auf deinem eigenen Zahlungsanbieter

Kurz gesagt. Recurly bringt keine Affiliate-Funktion mit. Ein Recurly-Affiliate-Programm heißt also, eine Tracking-Ebene hinzuzufügen: ein selbst gebautes Webhook-Relay, eine Agentur mit Tabellen oder eine Plattform mit nativer Recurly-Integration. Der native Weg besteht aus einem Read-Only API Key, einem XML-Webhook und einem Custom Field (benutzerdefiniertes Feld) namens rekomi_ref am Abonnement. Ab dann regeln bezahlte Rechnungen, Verlängerungen, Erstattungen und annullierte Zahlungen (Voids) die Provisionen ganz von selbst.

Ein Recurly-Affiliate-Programm beginnt mit einer Tatsache, über die die meisten Anleitungen hinweggehen: Recurly ist eine Abo-Abrechnung, die auf dem Zahlungsanbieter läuft, den du ohnehin nutzt, und bringt kein eigenes Affiliate-Tracking mit. Diese Kombination entscheidet alles darüber, wie das Tracking von Empfehlungen funktionieren muss, und wenn du das Prinzip einmal verstanden hast, ist das ganze Setup ehrlich gesagt ziemlich aufgeräumt. Rekomi, die Affiliate-Software, die ich baue, hat eine native Recurly-Integration, die ich selbst geschrieben habe. Ich kenne die Technik darunter also bis zu den Namen der einzelnen Notifications.

Dieser Ratgeber zeigt dir, warum Abo-Unternehmen auf Recurly so gute Kandidaten für einen Affiliate-Kanal sind, welche drei Wege es gibt, einen zu betreiben, was die native Einrichtung umfasst (einschließlich der einen Einschränkung bei den Recurly-Plänen, die du vor dem Start kennen solltest) und was genau erfasst wird, sobald du verbunden bist.

Warum Recurly-Unternehmen Affiliate-Programme einführen

Weil die wiederkehrende Abrechnung aus einer einzigen Empfehlung einen ganzen Strom von Zahlungen macht, und das verändert die Konditionen des ganzen Kanals. Bleibt ein vermittelter Kunde in einem Plan für $79/Monat ein Jahr lang dabei, zahlt eine wiederkehrende Provision von 20% dem Affiliate $15.80 im Monat, also $189.60 übers Jahr, bei $948, die du eingenommen hast. Du hast für Kundenbindung bezahlt, nicht nur für einen Klick, und der Affiliate hat sich etwas aufgebaut, das eher MRR ähnelt als einer einmaligen Prämie. Dieser Deal ist für beide Seiten wirklich gut, und deshalb suchen SaaS-Affiliates gezielt nach Programmen mit wiederkehrenden Provisionen.

Teams entscheiden sich für Recurly, weil sie die Kontrolle behalten wollen: Es steuert Pläne, Testphasen, Mahnwesen und Rechnungsstellung, während die Zahlungen weiter über deinen eigenen Zahlungsanbieter laufen, ob Stripe, Adyen, Braintree oder GoCardless. Die gute Nachricht fürs Tracking: Recurly ist die maßgebliche Quelle für jede dieser Rechnungen. Eine Tracking-Ebene, die auf Recurly hört, sieht jede Zahlung genau gleich, egal welcher Zahlungsanbieter die Karte verarbeitet hat, und an deinem Zahlungsrouting ändert sich nie etwas. Wenn du genauer wissen willst, wie diese Art von Tools funktioniert, erklärt mein Ratgeber zu Affiliate-Tracking-Software das von Grund auf.

Drei Wege, ein Recurly-Affiliate-Programm zu betreiben

Weg 1: Bau es selbst auf den Webhooks von Recurly auf. Recurly veröffentlicht Webhook-Notifications für Rechnungen, Zahlungen, Erstattungen und Ereignisse im Lebenszyklus eines Abos, ein Entwickler kann also durchaus ein Relay bauen, das Empfehlungen dem richtigen Affiliate gutschreibt. Plan aber den echten Umfang ein: Du müsstest XML-Payloads parsen, die wiederholten Zustellungen von Recurly deduplizieren, die Empfehlung aus dem Browser des Besuchers in den Abo-Datensatz bringen, Erstattungen und annullierte Zahlungen als Stornierungen behandeln und dann trotzdem noch die Anmeldung für Affiliates, Dashboards, Auszahlungen und Steuerformulare bauen. Die ersten 20% sind ein spaßiges Wochenende, die anderen 80% sind ein Produkt.

Weg 2: eine Agentur oder eine Tabelle. Viele Programme fangen damit an, dass jemand, der für Partnerschaften eingestellt wurde, jeden Monat die Empfehlungen in einer Tabelle abgleicht, und bei 3 Affiliates funktioniert das. Es hört in dem Monat auf zu funktionieren, in dem ein Affiliate fragt, warum seine Zahl nicht zu deiner passt, und du keine Ereignisprotokoll hast, mit der du antworten kannst. Beim manuellen Abgleich fallen außerdem stillschweigend die Erstattungen unter den Tisch, und das heißt, du zahlst zu viel aus und merkst es nie.

Weg 3: eine Plattform mit nativer Recurly-Integration. Die Liste ist hier kürzer, als du erwarten würdest. FirstPromoter und impact.com haben beide glaubwürdige serverseitige Recurly-Integrationen, und das sind solide Produkte; Rewardful, das Tool, das die meisten Gründer kennen, die zuerst auf Stripe setzen, unterstützt Recurly derzeit nicht. Auch die Integration von Rekomi gehört in dieses Lager, und weil sie von mir ist, geht der Rest dieses Artikels dieses Setup als konkretes Beispiel durch. Die Teile, auf die es ankommt (das Custom Field, der Webhook, der Vorbehalt beim Plan), gelten für jeden serverseitigen Weg, den du wählst.

So sieht die native Einrichtung aus

Drei Teile, hier nur im Überblick; in der Anleitung zur Einrichtung mit Recurly findest du jeden Klick und jedes Code-Snippet.

1. Ein Read-Only API Key und deine Region. Recurly betreibt eine US-Region (v3.recurly.com) und eine EU-Region (v3.eu.recurly.com). Du wählst deine aus und erstellst dann unter Integrations > API Credentials einen privaten API-Schlüssel mit gesetztem Häkchen bei Read-only. Rekomi prüft den Schlüssel live bei deiner Region, und wenn er eigentlich zur anderen Region gehört, bekommst du einen Vorschlag für die richtige Region statt einer kryptischen Fehlermeldung. Mit dem Schlüssel wird nie etwas in deiner Recurly-Site geändert.
2. Ein XML-Webhook mit Basic Authentication. In der Admin-Oberfläche von Recurly fügst du unter Integrations > Webhooks einen einzigen Endpunkt hinzu: die URL für deinen Workspace, die Rekomi erzeugt, das Format XML und Zugangsdaten für Basic Authentication, die Rekomi für dich erstellt. Dieser Schritt mit der Authentifizierung ist wichtig, weil Recurly seine JSON-Webhooks signiert, die XML-Webhooks aber nicht, und gerade die XML-Payloads tragen die vollständigen Rechnungsdaten. Deshalb wird jede Zustellung authentifiziert, bevor irgendetwas verarbeitet wird.
3. Ein Custom Field rekomi_ref am Abonnement. Recurly hostet den Checkout auf seiner eigenen Domain, die Empfehlung muss also aus dem Browser des Besuchers in den Abo-Datensatz gelangen. Das Head-Skript von Rekomi erfasst den Klick auf den Affiliate-Link auf deiner Marketing-Website, dein Frontend liest ihn mit window.Rekomi.getReferral() aus, und dein Backend setzt ihn als Custom Field rekomi_ref, wenn es das Abonnement anlegt. Für die Attribution neuer Kunden ist dieser Schritt Pflicht: Lässt du ihn weg, kommen bezahlte Rechnungen ohne Empfehlung an.

Ein ehrlicher Vorbehalt, bevor du anfängst: Custom Fields sind eine Funktion von Recurly Pro und Elite (bis zu 5 bzw. 10 Felder), und der Starter-Plan von Recurly hat sie nicht. Im Starter-Plan gibt es also kein Feld, in dem du die Empfehlung hinterlegen kannst, und die Attribution neuer Kunden ist dort nicht möglich; Verlängerungen von Kunden, die schon zugeordnet sind, werden in jedem Plan weiter problemlos erfasst. Wenn du im Starter-Plan bist und es mit einem Affiliate-Kanal ernst meinst, rechne das Upgrade des Plans in deine Entscheidung ein.

Die Zuverlässigkeit ist besser, als du bei einem System auf Basis von Webhooks vermuten würdest, und genau diesen Teil liebe ich am Design von Recurly: Fehlgeschlagene Zustellungen werden automatisch wiederholt, bis zu 10-mal über rund drei Tage, und jede Notification behält danach noch 15 Tage lang einen manuellen Retry-Button in deiner Recurly-Konsole. Ein kurzer Ausfall auf einer der beiden Seiten behebt sich beim nächsten Versuch von selbst, und wiederholte Zustellungen werden dedupliziert, damit nichts doppelt zählt.

Was erfasst wird, sobald du verbunden bist

Jede Geldbewegung, in beide Richtungen. Diese zweite Richtung ist mein einziger harter Standpunkt auf dieser Seite: Eine Tracking-Ebene, die Verkäufe gutschreibt, aber Erstattungen und annullierte Zahlungen nicht sieht, zahlt deinen Affiliates systematisch zu viel aus. Und speziell bei Recurly sind Voids eine eigene Notification, getrennt von Erstattungen. Ein Relay, das nur successful_refund_notification verarbeitet, verpasst also echte Stornierungen. Hier das vollständige Bild:

• Bezahlte Rechnungen erzeugen Conversions. Die erste bezahlte Belastungsrechnung (Charge Invoice) eines Abonnements verbucht die Conversion für den Neukunden und schreibt sie anhand des Felds rekomi_ref dem richtigen Affiliate gut.
• Verlängerungen kommen als weitere bezahlte Rechnungen an und verbuchen automatisch wiederkehrende Provisionen, zugeordnet über deine Kundenhistorie, ganz ohne zusätzliche API-Aufrufe. Hier laufen die $15.80/Monat aus dem Beispiel oben weiter auf, ohne dass irgendwer etwas anfassen muss.
• Erstattungen holen die Provision anteilig zurück, pro Erstattungstransaktion. Erstattest du 40% dieser Rechnung über $79 ($31.60 zurück an den Kunden), gehen genau 40% der Provision von $15.80 ($6.32) vom Guthaben des Affiliates ab. Mehrere Teilerstattungen holen so lange weiter zurück, bis der ursprüngliche Betrag aufgebraucht ist.
• Annullierte Zahlungen machen den vollen Transaktionsbetrag rückgängig, getrennt von Erstattungen, im selben Prüfpfad.

Beide Seiten des Provisionsbuchs regeln sich von selbst, und die Zahl, die ein Affiliate in seinem Dashboard sieht, ist dieselbe, die du bekommen würdest, wenn du sie von Hand aus Recurly herleitest. Genau diese Symmetrie macht es sicher, Auszahlungen zu automatisieren!

Rekomi selbst ist Affiliate-Software für Recurly und mehr als ein Dutzend weitere Abrechnungs- und Creator-Plattformen, und die Hälfte für die Affiliates ist gleich eingebaut: Anmeldeseiten, Dashboards, automatische Auszahlungen und Steuerformulare. Die Pläne kosten $29/Monat, $49/Monat oder $99/Monat plus eine Plattformgebühr von 3%, die nur auf das anfällt, was Affiliates tatsächlich verdienen, und diese Gebühr deckt die Auszahlungen und die Steuerabwicklung schon ab. Jeder Plan startet mit einer 14-tägigen kostenlosen Testphase. Du kannst also eine Recurly-Sandbox verbinden und zusehen, wie aus einer Testrechnung eine Provision wird, bevor du irgendetwas bezahlst.

Häufige Fragen

Gibt es ein eingebautes Recurly-Affiliate-Programm?

Nein. Recurly ist eine Lösung für Abo-Abrechnung und Umsatzverwaltung; Affiliate- oder Empfehlungs-Tracking gehört nicht dazu. Um auf Recurly ein Affiliate-Programm zu betreiben, fügst du eine Tracking-Ebene hinzu, die die Webhooks von Recurly verarbeitet, entweder eine selbst gebaute oder eine Plattform mit nativer Integration.

Kann ich im Starter-Plan von Recurly ein Affiliate-Programm betreiben?

Nur zum Teil. Die Attribution neuer Kunden läuft über ein Custom Field am Abonnement, und Custom Fields brauchen Recurly Pro (bis zu 5) oder Elite (bis zu 10); der Starter-Plan hat sie nicht, neue Empfehlungen können dort also keinem Affiliate zugeordnet werden. Verlängerungen von Kunden, die schon zugeordnet sind, werden in jedem Plan weiter erfasst.

Mit welchen Zahlungsanbietern funktioniert das Affiliate-Tracking mit Recurly?

Mit allen. Recurly sitzt auf deinem Zahlungsanbieter (Stripe, Adyen, Braintree, GoCardless und die übrigen), und seine Webhooks melden jede Zahlung auf dieselbe Weise, egal welcher Zahlungsanbieter die Karte verarbeitet hat. Die Tracking-Ebene hört auf Recurly, an deinem Zahlungsrouting ändert sich also nichts.

Verdienen Affiliates weiter, wenn sich Abos verlängern?

Ja, wenn die Bedingungen deiner Kampagne wiederkehrende Provisionen vorsehen. Jede Verlängerung kommt als weitere bezahlte Belastungsrechnung an und verbucht eine wiederkehrende Provision, so lange, wie deine Bedingungen es festlegen. Genau deshalb bevorzugen erfahrene SaaS-Affiliates Abo-Programme im Stil von Recurly.

Was passiert, wenn eine Webhook-Zustellung fehlschlägt?

Recurly wiederholt sie automatisch, bis zu 10-mal über rund drei Tage, und behält 15 Tage lang an jeder Notification in deiner Konsole einen manuellen Retry-Button. Die Conversion wird bei dem Versuch verbucht, der klappt, und Zustellungen werden dedupliziert, damit Wiederholungen einen Verkauf nie doppelt zählen.

Welche Affiliate-Plattformen unterstützen Recurly?

Weniger als bei Stripe. FirstPromoter und impact.com bieten beide echte serverseitige Recurly-Integrationen, und Rekomi unterstützt Recurly nativ; Rewardful unterstützt Recurly derzeit nicht. Wenn die Antwort einer Plattform zu Recurly „nimm Zapier“ lautet, frag konkret nach, wie Erstattungen und annullierte Zahlungen rückgängig gemacht werden, bevor du dich festlegst.

Fang mit einem 1-Minuten-Check an

Prüf, in welchem Recurly-Plan du bist; das dauert 1 Minute und ist die einzige echte Hürde in diesem ganzen Setup. Wenn du in Pro oder Elite bist (oder bereit bist, zu wechseln), hast du alles, was ein ernsthaftes Affiliate-Programm braucht: Leg das Custom Field rekomi_ref an, hol dir einen Read-Only API Key, füg den Webhook hinzu, und deine erste Testrechnung taucht noch am selben Tag als Provision auf. Die Anleitung zur Einrichtung mit Recurly führt dich mit Snippets zum Kopieren durch jeden Schritt, und dank der 14-tägigen Testphase kostet dich das ganze Experiment nichts.

Betreibe dein Recurly-Affiliate-Programm mit Rekomi

Rekomi verbindet sich über einen Read-Only API Key und einen einzigen Webhook mit Recurly, verbucht jede Verlängerung als wiederkehrende Provision, holt die Provision bei Erstattungen und Voids automatisch zurück und kümmert sich für dich um die Auszahlungen an Affiliates und die Steuerformulare.