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. Lors du checkout, 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 hors 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é, car les clés en lecture seule ne peuvent pas créer de webhooks

​

Premiers pas

1

Create an API Key with Write Access

Activez l’accès en écriture sur la clé. Une clé en lecture seule passe la validation, mais ne peut pas créer l’endpoint webhook ; la connexion échoue donc en cours de route.

Dans le dashboard Dodo Payments, accédez à Developer → API Keys et cliquez sur Add API Key. Nommez la clé Rekomi et laissez Enable write access coché. Pour plus de détails, consultez Authentication.

2

Paste the Key into Rekomi

Dans Rekomi, ouvrez Setup → Connect payment processor, choisissez Dodo Payments et collez la clé. Rekomi la valide, crée l’endpoint webhook dans votre compte et récupère le secret de signature de l’endpoint.

Après la connexion, Rekomi utilise la clé uniquement pour gérer l’endpoint webhook et effectuer des contrôles d’intégrité périodiques. Vos ventes arrivent via le webhook signé, et non via l’API.

3

Install the Rekomi Script

Ajoutez le script de suivi Rekomi à votre site marketing pour enregistrer les clics des affiliés. Rekomi affiche votre extrait de code, avec l’ID du programme renseigné, sous 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

Associez la recommandation enregistrée à chaque paiement en tant que métadonnées rekomi_ref. L’Implementation Guide explique comment procéder pour chaque type de checkout.

5

Done

Les ventes, les renouvellements, les remboursements et les litiges attribuent désormais automatiquement les commissions aux affiliés et les récupèrent si nécessaire, tandis que Rekomi paie vos affiliés.

​

Guide d’implémentation

​

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

​

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 webhook avec exactement les événements dont il a besoin. Ne modifiez pas la liste des événements de cet endpoint dans le dashboard Dodo Payments : les contrôles d’intégrité de Rekomi signalent la connexion si des événements sont supprimés.
• Un essai gratuit ne crée aucun paiement avant sa fin ; aucune commission n’existe donc avant le premier prélèvement. Un essai payant facture le montant de l’essai immédiatement.
• La déconnexion dans Rekomi supprime l’endpoint webhook de votre compte Dodo Payments.

​

Ressources supplémentaires