Rekomi

​

Introducción

​

Cómo funciona

1. Un visitante hace clic en un enlace de afiliado y llega a tu sitio, donde el script de Rekomi guarda la referencia en su navegador.
2. Va al checkout y adjuntas esa referencia al pago como metadata rekomi_ref.
3. Dodo Payments procesa el pago y envía un webhook payment.succeeded firmado al endpoint que Rekomi creó.
4. Rekomi vincula la referencia con el afiliado, calcula la comisión sobre el importe de la venta antes de impuestos y la registra.

​

Requisitos previos

1. Una cuenta de Dodo Payments en modo live
2. Una cuenta de Rekomi
3. Una clave de API de Dodo Payments con acceso de escritura habilitado (las claves de solo lectura no pueden crear webhooks)

​

Primeros pasos

1

Create an API Key with Write Access

En tu dashboard de Dodo Payments, ve a Developer → API Keys y crea una clave (llámala “Rekomi”) con Enable write access marcado. Consulta la guía de claves de API para obtener instrucciones detalladas.

Habilita el acceso de escritura en la clave: las claves de solo lectura superan la validación, pero no pueden crear el endpoint de webhook, por lo que la conexión fallaría a mitad del proceso.

2

Paste the Key into Rekomi

En Rekomi, abre Setup → Connect payment processor, elige Dodo Payments y pega la clave. Rekomi la valida en tiempo real, crea el endpoint de webhook en tu cuenta y obtiene su signing secret directamente.

Después de conectarla, la clave solo se utiliza para gestionar el endpoint de webhook y ejecutar comprobaciones de estado periódicas. Tus ventas llegan a través del webhook firmado, nunca mediante la API.

3

Install the Rekomi Script

Añade el script de seguimiento de Rekomi a tu sitio de marketing para capturar los clics de los afiliados. Tu fragmento con el ID del programa completado se encuentra en Setup → Install, dentro de 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

Adjunta la referencia capturada a cada pago como metadata rekomi_ref. Consulta los ejemplos de implementación a continuación.

5

Done!

Las ventas, renovaciones, reembolsos y disputas ahora atribuyen y revierten las comisiones de afiliados automáticamente, y Rekomi se encarga de pagar a tus afiliados.

​

Guía de implementación

​

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

​

Enlaces de pago estáticos

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

​

Qué se registra

​

Notas importantes

• Rekomi registra el endpoint de webhook exactamente con los eventos que necesita. Evita editar la lista de eventos de ese endpoint en el dashboard de Dodo Payments; las comprobaciones de estado de Rekomi marcarán la conexión si se eliminan eventos.
• Las pruebas no generan ningún pago hasta que finaliza el periodo de prueba, por lo que no existe ninguna comisión hasta el primer cargo real.
• Al desconectar en Rekomi, el endpoint de webhook vuelve a eliminarse de tu cuenta de Dodo Payments.

​

Recursos adicionales