Rekomi

Introduktion

Rekomi är en plattform för affiliatespårning och hantering med en inbyggd Dodo Payments-integration. En affiliate delar en länk och Rekomi registrerar klicket. När besökaren genomför ett köp skickar Dodo Payments försäljningen till Rekomi, som krediterar rätt affiliate. Rekomi beräknar provisionen och betalar dina affiliates åt dig i över 150 länder, inklusive skatteformulär. För att ansluta klistrar du in en Dodo Payments API key med skrivbehörighet i Rekomi. Rekomi validerar nyckeln, skapar webhook-endpointen i ditt Dodo Payments-konto och hämtar endpointens signeringshemlighet. Du behöver inte fylla i något webhook-formulär eller klistra in något tillbaka i Dodo Payments.

Rekomi krediterar en försäljning till en affiliate när en hänvisad kund genomför en engångsbetalning, startar en betald prenumeration eller betalar en förnyelse. Återbetalningar och tvister återtar provisionen automatiskt.

Så fungerar det

Dodo Payments hostar checkout på sin egen domän, så affiliate-hänvisningen följer med i försäljningen som checkout-metadata:

En besökare klickar på en affiliatelänk och kommer till din webbplats, där Rekomi-skriptet sparar hänvisningen i webbläsaren.
I kassan bifogar du hänvisningen till betalningen som rekomi_ref metadata.
Dodo Payments behandlar betalningen och skickar en signerad payment.succeeded webhook till endpointen som Rekomi skapade.
Rekomi kopplar hänvisningen till affiliaten, beräknar provisionen på försäljningsbeloppet före skatt och registrerar den.

Förnyelser av prenumerationer kommer in på samma sätt, så återkommande provisioner kräver inget extra arbete. Återbetalningar och tvister kommer också in via samma endpoint.

Förutsättningar

Innan du konfigurerar den här integrationen behöver du:

Ett Dodo Payments-konto i live-läge
Ett Rekomi-konto
En Dodo Payments API key med write access aktiverad, eftersom skrivskyddade nycklar inte kan skapa webhooks

Kom igång

Create an API Key with Write Access

Aktivera skrivbehörighet för nyckeln. En skrivskyddad nyckel klarar valideringen men kan inte skapa webhook-endpointen, så anslutningen misslyckas halvvägs.

I Dodo Payments-dashboarden går du till Developer → API Keys och klickar på Add API Key. Namnge nyckeln Rekomi och låt Enable write access vara markerat. Mer information finns i Authentication.

Paste the Key into Rekomi

I Rekomi öppnar du Setup → Connect payment processor, väljer Dodo Payments och klistrar in nyckeln. Rekomi validerar den, skapar webhook-endpointen i ditt konto och hämtar endpointens signeringshemlighet.

Rekomis konfigurationssida för Dodo Payments med det enda API key-fältet och anslutningsknappen

Efter anslutningen använder Rekomi nyckeln endast för att hantera webhook-endpointen och köra regelbundna hälsokontroller. Dina försäljningar kommer via den signerade webhooken, inte via API:et.

Install the Rekomi Script

Lägg till Rekomis spårningsskript på din marknadsföringswebbplats för att registrera affiliateklick. Rekomi visar ditt kodavsnitt, med program-ID:t ifyllt, under Setup → Install.

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

Pass the Referral into Checkout

Bifoga den registrerade hänvisningen till varje betalning som rekomi_ref metadata. Implementation Guide visar hur du gör för varje kassotyp.

Done

Försäljningar, förnyelser, återbetalningar och tvister krediterar och återtar nu affiliaternas provisioner automatiskt, och Rekomi betalar dina affiliates.

Implementeringsguide

Checkout Sessions via API:t

I frontend läser du hänvisningen med window.Rekomi.getReferral() och skickar den till din backend med checkout-begäran. I backend anger du den i metadata:

Node.js

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;
}

Samma fält metadata.rekomi_ref fungerar för prenumerationsprodukter, så den första debiteringen och varje förnyelse krediterar samma affiliate.

Payments API

Exemplet nedan använder POST /payments, som är deprecated. Det fungerar fortfarande för befintliga integrationer. Nya integrationer bör använda Checkout Sessions (POST /checkouts), som tar emot metadata på samma sätt.

Node.js

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;
}

Statiska betalningslänkar

Lägg till hänvisningen i länken som en platt metadata_rekomi_ref query parameter, inte i hakparentesformatet:

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

Dodo Payments lägger till metadata_* query parameters i betalningens metadata, där Rekomi läser dem.

Det som spåras

Rekomi hanterar varje typ av försäljningsevenemang enligt följande:

Händelse	Vad händer
Engångsbetalning	Provision krediteras på försäljningsbeloppet före skatt
Förnyelse av prenumeration	Återkommande provision; varje debitering kommer in som en egen betalningshändelse
Återbetalning	Provisionen återtas automatiskt, upp till det krediterade beloppet
Tvist	Provisionen återtas så snart tvisten öppnas

Rekomi beräknar provisioner på försäljningsbeloppet före skatt. Dodo Payments är Merchant of Record och tar ut skatten, så dina affiliates tjänar på själva försäljningen, inte på skatten som köparens land lägger till.

Viktiga anmärkningar

Rekomi registrerar webhook-endpointen med exakt de händelser som behövs. Redigera inte endpointens händelselista i Dodo Payments-dashboarden: Rekomis hälsokontroller markerar anslutningen som felaktig om händelser tas bort.
En kostnadsfri provperiod skapar ingen betalning förrän provperioden avslutas, så ingen provision finns förrän den första debiteringen. En betald provperiod debiterar provbeloppet i förväg.
Om du kopplar från i Rekomi raderas webhook-endpointen från ditt Dodo Payments-konto.

Ytterligare resurser

Rekomi's Dodo Payments Guide

Den fullständiga installationsgenomgången, felsökningsinformationen och säkerhetsdetaljerna i Rekomis dokumentation.

Affiliates Feature Guide

Alla affiliatintegrationsalternativ för Dodo Payments.

Om du behöver hjälp med integrationen kontaktar du Rekomi support på support@rekomi.com eller Dodo Payments support på support@dodopayments.com.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduktion

Så fungerar det

Förutsättningar

Kom igång

Implementeringsguide

Checkout Sessions via API:t

Payments API

Statiska betalningslänkar

Det som spåras

Viktiga anmärkningar

Ytterligare resurser

Rekomi's Dodo Payments Guide

Affiliates Feature Guide

​Introduktion

​Så fungerar det

​Förutsättningar

​Kom igång

​Implementeringsguide

​Checkout Sessions via API:t

​Payments API

​Statiska betalningslänkar

​Det som spåras

​Viktiga anmärkningar

​Ytterligare resurser

Rekomi's Dodo Payments Guide

Affiliates Feature Guide

Introduktion

Så fungerar det

Förutsättningar

Kom igång

Implementeringsguide

Checkout Sessions via API:t

Payments API

Statiska betalningslänkar

Det som spåras

Viktiga anmärkningar

Ytterligare resurser