Rekomi

​

Introduction

​

How It Works

1. A visitor clicks an affiliate link and lands on your site, where the Rekomi script stores the referral in their browser.
2. They go to checkout, and you attach that referral to the payment as rekomi_ref metadata.
3. Dodo Payments processes the payment and delivers a signed payment.succeeded webhook to the endpoint Rekomi created.
4. Rekomi matches the referral to the affiliate, calculates the commission on the pre-tax sale amount, and records it.

​

Prerequisites

1. A Dodo Payments account in live mode
2. A Rekomi account
3. A Dodo Payments API key with write access enabled (read-only keys cannot create webhooks)

​

Getting Started

1

Create an API Key with Write Access

In your Dodo Payments dashboard, go to Developer → API Keys and create a key (name it “Rekomi”) with Enable write access checked. See the API key guide for detailed instructions.

Enable write access on the key: read-only keys pass validation but cannot create the webhook endpoint, so the connection would fail partway.

2

Paste the Key into Rekomi

In Rekomi, open Setup → Connect payment processor, choose Dodo Payments, and paste the key. Rekomi validates it live, creates the webhook endpoint in your account, and fetches its signing secret itself.

After connecting, the key is only used to manage the webhook endpoint and run periodic health checks. Your sales arrive through the signed webhook, never through the API.

3

Install the Rekomi Script

Add the Rekomi tracking script to your marketing site so affiliate clicks are captured. Your snippet with the program ID filled in is under Setup → Install in 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

Attach the captured referral to each payment as rekomi_ref metadata. See the implementation examples below.

5

Done!

Sales, renewals, refunds, and disputes now credit and claw back affiliate commissions automatically, and Rekomi handles paying your affiliates.

​

Implementation Guide

​

Checkout Sessions via the 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;
}

​

Static 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

​

What Gets Tracked

​

Important Notes

• Rekomi registers the webhook endpoint with exactly the events it needs. Avoid editing that endpoint’s event list in the Dodo Payments dashboard; Rekomi’s health checks will flag the connection if events are removed.
• Trials fire no payment until the trial ends, so no commission exists until the first real charge.
• Disconnecting in Rekomi deletes the webhook endpoint from your Dodo Payments account again.

​

Additional Resources