Ein Dodo-Payments-Affiliate-Programm startest du mit einem einzigen eingefügten API-Schlüssel. Kein OAuth-Hin-und-Her, keine Woche Webhook-Verkabelung: ein Schlüssel mit vollem Zugriff, und die Tracking-Ebene baut den Rest der Integration für dich direkt in deinem Dodo-Payments-Konto auf.
Dieser Leitfaden geht den ganzen Weg durch: wie die Verbindung mit einem einzigen Schlüssel funktioniert und warum ein Nur-Lese-Schlüssel dafür nicht reicht, wie die Empfehlung in den Checkout-Metadaten mitreist und was genau bei Verlängerungen, Erstattungen, Streitfällen und Steuern passiert. Rekomi, die Affiliate-Plattform, die ich betreibe, hat seine native Verbindung zu Dodo Payments Mitte 2026 eingeschaltet. Jede Mechanik unten stammt also direkt aus dem Bau dieser Verbindung und nicht aus dem Changelog von jemand anderem.
Wenn du nur die Schritte willst, findest du sie in der Installationsanleitung, mit Snippets zum Kopieren. Bleib hier, wenn du wissen willst, was mit deinen Zahlungsdaten tatsächlich passiert.
Warum weltweit verkaufende Digitalanbieter so viel von Affiliates haben
Weil Dodo Payments den Teil schon gelöst hat, der internationalen Affiliate-Traffic sonst so beängstigend macht: die Steuer. Dodo Payments ist ein Merchant of Record, also bei jeder Transaktion der rechtliche Verkäufer. Es berechnet, erhebt und führt Mehrwertsteuer und Sales Tax ab, wo auch immer deine Käufer sitzen, und sein Checkout kann Preise in mehr als 80 lokalen Währungen anzeigen. Wenn dir ein Affiliate in Jakarta einen Kunden in Warschau schickt, ändert sich an deinem Compliance-Aufwand nichts.
Die Provisionsseite ist genauso aufgeräumt. Bei Vergütung pro Verkauf schuldest du erst Geld, wenn der Umsatz da ist: Ein Produkt für $39/Monat mit 25% wiederkehrender Provision bringt dem Affiliate $9.75 in jedem Monat, in dem der Kunde bleibt. Ein Affiliate mit 12 aktiven Empfehlungen verdient $117/Monat, die sich von selbst verlängern, und du hast alles aus bereits eingenommenem Umsatz bezahlt. Wiederkehrende Provisionen sind der Grund, warum Software-Affiliates gezielt nach solchen Programmen suchen; die guten bauen sich damit ihren eigenen MRR auf.
Dodo Payments bringt kein eigenes Affiliate-Tracking mit. Was fehlt, ist also die Ebene, die jede Abbuchung beobachtet und das Provisionsbuch sauber hält (mein Leitfaden zu Affiliate-Tracking-Software erklärt ausführlich, was diese Ebene den ganzen Tag tut). Auf Dodo Payments kann sie fast unsichtbar sein.
Das Dodo-Payments-Affiliate-Programm einrichten, mit einem einzigen Schlüssel
Öffne in Dodo Payments Developer > API Keys und erstelle einen Schlüssel mit vollem Zugriff; nenn ihn Rekomi, damit du später noch weißt, wofür er da ist. Füg ihn in deinem Rekomi-Dashboard auf der Einrichtungsseite für Dodo Payments ein und klick auf Verbinden. Das ist die ganze Integration!
Hinter diesem Einfügen prüft Rekomi den Schlüssel live bei Dodo, legt in deinem Konto den Webhook-Endpunkt an, der auf die URL deines Workspaces zeigt und genau die benötigten Ereignisse abonniert, und holt sich das Signing Secret des Endpunkts selbst. Du fügst nichts zurück in Dodo ein und siehst oder berührst das Signing Secret nie. Scheitert eine der beiden Hälften, bleibt nichts zurück: Ein halb angelegter Endpunkt wird wieder gelöscht.
Der Schlüssel braucht vollen Zugriff, und der Grund ist technisch, nicht gierig: Die Nur-Lese-Schlüssel von Dodo bestehen zwar die normale Prüfung, können aber keine Webhooks anlegen, und genau dafür ist der Schlüssel größtenteils da. Verbindest du mit einem Nur-Lese-Schlüssel, scheitert der Ablauf mittendrin, mit einer Fehlermeldung, die genau das sagt. Nach dem Verbinden hat der Schlüssel nur noch zwei Aufgaben: diesen Endpunkt zu verwalten und alle 30 Minuten einen Gesundheitscheck mit reinem Lesezugriff auszuführen. Deine Verkäufe laufen nie über ihn. Sie kommen über den signierten Webhook an und werden nach dem Standard-Webhooks-Schema geprüft (ein HMAC über Zustell-ID, Zeitstempel und Inhalt, mit einem Zeitfenster von 300 Sekunden), bevor irgendetwas erfasst wird.
Zwei Hinweise zur Pflege. Dodo-Schlüssel laufen nicht ab. Meldet der Gesundheitscheck die Verbindung also irgendwann als unterbrochen, hat jemand den Schlüssel widerrufen oder den Endpunkt deaktiviert, und die Lösung ist immer dasselbe einmalige Einfügen. Und Live-Modus und Testmodus sind bei Dodo getrennte Welten (andere Hosts, andere Schlüssel, andere Webhooks), eine Produktivverbindung lehnt Zugangsdaten aus dem Testmodus also ab, bevor irgendetwas gespeichert wird.
So kommt die Empfehlung in einen Checkout, den du nicht selbst hostest
Dodo Payments hostet seinen Checkout auf der eigenen Domain, deshalb muss die Affiliate-Empfehlung vom Browser deines Besuchers in den Zahlungsdatensatz gelangen. Dieser Teil ist Pflicht: Lässt du ihn weg, kommen Verkäufe ohne Empfehlung an, und dann bekommt niemand eine Provision.
Zuerst kommt das Tracking-Skript von Rekomi in den Head deiner Marketing-Website; es erfasst den Affiliate-Klick in einem First-Party-Cookie. Dann reist die Empfehlung in den Checkout-Metadaten mit, auf einem von zwei Wegen, je nachdem, wie du verkaufst.
Wenn du Checkouts über die API von Dodo anlegst, lies die Empfehlung in deinem Frontend mit window.Rekomi.getReferral() aus, gib sie an dein Backend weiter und setze sie in metadata beim Checkout, beim Abonnement oder bei der Zahlungsanfrage:
{
"product_cart": [{ "product_id": "prod_your_product", "quantity": 1 }],
"metadata": { "rekomi_ref": "REFERRAL_FROM_YOUR_FRONTEND" }
}Wenn du über statische Payment Links verkaufst, ergänze den Link um den flachen Parameter mit Unterstrich. Dodo übernimmt Query-Parameter der Form metadata_key=value in die Metadaten der Zahlung, der Parameter lautet also ?metadata_rekomi_ref=, flach geschrieben. Es ist nicht die Form mit eckigen Klammern metadata[rekomi_ref], die du vielleicht von anderen Plattformen kennst; Klammern bewirken hier nichts.
const ref = window.Rekomi?.getReferral?.();
const url = new URL("https://checkout.dodopayments.com/buy/prod_your_product");
if (ref) url.searchParams.set("metadata_rekomi_ref", ref);
// use url.toString() as the href on your Buy buttonDie Metadaten eines Abonnements bleiben über seine gesamte Laufzeit erhalten, und Rekomi greift zusätzlich auf den Attributionsverlauf des Kunden zurück. Die Verlängerung in Monat 14 wird also demselben Affiliate gutgeschrieben wie Monat 1.
Was passiert, sobald Geld fließt
Jede Abbuchung von Dodo kommt als ein einziges Ereignis payment.succeeded an, und dieses eine Ereignis trägt das ganze Programm:
- Erste Abo-Abbuchungen und Einmalkäufe
- Jede Verlängerung, über die gesamte Kundenlaufzeit
- Abbuchungen bei einem Planwechsel, wenn ein Kunde seinen Plan hoch- oder herunterstuft
- Nachgeholte Abbuchungen, wenn ein angehaltenes Abonnement (on hold) wieder aktiv wird
Jede davon wird mit dem Betrag erfasst, der dem Kunden tatsächlich abgebucht wurde, und ob es eine Erstzahlung oder eine Verlängerung ist, ergibt sich daraus, ob das Abonnement schon einmal aufgetaucht ist. So greifen Regeln für wiederkehrende Provisionen beim richtigen Label. Testphasen lösen überhaupt kein Zahlungsereignis aus, eine Provision gibt es also erst ab der ersten echten Abbuchung. Alles wird anhand der zugrunde liegenden IDs von Zahlung, Abonnement, Erstattung und Streitfall dedupliziert, erneute Zustellungen von Dodo werden also nie doppelt gezählt.
Provisionen werden auf den Betrag vor Steuern berechnet, und das ist eine bewusste Entscheidung, kein Versehen. Dodo ist der Merchant of Record, die Mehrwertsteuer oder Sales Tax, die es einzieht, war also nie dein Umsatz, und deine Affiliates sollten daran nichts verdienen. Dodo meldet jede Abbuchung mit ihrem Steueranteil, Rekomi erfasst den Verkauf also abzüglich der Steuerzeile. Rechnen wir es durch: Ein Kunde in Berlin kauft deinen Plan für $29/Monat, zahlt $34.51 mit 19% Mehrwertsteuer, und deine Provision von 20% schreibt $5.80 gut, zwanzig Prozent der $29, die du tatsächlich behältst. Erstattungen und Streitfälle werden inklusive Steuer gemeldet, zurückgeholt wird aber höchstens, was gutgeschrieben wurde: Wenn dieser Kunde in Woche zwei eine Erstattung bekommt, meldet das Ereignis $34.51, und zurückgeholt werden genau $5.80, nie mehr. Der eine ehrliche Grenzfall ist die Teilerstattung: Sie bringt keinen Steueranteil mit und holt ihren gemeldeten Betrag gegen die Gutschrift vor Steuern zurück; etwas konservativ, nie über die ursprüngliche Gutschrift hinaus, und mehrere Teilerstattungen laufen am Ende genau auf das Zurückholen der ganzen Provision hinaus.
Teilerstattungen sind kein Sonderfall, sondern fest eingeplant. Jede holt ihren Anteil an der Provision zurück, mehrere Teilerstattungen holen so lange weiter zurück, bis die ursprüngliche Provision aufgebraucht ist, und darüber hinaus wird nie etwas zurückgeholt. Ein ehrlicher Grenzfall: Dodo meldet gelegentlich eine volle Erstattung ohne Betrag, und Rekomi behandelt das als Erstattung von allem, was von der Conversion noch übrig ist, die sichere Lesart.
Streitfälle holen das strittige Geld zurück, sobald der Streitfall eröffnet wird, nicht erst, wenn er Monate später entschieden ist. Gewinnst du ihn, wird die Provision nicht stillschweigend wiederhergestellt; der Gewinn wird protokolliert, und du entscheidest, ob du erneut gutschreibst. Verlierst du, ändert sich nichts weiter, denn das Geld ist schon geflossen. Ein Vorbehalt in einem Satz: Wenn du hinter dem Checkout von Dodo über dein eigenes Stripe- oder Adyen-Konto abrechnest (Dodo nennt das BYOP), werden Zahlungen normal erfasst, aber Webhooks zu Erstattungen und Streitfällen kommen womöglich nie an, und diese Rückforderungen erledigst du dann von Hand.
Die Frage nach den 80+ Währungen, ehrlich beantwortet
Adaptive Currency von Dodo kann den Checkout in mehr als 80 lokalen Währungen anzeigen, mehr, als die Währungsliste von Rekomi abdeckt. Deshalb hier genau, wie das gehandhabt wird. Eine Zahlung, eine Erstattung oder ein Streitfall in einer Währung, die Rekomi nicht abdeckt (VND oder ein Code mit drei Dezimalstellen wie KWD), wird übersprungen und markiert, nie geraten, damit eine Provision nie auf einen verfälschten Betrag berechnet wird. Verkäufe in USD, EUR, GBP und den übrigen Währungen der Liste werden normal erfasst, und wenn ein nennenswerter Teil deines Umsatzes in einer exotischen Währung ankommt, sag Bescheid; die Liste lässt sich erweitern.
Das Feld: Affonso, Dub und Rekomi
Fairerweise muss ich sagen: Rekomi ist nicht die einzige Affiliate-Plattform, die mit Dodo Payments kann. Affonso und Dub haben beide Integrationen für Dodo Payments, beide sind seriöse Produkte, und mit jedem davon bekommst du ein Programm zum Laufen. Bei ihrer Einrichtung fügst du einen API-Schlüssel ein, legst dann den Webhook von Hand im Dashboard von Dodo an und fügst das Signing Secret zurück ein; das sind ein paar Schritte mehr, und es funktioniert.
Die Unterschiede stecken in der Technik darunter. Nur bei Rekomi wird der Webhook programmatisch angelegt, und das Secret geht nie durch deine Hände. Streitfälle holen die Provision automatisch zurück, sobald sie eröffnet werden (keines der beiden anderen Tools kümmert sich heute um Rückforderungen bei Streitfällen), und Tracking ist nur die Hälfte der Aufgabe von Rekomi. Die andere Hälfte ist, die Affiliates auszuzahlen, denen du jetzt Geld schuldest.
Wo Rekomi ins Spiel kommt: First-Party-Tracking über deine eigene Domain, die Verbindung zu Dodo Payments mit einem einzigen Schlüssel von oben, wiederkehrende Provisionen mit automatischer Rückforderungen und Streitfällen sowie Auszahlungen mit eingebauter Abwicklung der Steuerformulare, über echte Auszahlungswege, mit Freigaben und Betrugsprüfung, bevor Geld fließt. Die Pläne beginnen bei $29/Monat plus pauschal 3% der Auszahlungen an Affiliates, jeder Plan hat eine 14-tägige kostenlose Testphase, und die Seite zur Dodo-Payments-Integration zeigt genau, was die Verbindung erfasst und wie sie abgesichert ist.
Kurze Antworten zum Affiliate-Tracking mit Dodo Payments
Muss ich im Dashboard von Dodo Payments einen Webhook anlegen?
Nein. Rekomi legt den Webhook-Endpunkt über die API von Dodo an und holt sich sein Signing Secret selbst; du siehst den Endpunkt zur Information unter Developer > Webhooks, und beim Trennen wird er wieder gelöscht. Eine Grenze solltest du kennen: Dodo erlaubt höchstens 5 Webhook-Endpunkte pro Konto. Meldet das Verbinden dieses Limit, entfernst du einen ungenutzten Endpunkt und versuchst es noch einmal.
Warum kann ich keinen Nur-Lese-Schlüssel von Dodo Payments verwenden?
Weil Nur-Lese-Schlüssel keine Webhooks anlegen können, und genau darum geht es bei der Einrichtung mit einem einzigen Schlüssel. Ein Nur-Lese-Schlüssel besteht die Prüfung, dann scheitert das Verbinden mit einer Fehlermeldung, die genau das sagt. Nach dem Verbinden verwaltet der Schlüssel mit vollem Zugriff nur den Endpunkt und führt Gesundheitschecks aus; deine Verkäufe kommen über den signierten Webhook an, nicht über den Schlüssel.
Werden Provisionen vor oder nach der Steuer berechnet, die Dodo Payments einzieht?
Vorher. Dodo ist der Merchant of Record, Affiliates verdienen also auf den Verkaufsbetrag vor Steuern, nie auf die Mehrwertsteuer oder Sales Tax, die Dodo einzieht. Erstattungen und Streitfälle werden inklusive Steuer gemeldet, zurückgeholt wird aber höchstens, was gutgeschrieben wurde, eine volle Erstattung holt also genau die Provision zurück. Plane deinen Provisionssatz mit dem Listenpreis.
Bringen Upgrades, Downgrades und nachgeholte Zahlungen Provision?
Ja. Alles, was dem Kunden abgebucht wird, kommt als Zahlungsereignis an und wird mit dem Betrag vor Steuern erfasst, auch Abbuchungen bei einem Planwechsel und nachgeholte Abbuchungen, wenn ein angehaltenes Abonnement wieder aktiv wird. Für Testphasen wird nichts erfasst, bis die erste echte Zahlung kommt.
Können Affiliates über Rabattcodes von Dodo Payments eine Gutschrift bekommen?
Auf diesem Weg noch nicht. Die Attribution läuft über rekomi_ref in den Metadaten; Rabattcodes pro Affiliate funktionieren weiter als normale Rabatte, sie ordnen den Verkauf nur nicht von sich aus zu.
Ein Schlüssel, ein Kauf, eine Erstattung
Am schnellsten vertraust du einer Tracking-Ebene, wenn du zusiehst, wie sie mit echtem Geld umgeht, und mit Dodo Payments ist die Probe günstig. Erstelle unter Developer > API Keys einen Schlüssel mit vollem Zugriff, verbinde ihn nach der Anleitung zur Einrichtung und ergänze einen Payment Link um den flachen Metadaten-Parameter. Kauf dann dein eigenes Produkt über einen Affiliate-Link, sieh zu, wie die Conversion innerhalb einer Minute im Tab Aktivität der Kampagne erscheint, erstatte dir den Kauf und sieh zu, wie die Provision auf den Cent genau zurückgeholt wird. Diese Schleife ist das ganze System im Kleinen, und es macht wirklich Spaß, sie von Anfang bis Ende laufen zu sehen. Die 14-tägige kostenlose Testphase deckt die Software ab, während du testest.
Und falls Dodo Payments nicht der einzige Merchant of Record ist, über den du verkaufst: Dieselbe Anleitung gibt es auch für die anderen, im Leitfaden zum Polar-Affiliate-Programm und im Leitfaden zum Creem-Affiliate-Programm.
