Rekomi

​

Introduction

​

Fonctionnement

1. Un visiteur clique sur un lien d’affiliation et arrive sur votre site, où le script Rekomi enregistre la recommandation dans son navigateur.
2. Il accède au checkout, et vous associez cette recommandation au paiement en tant que métadonnées rekomi_ref.
3. Dodo Payments traite le paiement et envoie un webhook payment.succeeded signé à l’endpoint créé par Rekomi.
4. Rekomi associe la recommandation à l’affilié, calcule la commission sur le montant de la vente avant taxes et l’enregistre.

​

Prérequis

1. Un compte Dodo Payments en mode live
2. Un compte Rekomi
3. Une clé API Dodo Payments avec l’accès en écriture activé (les clés en lecture seule ne peuvent pas créer de webhooks)

​

Premiers pas

1

Create an API Key with Write Access

Dans votre tableau de bord Dodo Payments, accédez à Developer → API Keys et créez une clé (nommez-la « Rekomi ») en cochant Enable write access. Consultez le guide des clés API pour obtenir des instructions détaillées.

Activez l’accès en écriture sur la clé : les clés en lecture seule passent la validation, mais ne peuvent pas créer l’endpoint du webhook, ce qui ferait échouer la connexion en cours de route.

2

Paste the Key into Rekomi

Dans Rekomi, ouvrez Setup → Connect payment processor, sélectionnez Dodo Payments et collez la clé. Rekomi la valide en temps réel, crée l’endpoint du webhook dans votre compte et récupère lui-même son signing secret.

Après la connexion, la clé sert uniquement à gérer l’endpoint du webhook et à effectuer des contrôles d’état périodiques. Vos ventes arrivent via le webhook signé, jamais via l’API.

3

Install the Rekomi Script

Ajoutez le script de suivi Rekomi à votre site marketing afin que les clics d’affiliation soient capturés. Votre snippet avec l’ID du programme renseigné se trouve sous Setup → Install dans 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

Associez la recommandation capturée à chaque paiement en tant que métadonnées rekomi_ref. Consultez les exemples d’implémentation ci-dessous.

5

Done!

Les ventes, renouvellements, remboursements et litiges créditent et récupèrent désormais automatiquement les commissions des affiliés, et Rekomi se charge de rémunérer vos affiliés.

​

Guide d’implémentation

​

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

​

Liens de paiement statiques

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

​

Éléments suivis

​

Remarques importantes

• Rekomi enregistre l’endpoint du webhook avec exactement les événements dont il a besoin. Évitez de modifier la liste des événements de cet endpoint dans le tableau de bord Dodo Payments ; les contrôles d’état de Rekomi signaleront la connexion si des événements sont supprimés.
• Aucun paiement n’est effectué pendant les périodes d’essai tant que l’essai n’est pas terminé. Aucune commission n’existe donc avant le premier prélèvement réel.
• La déconnexion dans Rekomi supprime à nouveau l’endpoint du webhook de votre compte Dodo Payments.

​

Ressources supplémentaires