Rekomi

​

Introduktion

​

Så fungerar det

1. En besökare klickar på en affiliatelänk och kommer till din webbplats, där Rekomi-skriptet lagrar hänvisningen i webbläsaren.
2. Besökaren går till checkout, och du bifogar hänvisningen till betalningen som rekomi_ref metadata.
3. Dodo Payments behandlar betalningen och levererar en signerad payment.succeeded webhook till den endpoint som Rekomi skapade.
4. Rekomi kopplar hänvisningen till affiliaten, beräknar provisionen på försäljningsbeloppet före skatt och registrerar den.

​

Förutsättningar

1. Ett Dodo Payments-konto i live mode
2. Ett Rekomi-konto
3. En Dodo Payments API key med write access aktiverad (read-only keys kan inte skapa webhooks)

​

Kom igång

1

Create an API Key with Write Access

I din Dodo Payments-dashboard går du till Developer → API Keys och skapar en nyckel (döp den till “Rekomi”) med Enable write access markerat. Se guiden för API keys för detaljerade instruktioner.

Aktivera write access för nyckeln: read-only keys klarar valideringen men kan inte skapa webhook endpoint, så anslutningen skulle misslyckas halvvägs.

2

Paste the Key into Rekomi

I Rekomi öppnar du Setup → Connect payment processor, väljer Dodo Payments och klistrar in nyckeln. Rekomi validerar den direkt, skapar webhook endpoint i ditt konto och hämtar själv dess signing secret.

Efter anslutningen används nyckeln endast för att hantera webhook endpoint och köra regelbundna hälsokontroller. Din försäljning kommer via den signerade webhooken, aldrig via API:t.

3

Install the Rekomi Script

Lägg till Rekomis tracking script på din marknadsföringswebbplats så att affiliate-klick registreras. Ditt kodavsnitt med program-ID:t ifyllt finns under Setup → Install i Rekomi.

<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

Bifoga den registrerade hänvisningen till varje betalning som rekomi_ref metadata. Se implementeringsexemplen nedan.

5

Done!

Försäljningar, förnyelser, återbetalningar och tvister krediterar och återför nu affiliateprovisioner automatiskt, och Rekomi hanterar utbetalningarna till dina affiliates.

​

Implementeringsguide

​

Checkout Sessions via API:t

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

​

Statiska betalningslänkar

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

​

Det som spåras

​

Viktiga anmärkningar

• Rekomi registrerar webhook endpoint med exakt de händelser som behövs. Undvik att redigera händelselistan för denna endpoint i Dodo Payments-dashboarden; Rekomis hälsokontroller markerar anslutningen som felaktig om händelser tas bort.
• Provperioder utlöser ingen betalning förrän provperioden är slut, så ingen provision finns förrän den första riktiga debiteringen.
• Om du kopplar från i Rekomi raderas webhook endpoint från ditt Dodo Payments-konto igen.

​

Ytterligare resurser