Rekomi

​

Introduzione

​

Come funziona

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

​

Prerequisiti

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

​

Per iniziare

1

Create an API Key with Write Access

Abilita l’accesso in scrittura sulla chiave. Una chiave di sola lettura supera la convalida, ma non può creare l’endpoint webhook, quindi la connessione non va a buon fine.

Nella dashboard di Dodo Payments, vai su Developer → API Keys e fai clic su Add API Key. Assegna alla chiave il nome Rekomi e lascia selezionata l’opzione Enable write access. Per maggiori dettagli, consulta Authentication.

2

Paste the Key into Rekomi

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

Dopo la connessione, Rekomi usa la chiave solo per gestire l’endpoint webhook ed eseguire controlli periodici dello stato. Le tue vendite arrivano tramite il webhook firmato, non 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. Rekomi mostra il tuo snippet, con l’ID del programma già inserito, nella sezione Setup → Install.

<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

Collega il referral acquisito a ogni pagamento come metadati rekomi_ref. La Implementation Guide mostra come procedere per ogni tipo di checkout.

5

Done

Le vendite, i rinnovi, i rimborsi e le contestazioni ora accreditano e annullano automaticamente le commissioni degli affiliati, e Rekomi paga i tuoi affiliati.

​

Guida all’implementazione

​

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

​

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. Non modificare l’elenco degli eventi di quell’endpoint nella dashboard di Dodo Payments: i controlli dello stato di Rekomi segnalano la connessione se vengono rimossi degli eventi.
• Una prova gratuita non crea alcun pagamento fino al termine della prova, quindi non esiste alcuna commissione fino al primo addebito. Una prova a pagamento addebita anticipatamente l’importo della prova.
• La disconnessione in Rekomi elimina l’endpoint webhook dal tuo account Dodo Payments.

​

Risorse aggiuntive