Rekomi

​

Einführung

​

So funktioniert es

1. Ein Besucher klickt auf einen Affiliate-Link und gelangt auf Ihre Website, wo das Rekomi-Skript die Empfehlung in seinem Browser speichert.
2. Beim Checkout fügen Sie diese Empfehlung der Zahlung als rekomi_ref metadata hinzu.
3. Dodo Payments verarbeitet die Zahlung und sendet einen signierten payment.succeeded webhook an den von Rekomi erstellten endpoint.
4. Rekomi ordnet die Empfehlung dem Affiliate zu, berechnet die Provision auf den Verkaufspreis vor Steuern und erfasst sie.

​

Voraussetzungen

1. Ein Dodo Payments-Konto im Live-Modus
2. Ein Rekomi-Konto
3. Einen Dodo Payments API key mit aktiviertem write access, da schreibgeschützte keys keine webhooks erstellen können

​

Erste Schritte

1

Create an API Key with Write Access

Aktivieren Sie write access für den key. Ein schreibgeschützter key besteht zwar die Validierung, kann den webhook endpoint jedoch nicht erstellen, sodass die Verbindung途中 scheitert.

Gehen Sie im Dodo Payments-Dashboard zu Developer → API Keys und klicken Sie auf Add API Key. Nennen Sie den key Rekomi und lassen Sie Enable write access aktiviert. Weitere Informationen finden Sie unter Authentication.

2

Paste the Key into Rekomi

Öffnen Sie in Rekomi Setup → Connect payment processor, wählen Sie Dodo Payments aus und fügen Sie den key ein. Rekomi validiert ihn, erstellt den webhook endpoint in Ihrem Konto und ruft das Signaturgeheimnis des endpoint ab.

Nach der Verbindung verwendet Rekomi den key nur zur Verwaltung des webhook endpoint und für regelmäßige Integritätsprüfungen. Ihre Verkäufe gehen über den signierten webhook ein, nicht über die API.

3

Install the Rekomi Script

Fügen Sie das Rekomi-Tracking-Skript zu Ihrer Marketing-Website hinzu, um Affiliate-Klicks zu erfassen. Rekomi zeigt Ihr Snippet mit ausgefüllter Programm-ID unter Setup → Install an.

<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ügen Sie die erfasste Empfehlung jeder Zahlung als rekomi_ref metadata hinzu. Der Implementation Guide zeigt, wie dies für jeden Checkout-Typ funktioniert.

5

Done

Verkäufe, Verlängerungen, Rückerstattungen und Disputes schreiben Affiliate-Provisionen jetzt automatisch gut beziehungsweise holen sie zurück, und Rekomi zahlt Ihre Affiliates aus.

​

Implementierungsleitfaden

​

Checkout Sessions über die API

import DodoPayments from 'dodopayments';

// Reads DODO_PAYMENTS_API_KEY from the environment and defaults to live mode.
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';

// Reads DODO_PAYMENTS_API_KEY from the environment and defaults to live mode.
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 endpoint genau mit den benötigten Events. Bearbeiten Sie die Event-Liste dieses endpoint nicht im Dodo Payments-Dashboard: Rekomis Integritätsprüfungen markieren die Verbindung als fehlerhaft, wenn Events entfernt werden.
• Bei einer kostenlosen Testphase wird bis zu ihrem Ende keine Zahlung erstellt, daher gibt es bis zur ersten Belastung keine Provision. Bei einer kostenpflichtigen Testphase wird der Betrag der Testphase im Voraus berechnet.
• Wenn Sie die Verbindung in Rekomi trennen, wird der webhook endpoint aus Ihrem Dodo Payments-Konto gelöscht.

​

Weitere Ressourcen