Documentación de Rekomi
Para marcasInstalar el seguimiento
Marcas

Instalar en Creem

Conecta Creem de forma nativa: añade un webhook en el panel de Creem con todos los eventos seleccionados, pega el secreto de firma y una clave de API en Rekomi, y las ventas, las renovaciones de suscripción, los reembolsos y los contracargos se registran automáticamente. Lleva rekomi_ref en los metadatos del checkout para que cada venta acredite al afiliado correcto.

Logo de Creem

Creem es un Merchant of Record para SaaS y productos digitales, y Rekomi lo admite de forma nativa. Añades un webhook en el panel de Creem apuntando a tu URL de Rekomi por espacio de trabajo, y después pegas el secreto de firma del webhook y una clave de API en Rekomi. A partir de ahí, las ventas, las renovaciones de suscripción, los reembolsos y los contracargos llegan a Rekomi sin ningún código de reenvío que escribir ni mantener. ¿Todavía lo estás valorando? Consulta Por qué Rekomi para Creem →.

Algo que conviene saber desde el principio: la clave de API que pegas se usa solo para validar la conexión y hacer una comprobación de estado periódica de solo lectura. Nunca lee tus ventas; esas llegan a través del webhook firmado. A Rekomi le basta una clave mínima con permiso de lectura de Products, así que nunca entregas una clave que pueda tocar tu dinero.

Qué necesitas

  • Una tienda de Creem en modo producción. El webhook y la clave de API salen los dos de tu panel de producción (no del Test Mode; el entorno de pruebas de Creem es un universo aparte con sus propias claves creem_test_, y Rekomi rechaza las credenciales de prueba en una conexión de producción con un error específico antes de guardar nada).
  • Una clave de API con permiso de lectura de Products. En Creem, abre Developers > API Keys y crea una clave. Con la lectura de Products basta: la validación y la comprobación de estado de Rekomi son una sola llamada barata de solo lectura. Ten en cuenta que Creem responde con el mismo 403 para una clave inválida o revocada que para una clave sin ese permiso, así que si el error al conectar menciona la lectura de Products y tu clave parece bien configurada, crea una clave nueva y vuelve a intentarlo.
  • Cinco minutos. No hay que pasar por OAuth ni escribir código; todo el flujo consiste en pegar dos valores.

Conectar en Rekomi

Paso 1. Ve a /dashboard/setup/creem. La página muestra tu URL de webhook por espacio de trabajo.

La página Conectar Creem en Rekomi con la URL de webhook por espacio de trabajo y los campos de secreto de firma y clave de API

Paso 2. En tu panel de Creem, abre Developers > Webhooks y haz clic en Add Webhook. Ponle nombre (por ejemplo "Rekomi"), pega la URL del paso 1 y selecciona todos los eventos. Esto importa: el formulario de webhook de Creem tiene un selector de eventos, y Rekomi confirma e ignora los tipos de evento que no usa, pero una selección parcial descarta ventas en silencio sin ningún error en ningún sitio; el único síntoma sería que los eventos dejan de llegar. Selecciónalo todo.

Paso 3. Copia el secreto de firma del webhook de la página Developers > Webhook de Creem y pégalo en Rekomi exactamente como aparece, prefijo incluido.

Paso 4. Pega tu clave de API y haz clic en Conectar Creem. Rekomi valida la clave en vivo contra Creem antes de aceptarla; una clave de Test Mode recibe su propio error específico, mientras que una clave inválida, revocada o con permisos insuficientes recibe un único mensaje que nombra las tres causas, porque Creem responde con el mismo 403 para cada una.

Atribución: lleva rekomi_ref en los metadatos del checkout (obligatorio)

Creem aloja su checkout en su propio dominio, así que la referencia del afiliado tiene que viajar desde el navegador del visitante hasta el registro del checkout. Este paso es obligatorio para la atribución por enlace de clientes nuevos: sin él, una venta por enlace llega sin referencia y no se acredita ninguna comisión (dos cosas se siguen acreditando por sí solas: un código de cupón de afiliado canjeado, ver los detalles más abajo, y un correo de comprador que coincide con un lead capturado en tu sitio, ver el respaldo al final de esta sección).

Primero, asegúrate de que el script de seguimiento de Rekomi está instalado en tu sitio de marketing, para que el clic del afiliado se capture y window.Rekomi.getReferral() devuelva un valor cuando un visitante llega desde un enlace de afiliado. Es el mismo script que usa cualquier instalación de Rekomi; la receta de tu plataforma en el centro de instalación lo cubre. No hay ningún script específico de Creem que añadir: la conexión nativa que configuraste arriba es lo que registra la venta. Después elige la receta que corresponde a cómo vendes:

Creando sesiones de checkout con la API de Creem. Lee la referencia en tu frontend con window.Rekomi.getReferral(), envíala a tu backend con la solicitud de checkout y ponla en metadata al crear la sesión de checkout:

{
  "product_id": "prod_your_product",
  "metadata": { "rekomi_ref": "REFERRAL_FROM_YOUR_FRONTEND" }
}

Enlaces de pago. Añade al enlace el parámetro de metadatos con corchetes; Creem copia los metadatos del enlace en el checkout:

const ref = window.Rekomi?.getReferral?.();
const url = new URL("https://www.creem.io/payment/prod_your_product");
if (ref) url.searchParams.set("metadata[rekomi_ref]", ref);
// use url.toString() as the href on your Buy button

Nota: el campo es rekomi_ref, no creem_ref (Creem reserva creem_ref para su propia función de afiliados).

Coincidencia por correo del lead (respaldo). Cuando un checkout llega a Rekomi sin rekomi_ref en sus metadatos y sin código de cupón de afiliado, y el evento lleva el correo del cliente, Rekomi también compara ese correo con los leads que el script de Rekomi capturó en tu propio sitio en los últimos 90 días (la etiqueta que Rekomi te da lleva data-rkmi-email-capture="auto", que registra como lead el correo escrito en tu formulario de alta; consulta seguimiento de leads) y acredita al afiliado que trajo ese lead. Un código de cupón o una referencia en los metadatos siempre gana cuando está presente, igual que el historial previo del cliente, y un afiliado que compra con su propio correo no se acredita.

Cómo se registran las ventas y las renovaciones

  • Las ventas únicas se registran cuando Creem informa del checkout completado, por el importe del pedido.
  • Las suscripciones registran el primer cobro como conversión inicial (como una venta única) y cada renovación como conversión recurrente, por el importe de la transacción cobrada. Los metadatos del checkout se conservan en la suscripción, así que las renovaciones acreditan al mismo afiliado sin trabajo extra; si alguna renovación llega sin ellos, Rekomi recurre al historial de atribución del cliente.
  • Las pruebas gratuitas empiezan con un evento de ciclo de vida de la suscripción y sin dinero; no existe comisión hasta el primer cobro real. Las cancelaciones llegan como señales de baja para las reglas de comisión que tienen en cuenta la baja.
  • Las comisiones se calculan sobre el importe de la venta antes de impuestos, en los dos modos fiscales de Creem. Creem es un Merchant of Record, así que recauda el impuesto; tus afiliados ganan sobre la venta, no sobre el impuesto. Funciona sea cual sea la forma en que fijas los precios: con precios sin impuestos incluidos, el impuesto se suma a tu precio, y con precios con impuestos incluidos, tu precio de lista ya contiene el impuesto. Rekomi obtiene el neto a partir de lo que el cliente pagó realmente menos la línea de impuestos, así que un producto con el impuesto incluido no paga comisión sobre su IVA.
  • Todo se deduplica por los IDs subyacentes de pedido, transacción, reembolso y disputa, así que los reenvíos de Creem y los reenvíos manuales nunca se cuentan dos veces.

Reembolsos y contracargos

Los reembolsos revierten la comisión automáticamente y de forma proporcional sobre la parte antes de impuestos: un reembolso del 50% recupera el 50% de la comisión, y varios reembolsos parciales siguen recuperando hasta agotar la comisión original, nunca más allá. Esto incluye los reembolsos prorrateados por bajada de plan: cuando un cliente baja de plan a mitad de ciclo y Creem reembolsa la parte no usada, la comisión se recupera también a prorrata, que es el comportamiento buscado (el afiliado gana sobre lo que el cliente pagó realmente).

Las disputas (contracargos) siempre recuperan el dinero en disputa. Creem suele procesar un reembolso completo en tu nombre cuando llega un contracargo, lo que puede producir un evento de reembolso y un evento de disputa por el mismo dinero; la recuperación de Rekomi tiene como tope la comisión original, así que la doble señal nunca recupera dos veces.

Monedas

Creem cobra actualmente en USD y EUR (su lista de monedas la amplía Creem, no es un límite de Rekomi). Rekomi registra las conversiones en la moneda que informa Creem; con más de 135 monedas admitidas, cualquier moneda que Creem añada está casi con seguridad cubierta ya. En el raro caso de que un importe llegue en una moneda fuera de la lista permitida, ese evento se omite y se marca en lugar de adivinar, para que una comisión nunca se calcule sobre un importe corrupto.

Seguridad

  • Cada entrega de webhook pasa la verificación de firma antes de procesar nada. Creem firma las entregas de dos formas, una cabecera HMAC heredada y el esquema standard-webhooks, y Rekomi verifica la que lleve la entrega y rechaza cualquier entrega malformada.
  • Para ser transparentes: el esquema heredado no lleva marca de tiempo, así que la resistencia a reproducciones en esa vía descansa en la deduplicación de eventos de Rekomi (una entrega reproducida se reconoce y se ignora) y no en una ventana de frescura. El esquema standard-webhooks añade además una ventana de frescura de 300 segundos.
  • El secreto de firma y la clave de API se guardan cifrados en reposo y la API nunca los devuelve. Desconectar borra los dos y retira la URL del webhook.
  • Test Mode y producción están aislados: los eventos cuyo modo no coincide con tu conexión se omiten, nunca se registran como dinero.

Detalles que conviene conocer

  • Una sola fuente de conversiones por espacio de trabajo. La conexión con Creem es excluyente con Stripe (a través de la app de Rekomi para Stripe), Paddle, Braintree, Shopify, Lemon Squeezy, Chargebee, Polar, Recurly, Gumroad, Dodo Payments, Mollie y la API S2S, para que la misma venta nunca se cuente dos veces. Desconecta una antes de conectar otra.
  • Las claves de API de Creem no caducan. Si la comprobación de estado marca la conexión como rota, la clave se eliminó o se regeneró en Creem, o perdió el permiso de lectura de Products al editar sus permisos; nunca es una caducidad rutinaria. Reconecta con una clave vigente.
  • La comprobación de estado verifica la clave, no el webhook. Creem no tiene API de gestión de webhooks, así que un endpoint de Rekomi borrado no lo puede detectar la comprobación de estado; el único síntoma es que los eventos dejan de llegar. La página de configuración lee por ti la hora del último evento: se queda en ámbar con "todavía no ha llegado ningún evento" hasta que llega una entrega firmada, y vuelve a avisar si los eventos se quedan en silencio más de una semana. Los dos estados apuntan a la misma solución: vuelve a añadir la URL en Developers > Webhooks con todos los eventos seleccionados.
  • Rotar las credenciales no necesita desconectar. Si borras y vuelves a crear el webhook en Creem, obtienes un secreto de firma nuevo, y hasta que lo pegues, todas las entregas fallan la verificación de firma mientras la conexión sigue pareciendo correcta (la clave de API no se ve afectada). Usa Actualizar credenciales en la página de configuración. Tu URL de webhook se conserva, así que nada cambia del lado de Creem. Desconectar, en cambio, rotaría la URL y obligaría a repetir toda la configuración.
  • El calendario de reintentos cubre varias horas. Creem reintenta una entrega fallida a los 30 segundos, 5 minutos, 30 minutos y 6 horas del primer intento (cinco entregas en unas 6.5 horas; calendario confirmado por el soporte de Creem), y después para. Rekomi responde con un error a propósito cuando no puede procesar un evento de dinero en ese momento, para que Creem lo vuelva a entregar; para lo que quede fuera de ese calendario, el panel de Creem tiene un reenvío manual en la sección Developers, y Rekomi registra los reenvíos sin contarlos dos veces.
  • La atribución por código de cupón está activa. Los webhooks de Creem llevan el código de descuento que canjeó el comprador, y un código que coincide con el código de cupón de un afiliado en Rekomi acredita a ese afiliado aunque no haya un clic rastreado. El código canjeado tiene prioridad sobre las señales del enlace (escribir un código en el checkout es la declaración más explícita del comprador sobre quién lo envió), y un código desconocido o revocado pasa a la atribución normal por enlace con rekomi_ref sin ningún daño.

Ensaya en Test Mode

El Test Mode de Creem es un entorno aparte, y las conexiones de producción de Rekomi rechazan a propósito las credenciales de prueba, así que un ensayo completo se hace en una configuración de staging. Lo que puedes verificar en producción sin gastar dinero:

  1. Conecta y haz clic en Comprobar conexión en la página de configuración: sondea tu clave de API en vivo.
  2. Añade el webhook con todos los eventos seleccionados y envía una entrega de prueba desde la página de webhooks de Creem si te lo ofrece; una entrega con firma válida actualiza el "último evento" en la página de configuración.
  3. Haz una compra real a través de un enlace de afiliado con ?via= fijado al slug del enlace de un afiliado aprobado, confirma la conversión en la pestaña Rendimiento de la campaña en menos de un minuto, y después reembólsala y confirma que la comisión se recupera.

Solución de problemas

Aviso de "Tu conexión con Creem está rota" o correo de reconexión. La clave de API guardada dejó de validarse: se eliminó o se regeneró en Creem, o perdió el permiso de lectura de Products. Crea una clave nueva (con la lectura de Products basta) y reconecta en /dashboard/setup/creem; tu historial de seguimiento se conserva.

"Esa es una clave creem_test_..." Pegaste una clave de Test Mode en una conexión de producción (o al revés). Las claves no son intercambiables entre los entornos de Creem; pega una clave creem_ real de tu panel de producción.

El error dice que la clave es "inválida, revocada o sin el permiso de lectura de Products". Creem responde con el mismo 403 para las tres causas, así que Rekomi no puede distinguirlas. Rekomi solo necesita el permiso de lectura de Products; si tu clave parece bien configurada, crea una clave nueva con ese permiso y conecta de nuevo.

Los eventos dejan de llegar pero la conexión aparece como correcta. La comprobación de estado sondea la clave de API, no el webhook. Comprueba que el endpoint sigue existiendo en Creem, en Developers > Webhooks, apunta a la URL correcta y tiene todos los eventos seleccionados (una selección parcial es el clásico fallo silencioso). El panel de Creem muestra los intentos de entrega y te permite reenviar. Si en algún momento volviste a crear el webhook, el secreto de firma cambió: pega el actual con Actualizar credenciales.

Las ventas llegan pero no se acredita a ningún afiliado. El checkout llegó a Rekomi pero sin rekomi_ref. Verifica que tu llamada de creación del checkout define metadata.rekomi_ref (o que tus enlaces de pago llevan ?metadata[rekomi_ref]=), y que el script de seguimiento se ejecutó antes de que el comprador hiciera clic (para que window.Rekomi.getReferral() tuviera valor).

Falta una conversión después de una caída. El calendario de reintentos de Creem termina pasadas unas 6.5 horas. Abre la entrega en el panel de Creem, en la sección Developers, y reenvíala; Rekomi la registra sin contarla dos veces.