Affiliate-Tracking mit Dodo Payments: So wird aus einem Klick eine Provision

Affiliate-Tracking mit Dodo Payments läuft auf einen Metadatenschlüssel und ein Webhook-Ereignis hinaus. Du hängst eine Empfehlungs-ID als Metadaten an den Checkout, Dodo trägt sie durch die Zahlung, und ein Webhook payment.succeeded gibt sie deiner Affiliate-Software zurück, mit dem Geld gleich dabei. Alles andere (Verlängerungen, Erstattungen, Streitfälle, Steuern) sind Varianten dieser Schleife, und dieser Artikel geht jede davon mit den echten Ereignisnamen durch.

Damit du weißt, wer hier schreibt: Rekomi ist das, woran ich den ganzen Tag baue, und die Affiliate-Dokumentation von Dodo selbst nennt uns als einen von drei Integrationspartnern, neben Affonso und Dub Partners. Ich bleibe bei der Mechanik ehrlich und nenne die genauen Felder, denn auf einer Merchant-of-Record-Plattform steckt das Geld in den Details.

Die Zusammenfassung in 60 Sekunden:

Die Attribution reist in den Metadaten mit: rekomi_ref bei API-Checkouts oder ?metadata_rekomi_ref=, angehängt an einen statischen Payment Link.

Ein Ereignis trägt das ganze Geld: payment.succeeded löst bei Einmalverkäufen, ersten Abo-Abbuchungen und jeder Verlängerung aus.

Provisionen gelten vor Steuern: Dodo ist der Merchant of Record, Affiliates verdienen also am Verkaufsbetrag, nie an der Mehrwertsteuer, die Dodo einzieht.

So funktioniert Affiliate-Tracking mit Dodo Payments von Haus aus

Dodo baut kein eigenes Tracking-System, ist aber ungewöhnlich offen für die Tools, die das tun. Im Dashboard von Dodo gibt es direkt einen Bereich Affiliates (der mit Affonso läuft), und die Dokumentation beschreibt das Metadaten-Muster, auf dem jedes Tracking-Tool aufbaut. Ehre, wem Ehre gebührt: Dodo hat hier eine bewusste Entscheidung auf Plattformebene getroffen, und zwar eine gute. Metadaten an einem Checkout, einem Abonnement oder einer Zahlung bleiben über die gesamte Lebensdauer des Objekts erhalten, und genau diese Eigenschaft braucht die Attribution.

Wenn du die Tools selbst vergleichen willst, ist das Thema für einen anderen Artikel: Der Vergleich der besten Affiliate-Software für Dodo Payments geht das Feld durch. Hier bleiben wir unter der Haube.

Schritt eins: Der Klick speichert eine Empfehlung

Ein Affiliate-Link ist einfach deine URL mit einem erkennbaren Parameter: yoursite.com?via=maria. Ein Skript im Head deiner Website liest ihn beim Laden der Seite aus, speichert den Slug für 90 Tage im Browser des Besuchers und protokolliert den Klick auf dem Server, mit Referrer und UTM-Tags. Das Skript von Rekomi akzeptiert auch die Parameter, an die andere Plattformen das Internet gewöhnt haben (?ref=, ?fpr=, insgesamt 19). Das ist eine Kleinigkeit, die beim Umzug echten Ärger erspart: Niemand muss seine Links neu verteilen.

Der Klick liegt jetzt als gespeicherte Empfehlung im Browser. Dodo hat er noch nicht erreicht. Diese Übergabe ist Schritt zwei, und es ist der einzige Schritt, in dem echte Technik steckt.

Schritt zwei: Die Empfehlung kommt in die Zahlung

So funktioniert es: Dodo akzeptiert ein Objekt metadata bei Checkouts, Abonnements und einzelnen Zahlungen und übernimmt jeden Query-Parameter metadata_* eines Payment Links in genau dieses Objekt. Damit hast du zwei Wege, einen für jede Art von Verkäufer.

Statische Payment Links (ohne Code): Häng den flachen Parameter mit Unterstrich an, fertig:

https://your-checkout-link?metadata_rekomi_ref=maria

API-Checkouts (auf dem Server): Hol die gespeicherte Empfehlung im Browser mit window.Rekomi.getReferral(), gib sie an deinen Server weiter und nimm sie in den Anfrageinhalt auf:

"metadata": { "rekomi_ref": "maria" }

Hier ein schönes Detail, das typisch für Dodo ist: Weil jeder Query-Parameter metadata_* direkt in die Metadaten übernommen wird, brauchen Payment Links kein Sonderfeld. Bei Polar dagegen geben Checkout-Links nur einen einzigen Parameter reference_id weiter, Tools müssen dort also zusätzlich einen Fallback auslesen. Das Design von Dodo ist einfacher, und eine einfachere Attributionstechnik ist eine, die nicht undicht wird.

Sobald die Metadaten an einem Abonnement hängen, bleiben sie über seine gesamte Laufzeit erhalten. Hinterleg sie bei der Anmeldung, und die Verlängerung in Monat 20 weiß immer noch, wer den Kunden geschickt hat.

Schritt drei: ein Webhook-Ereignis, jeder Dollar

Das ist mein Lieblingsteil am Ereignismodell von Dodo, und der Teil, den du unbedingt verstehen solltest, bevor du einem Tool darauf vertraust. payment.succeeded löst bei jeder Abbuchung aus: bei einem Einmalkauf, der ersten Abo-Zahlung, jeder monatlichen Verlängerung, der sofortigen Abbuchung bei einem Upgrade und sogar bei der nachgeholten Abbuchung, wenn ein Abonnement wieder aus dem Status on hold kommt. Hör auf dieses eine Ereignis, und du hast das ganze Geld gehört.

Die Falle der doppelten Zählung: Dodo sendet außerdem subscription.renewed, und dieses Ereignis löst bei jeder Verlängerung zusätzlich zu payment.succeeded aus. Ein Tool, das für beide Ereignisse Provision gutschreibt, zahlt die Provision doppelt, und ein Tool, das nur auf subscription.renewed hört, liest einen Planbetrag vor Steuern statt dessen, was tatsächlich abgebucht wurde. Wenn du ein Tracking-Tool auf Dodo bewertest, ist das ehrlich gesagt die erste Frage, die ich stellen würde: Welche Ereignisse führen bei dir zu einer Gutschrift, und wie deduplizierst du sie? (Die Antwort von Rekomi: nur payment.succeeded, dedupliziert über die Zahlungs-ID.)

Die Ereignisse im Lebenszyklus eines Abonnements (subscription.active, on_hold, failed, cancelled, expired) bewegen kein Geld. Es gibt sie, damit dir ein Dashboard sagen kann, dass ein vermittelter Kunde gekündigt hat, und das ist für die Erwartungen des Affiliates wichtiger als für das Provisionsbuch.

Erstattungen und Streitfälle: die Schleife der Rückforderung

Eine Provision, die ihre Erstattung überlebt, ist ein Leck in deiner Marge. Dodo schließt diese Schleife mit zwei Ereignisfamilien:

• refund.succeeded macht die Provision pro Erstattung rückgängig. Dodo erlaubt Erstattungen innerhalb von 30 Tagen nach der Transaktion, jede Teilerstattung kommt als eigenes Ereignis mit eigener ID an, und die Rückforderungen laufen so lange weiter, bis die ursprüngliche Provision aufgebraucht ist, nie darüber hinaus.
• dispute.opened holt die Provision sofort zurück. Dodo hält das strittige Geld zurück, sobald eine Rückbuchung eröffnet wird, und die Provision wird im selben Moment rückgängig gemacht. Das ist ein ganz echter Vorteil gegenüber Plattformen, die überhaupt kein Streitfall-Signal haben (Polar zum Beispiel hat keins).

Eine ehrliche Asymmetrie: Wenn du den Streitfall später gewinnst, wird die Provision nicht automatisch wiederhergestellt. Gewonnene Streitfälle sind selten genug, dass das ein vernünftiger Kompromiss ist, aber es ist so, und der Prüfpfad zeigt dir genau, wann es passiert, damit du dem Affiliate die Provision von Hand wieder gutschreiben kannst.

Wer die Gutschrift bekommt, und auf welchen Betrag

Wenn payment.succeeded ankommt, ist die Zuordnung eine kurze Rangfolge: Die Metadaten rekomi_ref gewinnen, wenn sie zu einem freigegebenen Affiliate passen; sonst entscheidet die Historie des Kunden (hat derselbe Dodo-Kunde schon einmal einen zugeordneten Kauf getätigt, bekommt derselbe Affiliate die Gutschrift, und genau das hält Verlängerungen sauber, selbst wenn Metadaten fehlen); sonst wird der Verkauf ohne Zuordnung erfasst und wartet in einer Prüfliste. Deutlich gesagt: Bei Dodo gibt es keinen Fallback über Gutscheincodes. Eine Aktion nach dem Muster „nutz meinen Code“ ohne Klick wird hier nicht zugeordnet, Links sind also der Mechanismus, Punkt.

Jetzt zum Betrag. Dodo ist ein Merchant of Record: Es zieht Sales Tax und Mehrwertsteuer in deinem Namen ein, und die Abbuchung, die der Kunde sieht, enthält sie. Die Berechnung der Provision muss das berücksichtigen. Angenommen, du verkaufst ein Produkt für $49 mit 20% Provision, und ein Kunde in Deutschland zahlt $58.31 mit 19% Mehrwertsteuer obendrauf. Der Affiliate verdient 20% von $49, also $9.80, und nicht 20% von $58.31, womit du bei jedem einzelnen Verkauf nach Deutschland still und leise $1.86 zu viel zahlen würdest. Die Basis vor Steuern ist auf jeder MoR-Plattform zu 100% das richtige Verhalten, und es lohnt sich zu prüfen, ob das Tool deiner Wahl das auch so macht.

Diese $1.86 klingen nach wenig, bis du sie hochrechnest: Bei 500 internationalen Verkäufen im Monat würden Provisionen inklusive Steuer Affiliates rund $900/Monat zu viel zahlen, Marge, die du nie hergeben wolltest. Die Technik dahinter macht sich schnell bezahlt!

Was der Affiliate erlebt

Aus Sicht des Affiliates schrumpft all das auf etwas angenehm Unspektakuläres zusammen: ein Link, ein Dashboard mit Klicks und Conversions und Provisionen, die erscheinen, wenn Zahlungen durchgehen, und kleiner werden, wenn Erstattungen kommen. Bei wiederkehrenden Provisionen glänzen Produkte auf Dodo für Affiliates: Ein Abo für $25/Monat bei 30% bringt pro gehaltenem Kunden jeden Monat $7.50, weil das payment.succeeded jeder Verlängerung dieselben Abo-Metadaten trägt. Wenn aus Guthaben Auszahlungen werden, bewegt Rekomi das Geld selbst und kümmert sich um die Steuerformulare; die Details zum Auszahlungsweg stehen in der Anleitung zur Einrichtung mit Dodo Payments.

Fragen, die wirklich gestellt werden

Hat Dodo Payments ein natives Affiliate-Tracking?

Teilweise. Dodo hat im Dashboard eine Funktion Affiliates, die mit Affonso läuft, und die Dokumentation nennt Affonso, Dub Partners und Rekomi als Integrationspartner. Die Tracking-Mechanik darunter (Metadaten plus Webhooks) ist dieselbe, egal wofür du dich entscheidest.

Gibt es bei Dodo wiederkehrende Provisionen auf Verlängerungen?

Ja. Die Metadaten, die bei der Anmeldung hinterlegt werden, bleiben dauerhaft am Abonnement, und jede Verlängerung löst ihr eigenes payment.succeeded aus. Jede Verlängerung wird also automatisch dem ursprünglichen Affiliate gutgeschrieben.

Wird die Provision vor oder nach Steuern berechnet?

Vor Steuern. Dodo ist der Merchant of Record, und die Steuer, die es einzieht, gehört den Steuerbehörden. Ein sauber gebautes Tool berechnet die Provision deshalb auf den Verkaufsbetrag vor Steuern.

Können Affiliates bei Dodo über Rabattcodes eine Gutschrift bekommen?

Nein. Die Attribution läuft bei Dodo über Link-Klicks, die in den Metadaten mitreisen; die Zahlungsereignisse enthalten kein verlässliches Signal, das einen Code einem Affiliate zuordnet.

Was passiert, wenn ein Kunde eine Rückbuchung veranlasst?

Die Provision wird in dem Moment rückgängig gemacht, in dem dispute.opened ankommt, passend dazu, dass Dodo selbst das Geld sofort zurückhält.

Überzeug dich selbst

Über Attribution zu lesen ist gut; zuzusehen, wie sie eine Zahlung erfasst, ist besser. Die Integration mit Dodo Payments verbindest du mit einem API-Schlüssel (Rekomi legt den Webhook an und holt das Secret selbst), die Anbindung ist also buchstäblich ein einziges Einfügen! Der ehrliche nächste Schritt ist dann ein Durchlauf im Testmodus: Ergänze einen Payment Link um ?metadata_rekomi_ref= und den Slug deines Test-Affiliates, zahl mit einer Testkarte und sieh zu, wie die Conversion vor Steuern und richtig gutgeschrieben ankommt. Wenn das beim ersten Verkauf klappt, klappt es auch beim zehntausendsten.