Kurz gesagt. In Chargebee ist kein Affiliate-Programm eingebaut, also fügst du eins auf einem von drei Wegen hinzu: Du baust selbst einen Empfänger für die Webhooks, schreibst ein Relay zu einer allgemeinen S2S-Tracking-API oder verbindest eine Plattform, die direkt mit Chargebee spricht. Der native Weg dauert 20 Minuten: Site-Namen und einen Read-Only API Key einfügen, einen Webhook anlegen, und Zahlungen, Verlängerungen und Erstattungen werden von selbst erfasst.
Egal, welchen Weg du wählst, die Attribution ist der Teil, der stimmen muss. Chargebee hostet den Checkout auf seiner eigenen Domain, also muss die Empfehlung am Abonnement selbst mitreisen, als meta_data.rekomi_ref oder als Custom Field cf_rekomi_ref. Dieser Leitfaden geht alle drei Wege mit ihren ehrlichen Vor- und Nachteilen durch und zeigt dann die komplette Einrichtung.
Beim Aufbau von Rekomi habe ich Affiliate-Tracking an mehr Abrechnungsplattformen angeschlossen, als ich zählen kann, und ich betreibe Rekomis eigenes Affiliate-Programm darauf. Ein Chargebee-Affiliate-Programm einzurichten ist ein Fall, den ich sehr mag: Chargebee bringt kein Affiliate-Tracking mit, aber dank seiner Webhooks und seines Modells mit Credit Notes ist es eine der saubersten Abrechnungsplattformen, an die sich ein Programm anbinden lässt.
Dieser Leitfaden deckt den ganzen Weg ab: warum Affiliate-Programme so gut zu Unternehmen auf Chargebee passen, die drei Möglichkeiten, eins anzubinden, und eine Anleitung zur Einrichtung, die von Anfang bis Ende etwa 20 Minuten dauert. Wenn du noch Tools aus dem ganzen Markt vergleichst, hilft dir mein Leitfaden zu Affiliate-Tracking-Software weiter. Dieser hier bleibt bei Chargebee.
Warum Marken auf Chargebee Affiliate-Programme starten
Weil eine Abo-Abrechnung aus einer einzigen Empfehlung Monate oder Jahre an Umsatz macht, passt ein Affiliate-Programm besser zu einem Unternehmen auf Chargebee als fast jeder andere bezahlte Kanal. Ein vermittelter Kunde für $79/Monat, der 18 Monate bleibt, bringt $1,422 Umsatz aus einem einzigen Klick auf einen Link, und Provision zahlst du erst, nachdem die jeweilige Zahlung tatsächlich eingegangen ist. Vergleich das mit Anzeigen, bei denen du für den Klick zahlst, ob er konvertiert oder nicht.
Das wiederkehrende Modell zählt auch auf der Seite des Affiliates. Wiederkehrende Provisionen werden für deine Affiliates zu echtem monatlichem Einkommen, und deshalb suchen gute Affiliates gezielt nach Abo-Angeboten. Bei den Programmen, die auf Rekomi laufen, liegen die meisten SaaS-Angebote bei 20 bis 30% Umsatzbeteiligung. Ob du es Affiliate-Programm oder Empfehlungsprogramm nennst, die Mechanik ist dieselbe: den Klick erfassen, das Abonnement zuordnen, auf echten Umsatz auszahlen.
Dazu kommt eine unscheinbare, aber großartige Eigenschaft, die es so nur bei Chargebee gibt: Chargebee setzt auf dem Zahlungsanbieter auf, den du ohnehin schon nutzt. Läuft dein Tracking auf der Ebene von Chargebee, ist dein Programm unabhängig vom Zahlungsanbieter. Ob Stripe, Braintree, PayPal oder was auch immer die Karte abwickelt, dieselben Webhooks melden die Zahlung. An der Abwicklung deiner Zahlungen ändert sich überhaupt nichts.
Die drei Wege zu einem Affiliate-Programm auf Chargebee
Wenn du dich schon durch Verzeichnisse mit Chargebee-Integrationen geklickt hast, um Affiliate-Tools zu finden, ist dir wahrscheinlich aufgefallen, dass die Auswahl lückenhaft ist. Das liegt daran, dass es eigentlich drei Wege gibt, und nur einer davon taucht in einem Verzeichnis auf.
Weg 1: Selbst bauen auf den Webhooks von Chargebee
Die Webhooks von Chargebee liefern dir alles, was du brauchst, in roher Form: payment_succeeded, payment_refunded, die Ereignisse im Lebenszyklus eines Abonnements und credit_note_created. Verarbeite sie, speichere deine eigene Attribution, berechne die Provisionen, und du hast ein Programm mit voller Kontrolle und ohne Anbieter.
Die Nachteile sind allerdings real. Chargebee kann Webhooks nicht signieren, die Zustellungen zu authentifizieren ist also deine Aufgabe. Chargebee wiederholt Zustellungen bis zu zwei Tage lang, deshalb brauchst du eine Deduplizierung über die Ereignis-ID, sonst zählst du Verkäufe doppelt. Teilerstattungen brauchen eine anteilige Rückforderung. Und dabei fehlt noch die Hälfte, die deine Affiliates zu sehen bekommen: Anmeldeseiten, Dashboards, Link-Tracking, Auszahlungen und Steuerformulare. Das ist gut ein Quartal Entwicklungsarbeit für ein gelöstes Problem, und deshalb würde ich diesen Weg nur wählen, wenn dein Programm selbst das Produkt ist.
Weg 2: Ereignisse an eine allgemeine S2S-API weiterleiten
Die meisten Affiliate-Plattformen bieten eine Server-zu-Server-API, technisch kann also jede von ihnen Chargebee erfassen: Du schreibst einen kleinen Relay-Dienst, der auf die Webhooks von Chargebee hört und Conversions weiterleitet. So betreiben Marken Chargebee auf Plattformen ohne native Anbindung, und das funktioniert auch.
Aber das Relay gehört dann dir. Verlängerungen, Erstattungen, Wiederholungen und der Sprung der Attribution vom Browser zum Abonnement sind für immer dein Code. Hier kommt meine einzige feste Meinung in diesem Artikel: Wenn deine Provisionsdaten von einem Relay abhängen, das du an einem Nachmittag geschrieben hast, ist dieses Relay jetzt der empfindlichste Teil deines Programms. Niemand überwacht es, es fällt lautlos aus, und du merkst es erst beim Auszahlen, wenn ein Affiliate fragt, wo seine Conversions geblieben sind.
Weg 3: Eine Plattform mit nativer Chargebee-Anbindung verbinden
Beim nativen Weg pflegt die Plattform die Integration mit Chargebee, und du fügst Zugangsdaten ein, statt Code zu schreiben. Chargebee ist hier recht gut abgedeckt: FirstPromoter, Tolt, PartnerStack und Tapfiliate bringen alle eine Chargebee-Integration mit, und Rekomi ebenfalls. Auffällig fehlt Rewardful, das nur Stripe und Paddle unterstützt. Für diese beiden ist es ein gutes Produkt, für eine Abrechnung über Chargebee kommt es aber einfach nicht infrage.
Für fast jedes Unternehmen auf Chargebee ist das der richtige Weg. Die Integration ist ein gepflegtes Produkt von jemand anderem und kein Nebenprojekt von dir, und der Umgang mit Verlängerungen und Erstattungen, der die Attribution von Abonnements so schwierig macht, ist genau der Teil, den die Plattform schon gelöst hat.
Die Chargebee-Integration von Rekomi ist nativ und in jedem Plan enthalten, ab $29/Monat plus 3% der Auszahlungen an Affiliates, und Auszahlungen und Steuerformulare werden für dich erledigt. Sie hört auf Chargebee statt auf den Zahlungsanbieter darunter und ist damit von Grund auf unabhängig vom Zahlungsanbieter. Erstattungen und Rückbuchungen über Chargeback Management holen die Provision automatisch zurück. Alle Details zu den Plänen findest du auf der Preisseite, und jeder Plan startet mit einer 14-tägigen kostenlosen Testphase.
Die Einrichtung in 20 Minuten, Schritt für Schritt
Hier ist die native Einrichtung im Überblick, mit Rekomi als Beispiel. Die Installationsanleitung für Chargebee enthält jeden Schritt mit Snippets zum Kopieren. Hier siehst du, wie das Ganze aufgebaut ist.
- Hol dir deinen Site-Namen und einen Read-Only API Key. Dein Site-Name ist die Subdomain deiner Chargebee-URL:
acmeaus acme.chargebee.com. Leg den Schlüssel unter Settings > Configure Chargebee > API Keys and Webhooks an und wähl den Typ Read-Only. Er dient dazu, die Verbindung zu prüfen und Gesundheitschecks auszuführen, und ändert nie etwas an deiner Site. - Verbinde Chargebee in Rekomi. Die Einrichtungsseite zeigt dir deine Webhook-URL für deinen Workspace und Zugangsdaten für Basic Authentication, die sie für dich erzeugt. Das Passwort wird genau einmal angezeigt und verschlüsselt gespeichert, also kopier es jetzt. Falls du es verlierst, gibt es den Button „Neu erzeugen“. Gib deinen Site-Namen und den Schlüssel ein, und Rekomi prüft das Paar live an deiner Site.
- Leg den Webhook in Chargebee an. Füg die URL ein, aktivier „Protect webhook URL with basic authentication“ mit diesen Zugangsdaten, stell die API-Version auf V2 (Zustellungen mit V1 werden abgelehnt), setz den Haken bei „Exclude card information“ und wähl die Ereignisse für Zahlungen, Abonnements und Credit Notes aus. Eine Konfiguration mit „All Events“ funktioniert auch.
- Hinterlege die Empfehlung an jedem Checkout. Dieser Schritt ist Pflicht: Chargebee hostet den Checkout, ohne ihn kommen Zahlungen also ohne Empfehlung an, und niemand bekommt eine Gutschrift. Installier das Tracking-Skript auf deiner Marketing-Website und übergib dann
window.Rekomi.getReferral()alsmeta_data.rekomi_refbei Abonnements, die du per API anlegst, oder hinterlege mit einem Snippet zum Kopieren ein Custom Fieldcf_rekomi_refan den URLs der Hosted Pages und am Drop-in-Skript.
Einen Punkt zur Sicherheit will ich ansprechen, weil das die ehrliche Version ist: Chargebee kann Webhooks nicht signieren, es gibt also kein Signing Secret wie bei Stripe. Rekomi erzeugt stattdessen Zugangsdaten für Basic Authentication und authentifiziert jede Zustellung damit, bevor irgendetwas verarbeitet wird, zusätzlich zu einer nicht erratbaren URL pro Workspace. Ich sage das lieber offen, als so zu tun, als gäbe es eine Signatur.
Probe alles, bevor du live gehst. Die Test-Sites von Chargebee (die mit der Endung -test) haben eigene Schlüssel und Webhooks. Verbinde eine davon mit einem Sandbox-Workspace, zahl mit einer Testkarte, und die Conversion erscheint innerhalb einer Minute im Bereich „Aktivität“ der Kampagne. Spul dann mit der Time Machine von Chargebee einen Abrechnungszeitraum vor und sieh zu, wie die Verlängerung demselben Affiliate gutgeschrieben wird. Die ganze Probe dauert zehn Minuten und nimmt dem Starttag jede Überraschung!
Was das Affiliate-Tracking mit Chargebee automatisch erfasst
Sobald die Verbindung steht, erledigen die Ereignisse die ganze Arbeit. Das wird alles erfasst:
- Zahlungen. Die erste erfolgreiche Zahlung eines Abonnements bucht die erste Conversion, und einmalige Zahlungen buchen einmalige Conversions, beides über
payment_succeeded. - Verlängerungen. Jede erfolgreiche Verlängerungszahlung erfasst eine wiederkehrende Conversion, sodass Provisionen aus der Umsatzbeteiligung über die ganze Laufzeit des Abonnements weiter anfallen.
- Anmeldungen.
subscription_createdwird als Ereignis mit Betrag 0 erfasst und verknüpft den Kunden mit dem Affiliate, bevor überhaupt Geld fließt. - Erstattungen. Ob voll oder teilweise, sie holen die Provision anteilig zurück, sobald
payment_refundedauslöst, im selben Prüfpfad wie die ursprüngliche Conversion. - Rückbuchungen. Streitfälle, die du über die Funktion Chargeback Management von Chargebee abwickelst, kommen als Erstattungen und Credit Notes an und holen die Provision genauso zurück.
Jetzt zum spannenden Teil, den Zahlen. Angenommen, ein vermittelter Kunde zahlt $79/Monat und dein Angebot ist 25% Umsatzbeteiligung. Der Affiliate verdient $19.75, wenn die erste Zahlung eingeht, und dann wieder $19.75 bei jeder Verlängerung, ohne dass du oder er etwas tun müsst. Im vierten Monat erstattest du 40% einer Rechnung, also $31.60 an den Kunden zurück. payment_refunded löst aus, und $7.90 der Provision dieses Monats werden automatisch zurückgefordert. Dein Provisionsbuch bleibt korrekt, ohne dass jemand in Tabellen herumoperieren muss.
Ich baue den ganzen Tag an der Technik für Auszahlungen und Rückforderungen, und das Modell mit Credit Notes von Chargebee gehört wirklich zu den saubersten, an die sich ein Tool anbinden lässt: Jede Erstattung in Geld ist eine erstattungsfähige Credit Note, die anteilige Rückforderung ergibt sich also ganz von selbst. Eine ehrliche Einschränkung: Streitfälle, die du direkt bei deinem Zahlungsanbieter klärst, außerhalb von Chargeback Management, erzeugen nie Ereignisse in Chargebee, also kann kein Tracking-Tool sie sehen. Korrigiere sie von Hand, wenn einer davon für eine Auszahlung wichtig ist.
FAQ zum Chargebee-Affiliate-Programm
Hat Chargebee ein eingebautes Affiliate-Programm?
Nein. Chargebee ist eine Abo-Abrechnung, die auf deinem Zahlungsanbieter aufsetzt, und bringt, anders als zum Beispiel Lemon Squeezy, kein Affiliate-Tracking mit. Du fügst ein Programm über einen der drei Wege oben hinzu: selbst auf den Webhooks bauen, an eine allgemeine S2S-API weiterleiten oder eine Plattform mit nativer Chargebee-Anbindung verbinden.
Welche Affiliate-Software unterstützt Chargebee nativ?
Rekomi, FirstPromoter, Tolt, PartnerStack und Tapfiliate bringen alle eine native Chargebee-Integration mit. Rewardful nicht, es unterstützt nur Stripe und Paddle. Wenn eine Plattform nicht auf dieser Liste steht, kann sie Chargebee meist trotzdem über ihre Server-zu-Server-API erfassen, aber dann schreibst und pflegst du das Relay selbst.
Werden Provisionen bei Verlängerungen erfasst?
Ja. Jede erfolgreiche Verlängerungszahlung erfasst eine wiederkehrende Conversion, und die Empfehlung, die bei der Anmeldung gesetzt wurde, bleibt am Abonnement. So verdient derselbe Affiliate über die ganze Kundenlaufzeit weiter. Zusätzlich gibt es einen Fallback auf den Conversion-Verlauf des Kunden, damit Verlängerungen auch in Sonderfällen richtig gutgeschrieben werden.
Was passiert mit Provisionen, wenn ein Kunde eine Erstattung bekommt?
Sie werden automatisch und anteilig zurückgefordert. Eine Erstattung von 40% holt 40% der Provision zurück, eine volle Erstattung die ganze Provision. Rückbuchungen über die Funktion Chargeback Management von Chargebee laufen durch dieselbe Leitung und holen die Provision ebenfalls zurück, alles im selben Prüfpfad wie die ursprüngliche Conversion.
Spielt der Zahlungsanbieter unter Chargebee eine Rolle?
Nein. Das Tracking hört auf Chargebee, die maßgebliche Quelle für die Abrechnung, nicht auf den Zahlungsanbieter darunter. Stripe, Braintree, PayPal oder was auch immer Chargebee sonst unterstützt: Dieselben Webhooks melden jede Zahlung, und an der Abwicklung deiner Zahlungen ändert sich nichts.
Kann ich ein Chargebee-Affiliate-Programm testen, bevor ich live gehe?
Auf jeden Fall. Die Test-Sites von Chargebee sind komplett getrennt, mit eigenen API-Schlüsseln und Webhooks, und mit dem Chargebee Test Gateway zahlst du mit Testkarten. Verbinde die Test-Site, führ einen Checkout mit angehängter Empfehlung durch, spul mit der Time Machine einen Abrechnungszeitraum vor, erstatte dann die Rechnung und sieh zu, wie die Provision zurückgefordert wird. Wenn alles passt, wiederholst du die Verbindung auf deiner Live-Site.
Richte es noch heute Nachmittag ein
Dein Plan für die nächsten 15 Minuten: Melde dich bei Chargebee an, leg auf deiner Test-Site einen Read-Only API Key an und öffne die Installationsanleitung für Chargebee daneben. Bis dein Kaffee fertig ist, steht eine Test-Conversion im Dashboard, und live zu gehen sind dieselben vier Schritte auf deiner Produktiv-Site.
Wenn du zuerst Plattformen vergleichen willst, zeigt dir die Seite zur Chargebee-Integration genau, was Rekomi erfasst und wie es abgesichert ist. Jeder Plan kommt mit einer 14-tägigen kostenlosen Testphase, die ganze Probe kostet dich also nichts.
