Rekomi

​

Einführung

​

So funktioniert es

1. Ein Besucher klickt auf einen Affiliate-Link und gelangt auf deine Website, wo das Rekomi-Skript die Empfehlung in seinem Browser speichert.
2. Die Person geht zum Checkout, und du fügst diese Empfehlung als rekomi_ref-Metadaten an die Zahlung an.
3. Dodo Payments verarbeitet die Zahlung und übermittelt einen signierten payment.succeeded-Webhook an den von Rekomi erstellten Endpunkt.
4. Rekomi ordnet die Empfehlung dem Affiliate zu, berechnet die Provision auf Grundlage des Umsatzes vor Steuern und erfasst sie.

​

Voraussetzungen

1. Ein Dodo Payments-Konto im Live-Modus
2. Ein Rekomi-Konto
3. Einen Dodo Payments API-Schlüssel mit aktivierter Schreibberechtigung (Schlüssel mit Leseberechtigung können keine Webhooks erstellen)

​

Erste Schritte

1

Create an API Key with Write Access

Gehe in deinem Dodo Payments-Dashboard zu Developer → API Keys und erstelle einen Schlüssel (nenne ihn „Rekomi“), bei dem Enable write access aktiviert ist. Ausführliche Anweisungen findest du im Leitfaden zu API-Schlüsseln.

Aktiviere die Schreibberechtigung für den Schlüssel: Schlüssel mit Leseberechtigung bestehen zwar die Validierung, können aber den Webhook-Endpunkt nicht erstellen, sodass die Verbindung mittendrin fehlschlagen würde.

2

Paste the Key into Rekomi

Öffne in Rekomi Setup → Connect payment processor, wähle Dodo Payments aus und füge den Schlüssel ein. Rekomi validiert ihn live, erstellt den Webhook-Endpunkt in deinem Konto und ruft dessen Signing Secret selbst ab.

Nach der Verbindung wird der Schlüssel nur zur Verwaltung des Webhook-Endpunkts und für regelmäßige Zustandsprüfungen verwendet. Deine Verkäufe werden über den signierten Webhook übermittelt, niemals über die API.

3

Install the Rekomi Script

Füge deiner Marketing-Website das Rekomi-Tracking-Skript hinzu, damit Affiliate-Klicks erfasst werden. Dein Snippet mit eingetragener Programm-ID findest du in Rekomi unter Setup → Install.

<script
  async
  src="https://api.rekomi.com/api/v1/r/loader.js"
  data-program-id="YOUR_PROGRAM_ID"
></script>

4

Pass the Referral into Checkout

Füge die erfasste Empfehlung jeder Zahlung als rekomi_ref-Metadaten hinzu. Siehe die Implementierungsbeispiele weiter unten.

5

Done!

Verkäufe, Verlängerungen, Rückerstattungen und Disputes schreiben Affiliate-Provisionen jetzt automatisch gut beziehungsweise ab, und Rekomi übernimmt die Auszahlung an deine Affiliates.

​

Implementierungsleitfaden

​

Checkout Sessions über die API

import DodoPayments from 'dodopayments';

const client = new DodoPayments();

export async function createCheckout(productId: string, rekomiRef?: string) {
  const session = await client.checkoutSessions.create({
    product_cart: [{ product_id: productId, quantity: 1 }],
    customer: {
      email: 'customer@example.com',
      name: 'John Doe',
    },
    return_url: 'https://yoursite.com/success',
    metadata: {
      ...(rekomiRef ? { rekomi_ref: rekomiRef } : {}),
    },
  });

  return session.checkout_url;
}

​

Payments API

import DodoPayments from 'dodopayments';

const client = new DodoPayments();

export async function createPayment(productId: string, rekomiRef?: string) {
  const payment = await client.payments.create({
    billing: {
      city: 'New York',
      country: 'US',
      state: 'NY',
      street: '123 Main St',
      zipcode: '10001',
    },
    customer: {
      email: 'customer@example.com',
      name: 'John Doe',
    },
    product_cart: [{ product_id: productId, quantity: 1 }],
    payment_link: true,
    metadata: {
      ...(rekomiRef ? { rekomi_ref: rekomiRef } : {}),
    },
  });

  return payment;
}

​

Statische Payment Links

const ref = window.Rekomi?.getReferral?.();
let url = 'https://checkout.dodopayments.com/buy/YOUR_PRODUCT_ID';
if (ref) url += `?metadata_rekomi_ref=${encodeURIComponent(ref)}`;
// use url as the href on your Buy button

​

Was erfasst wird

​

Wichtige Hinweise

• Rekomi registriert den Webhook-Endpunkt mit genau den benötigten Events. Vermeide es, die Event-Liste dieses Endpunkts im Dodo Payments-Dashboard zu bearbeiten. Die Zustandsprüfungen von Rekomi markieren die Verbindung als fehlerhaft, wenn Events entfernt werden.
• Während eines Trials wird keine Zahlung ausgelöst, bevor der Trial endet. Daher entsteht keine Provision, bevor die erste tatsächliche Belastung erfolgt.
• Durch das Trennen der Verbindung in Rekomi wird der Webhook-Endpunkt wieder aus deinem Dodo Payments-Konto gelöscht.

​

Weitere Ressourcen