Rekomi

​

Introduzione

​

Come funziona

1. Un visitatore fa clic su un link di affiliazione e arriva sul tuo sito, dove lo script di Rekomi salva il referral nel browser.
2. Il visitatore accede al checkout e tu alleghi quel referral al pagamento come metadati rekomi_ref.
3. Dodo Payments elabora il pagamento e invia un webhook payment.succeeded firmato all’endpoint creato da Rekomi.
4. Rekomi associa il referral all’affiliato, calcola la commissione sull’importo della vendita al lordo delle imposte e la registra.

​

Prerequisiti

1. Un account Dodo Payments in modalità live
2. Un account Rekomi
3. Una chiave API Dodo Payments con accesso in scrittura abilitato (le chiavi di sola lettura non possono creare webhook)

​

Per iniziare

1

Create an API Key with Write Access

Nel dashboard Dodo Payments, vai a Developer → API Keys e crea una chiave (chiamala “Rekomi”) con Enable write access selezionato. Consulta la guida alle chiavi API per istruzioni dettagliate.

Abilita l’accesso in scrittura sulla chiave: le chiavi di sola lettura superano la convalida, ma non possono creare l’endpoint webhook, quindi il collegamento si interromperebbe a metà.

2

Paste the Key into Rekomi

In Rekomi, apri Setup → Connect payment processor, scegli Dodo Payments e incolla la chiave. Rekomi la convalida in tempo reale, crea l’endpoint webhook nel tuo account e recupera direttamente il signing secret.

Dopo il collegamento, la chiave viene utilizzata solo per gestire l’endpoint webhook ed eseguire controlli periodici dello stato. Le vendite arrivano tramite il webhook firmato, mai tramite l’API.

3

Install the Rekomi Script

Aggiungi lo script di monitoraggio di Rekomi al tuo sito di marketing per acquisire i clic degli affiliati. Lo snippet con l’ID del programma compilato si trova in 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

Allega il referral acquisito a ogni pagamento come metadati rekomi_ref. Consulta gli esempi di implementazione riportati di seguito.

5

Done!

Vendite, rinnovi, rimborsi e contestazioni attribuiscono e annullano automaticamente le commissioni degli affiliati, mentre Rekomi si occupa di pagare i tuoi affiliati.

​

Guida all’implementazione

​

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

​

Link di pagamento statici

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

​

Cosa viene monitorato

​

Note importanti

• Rekomi registra l’endpoint webhook esattamente con gli eventi necessari. Evita di modificare l’elenco degli eventi di quell’endpoint nel dashboard Dodo Payments; i controlli dello stato di Rekomi segnaleranno il collegamento se vengono rimossi degli eventi.
• Durante le prove non viene eseguito alcun pagamento fino al termine del periodo di prova, quindi non esiste alcuna commissione fino al primo addebito effettivo.
• La disconnessione in Rekomi elimina nuovamente l’endpoint webhook dal tuo account Dodo Payments.

​

Risorse aggiuntive