PromoteKit
Conecta PromoteKit con Webflow para realizar un seguimiento de las referencias de afiliados desde tus páginas hasta las compras en Stripe.

Tus páginas de inicio y de precios viven felices en Webflow, pero no hay forma nativa de atribuir una venta a un afiliado. Quien llega desde un enlace de recomendación parece un visitante cualquiera. En cuanto hace clic para ir a Stripe Checkout o a un Stripe Payment Link, el rastro entre quien recomendó y el pago se esfuma en el aire. PromoteKit viene al rescate para cerrar esa brecha, despidiéndose de las cookies personalizadas, los registros manuales de comisiones y los líos de scripts para gestionar pagos.
Con PromoteKit instalado, un script en tu sitio de Webflow almacena el ID de referencia en una cookie del navegador. Cuando el visitante paga a través de Stripe, PromoteKit lee ese ID y acredita al afiliado. Las comisiones, los ajustes de reembolso y los pagos se ejecutan dentro de PromoteKit mientras tus páginas publicadas siguen atendiendo a los visitantes. También puedes omitir el script y realizar el seguimiento de los afiliados mediante códigos promocionales únicos de Stripe.
La solución ideal para fundadores de SaaS que combinan su web en Webflow con una app en un subdominio cobrada mediante Stripe. Para el equipo de marketing que sueña con lanzar un programa de afiliados sin suplicar ayuda a los desarrolladores, es la vía no-code perfecta. También cae como anillo al dedo a agencias de Webflow con sitios de membresía en Memberstack y a developers que diseñan paneles de afiliados a medida desde la API.
Cómo integrar PromoteKit con Webflow
¿Qué es PromoteKit? Es una plataforma genial de marketing de afiliados para negocios con suscripciones o pagos únicos a través de Stripe. Cada afiliado cuenta con su propio enlace exclusivo de recomendación y, si quieres, un código promocional único de Stripe.

Los equipos utilizan la integración cuando Webflow envía a los compradores a Stripe Checkout y también cuando las páginas utilizan enlaces de pago de Stripe o una tabla de precios de Stripe. Stripe es la capa de atribución en todos los casos, por lo que tus páginas de Webflow alojan el contenido y entregan el script. La combinación es ideal para equipos cuyo tráfico de referencia llega a una página de Webflow pero cuyo dinero se mueve a través de Stripe. PromoteKit requiere una cuenta de Stripe y lee las comisiones de los pagos de Stripe, por lo que la ruta es siempre de las páginas de Webflow a Stripe. Ninguna de las guías de configuración, las preguntas frecuentes o el listado en el Marketplace de PromoteKit documentan el proceso de pago nativo de Ecommerce de Webflow como una ruta compatible, y la atribución depende de un ID de referencia en los metadatos de la sesión de Stripe Checkout o de un código promocional de Stripe aplicado al finalizar la compra.
La integración de PromoteKit con Webflow admite cuatro enfoques:
- La app de PromoteKit instala el script de seguimiento en cualquier sitio conectado desde el Webflow Marketplace, ¡olvídate de copiar y pegar código!
- El código personalizado manual te permite insertar el script a tu gusto: en los ajustes generales del sitio, en una página específica o en un solo componente.
- Los códigos promocionales de Stripe rastrean a cada afiliado directamente desde Stripe, sin tener que meter un solo script en tu web.
- Las API de Webflow y PromoteKit te dan superpoderes sobre los datos de afiliados, la sincronización con el CMS y la atribución personalizada en Stripe Checkout. Eso sí, requieren desarrollo en el servidor.
La mayoría de las implementaciones combinan dos o más de estos métodos según la complejidad de la configuración.

Instala la aplicación PromoteKit
La aplicación PromoteKit añade el script de seguimiento a cualquier sitio de Webflow conectado sin necesidad de abrir los campos de código personalizado. El listado cuenta con el estado "Aprobado por Webflow", y Webflow califica esa insignia como una revisión de calidad más que como un respaldo. El listado solicita cinco alcances de OAuth: authorized_user:read, custom_code:read, custom_code:write, sites:read y sites:write. Se autoriza a nivel de espacio de trabajo, por lo que otorgar el permiso cubre todos los sitios en ese espacio de trabajo. Úsala si vendes a través de enlaces de pago de Stripe o una tabla de precios de Stripe. PromoteKit describe la instalación como un proceso de un solo clic en su anuncio de la aplicación para Webflow. Nunca tendrás que pegar código.
Para configurar la integración:
- Abre el listado de PromoteKit en el Marketplace de Webflow, instala la aplicación y otorga los permisos de código personalizado y datos del sitio.
- Conecta tu cuenta de Webflow y luego añade el script de seguimiento de PromoteKit a cualquiera de tus sitios.
- Publica el sitio para que el script esté activo para los visitantes.
- Asegúrate de que tu cuenta de Stripe esté conectada en PromoteKit, ya que Stripe es necesario para todo el seguimiento.
Una vez que el script está activo, se encarga de:
- Captura el ID de referencia de enlaces
?via=,?ref=,?aff=o?promocode=en unapromotekit_referralcookie que dura 60 días por defecto y que puede cambiarse según la campaña - Seguimiento de cookies entre subdominios, para que una visita en
yoursite.comsiga atribuyendo una compra realizada desdeapp.yoursite.com - Atribución para Stripe Payment Links y Stripe Pricing Tables sin integración de API, que es el método que documenta la propia guía de Payment Links de PromoteKit para sitios Webflow
- Seguimiento de pruebas, suscripciones, cancelaciones y reembolsos dentro de Stripe, según el listado de la aplicación PromoteKit
El script solo llama a PromoteKit y escribe esa cookie cuando uno de esos parámetros de referencia está en la URL y no hay ninguna cookie de referencia almacenada, por lo que una visita normal no registra nada. Cuando llega un enlace de referencia, la cookie se escribe al cargar con SameSite=None; Secure y se limita a tu dominio registrable, antes de cualquier banner de consentimiento, lo cual vale la pena verificar con tu propia configuración de consentimiento. El paquete no incluye su propio código de análisis, informes de errores o reproducción de sesiones. El seguimiento de los enlaces comienza tan pronto como se publica el sitio. Los pagos se realizan a través de PayPal Mass Payments o Wise Batch Payments; también hay disponible un método manual, según la descripción general de pagos de PromoteKit. Las referencias solo se registran en el modo en vivo de Stripe, por lo que una compra en modo de prueba nunca aparecerá en el panel. Usa código personalizado manual para controlar exactamente dónde se carga el script.
Añade el script de PromoteKit con código personalizado
Pegar el script a mano ofrece el mismo rastreo impecable que la app, pero dándote el control absoluto de dónde va cada cosa. PromoteKit genera un script exclusivo para tu cuenta en Setup > Step 4 (PromoteKit Integration), con la variante para Payment Links en OPTION 2: Stripe Payment Links. El script debe cargarse tanto en la página de aterrizaje del visitante como en la que aloja el botón de pago. Si falta en alguna, la atribución se rompe; echa un vistazo a la guía de configuración de la API de Stripe.
Pega el script en el código head de todo el sitio
Añadir el código en la etiqueta Head dentro de los ajustes del sitio carga el script en cada rincón de la web: aterrizaje y checkout listos de un solo tiro. Esta función requiere un Workspace Core, Growth, Agency o Freelancer, o bien un plan de sitio activo. Cada campo de código personalizado y cada elemento Code Embed admiten hasta 50.000 caracteres.
Para añadir el script a todo el sitio:
- En PromoteKit, dirígete a Setup > Step 4 (PromoteKit Integration) > OPTION 2: Stripe Payment Links y copia el script.
- En Webflow, entra en Site settings > Custom code y pega el script en Head code.
- Haz clic en Save changes y publica el sitio.
- De vuelta en PromoteKit, haz clic en Ok, I've completed this.
También puedes usar el campo Footer code, ya que PromoteKit solo requiere que el script esté dentro de <head> o <body>.
Limita el script a una página o a un elemento Code Embed
Si solo quieres el script en páginas específicas, usa código personalizado a nivel de página o un elemento Code Embed. El código a nivel de página se aplica solo a esa página y aparece después del código de todo el sitio en el HTML. Un Code Embed coloca el script en una posición específica del diseño. Eso ayuda cuando una tabla de precios se encuentra en una sección. Elijas lo que elijas, tanto la página de destino como la de pago necesitan el script.
Para añadir el script a una página:
- En Webflow, abre Page settings > Custom code y pega el script en Inside
<head>tag. - Haz clic en Save y publica el sitio para ver la magia.
Para colocarlo con un elemento Code Embed en su lugar:
- Abre el panel Agregar y arrastra un elemento Code Embed hasta el lienzo.
- Pega el script en el modal y guárdalo.
- Publica el sitio. El código dentro de las etiquetas
<script>solo muestra un marcador de posición en el lienzo y se renderiza al publicar.
En el modo Preview el código personalizado viene desactivado de fábrica. Activa el interruptor Enable custom code para ver la magia del script antes de publicar.
Realiza el seguimiento de referidos en un sitio de Webflow creado con Memberstack
Memberstack gestiona los cobros a usuarios mediante Stripe Checkout y Stripe Billing. La integración de PromoteKit con Memberstack funciona a las mil maravillas tanto con enlaces de afiliados como con códigos promocionales en tu web de membresías de Webflow. Asegúrate de copiar el script de la opción de Memberstack y no el de Payment Links. Entre las integraciones oficiales de PromoteKit se encuentran Memberstack, Outseta, MemberSpace y la app de Webflow.
Para instalar el script de Memberstack:
- En PromoteKit, ve a Setup > Step 4 (PromoteKit Integration) > Memberstack > OPTION 1: Affiliate links y copia el script.
- En Webflow, pégalo en Site settings > Custom code > Head code y pulsa Save changes.
- Publica el sitio.
Los códigos promocionales también hacen juego perfecto con Memberstack: solo te hace falta un cupón de Stripe. Ten presente que los endpoints de Webflow User Accounts se retiraron de la API el 29 de enero de 2026, según el historial de cambios de la API.
Realiza el seguimiento de afiliados con códigos promocionales de Stripe sin necesidad de scripts en el sitio
El seguimiento mediante códigos promocionales se ejecuta completamente a través de Stripe y no requiere ningún script en tus páginas. Esto lo convierte en la única vía que funciona sin un plan de sitio o espacio de trabajo de pago. Cada afiliado obtiene un código único generado a partir de un cupón de Stripe. La atribución ocurre cuando el comprador aplica el código al finalizar la compra, por lo que no se utilizan cookies.
Para configurar el seguimiento mediante códigos promocionales:
- Crea un único cupón en Stripe.
- Selecciona esta vía en PromoteKit dentro de Setup > Step 4 > OPTION 3: Coupon Codes; PromoteKit creará un código único para cada afiliado, tal como se detalla en la guía de códigos de cupón por defecto.
- Marca la casilla Allow promotion codes en el Stripe Payment Link al que apunta tu página de precios.
Crea el cupón en el modo en vivo de Stripe, ya que los códigos creados en modo de prueba no funcionarán en producción.
Desarrolla con las API de Webflow y PromoteKit
La ruta de la API es un sueño para quienes quieren ver los datos de sus afiliados directo en el CMS de Webflow. También viene genial para enviar registros de formularios de Webflow a PromoteKit o para montar un Stripe Checkout propio en vez de Payment Links. La API y los webhooks de PromoteKit están disponibles únicamente en los planes Pro y Enterprise, según la comparativa de planes de PromoteKit. Ambas API se autentican con tokens Bearer.
- La API REST de PromoteKit en
https://www.promotekit.com/api/v1gestiona afiliados, campañas, referidos, comisiones y pagos, con claves generadas en Settings > API Keys - Los webhooks de PromoteKit envían cinco eventos:
affiliate.created,affiliate.approved,referral.created,referral.convertedycommission.created, firmados con encabezados de Svix - La API de datos de Webflow gestiona los elementos de las colecciones de CMS y los envíos de formularios
- Los webhooks de Webflow se activan en
form_submission,collection_item_created,site_publishy otros eventos del sitio - La API de código personalizado registra scripts alojados y los aplica a sitios o páginas para instalaciones gestionadas por apps
Esas claves no pueden estar en el código del lado del cliente, así que necesitas un servidor o una función serverless. Las secciones de código personalizado solo aceptan código del lado del cliente, específicamente HTML que puede incluir CSS y JavaScript; allí no se ejecuta ningún lenguaje del lado del servidor. La función debe ejecutarse fuera de Webflow, en tu propio servidor o en una plataforma serverless.
La API de datos v1 quedó obsoleta el 31 de marzo de 2025, así que desarrolla desde el principio utilizando el espacio de nombres /v2/ .
Sincroniza afiliados y comisiones con el CMS de Webflow
Si quieres una tabla de clasificación pública o un directorio de socios, necesitas los registros de afiliados dentro del CMS de Webflow. Extráelos de PromoteKit de forma programada o recíbelos mediante webhooks, y luego crea cada uno como un elemento de colección. Una Collection List se encarga de mostrar la lista. Además, un Code Embed dentro de ella puede vincular campos de la colección en código personalizado para crear widgets a medida de cada afiliado.
Para implementar la sincronización:
- Crea una colección con slugs de campo que coincidan con los campos de carga útil que necesitas. Usa slugs como
affiliate-id,first-name,referral-linkycommission-amount. Las claves dentro defieldDatadeben coincidir exactamente con esos slugs. - Obtén registros con
GET https://www.promotekit.com/api/v1/affiliatesyGET https://www.promotekit.com/api/v1/commissionsusando el encabezadoAuthorization: Bearer <API_KEY>. Pagina los resultados con los parámetroslimitypage. - Alternativamente, registra un endpoint en PromoteKit en Configuración > Webhooks > Añadir endpoint para
affiliate.createdycommission.created. Verifica cada entrega con los encabezadossvix-id,svix-timestampysvix-signaturey tu secretowhsec_. - Escribe elementos con
POST /v2/collections/{collection_id}/items/livepara que sean visibles de inmediato. Para una revisión por etapas, usaPOST /v2/collections/{collection_id}/itemsseguido dePOST /v2/collections/{collection_id}/items/publish. Las actualizaciones se realizan a través dePATCH /v2/collections/{collection_id}/items, bajo el ámbitoCMS:write. - Devuelve una respuesta 2xx en un plazo de 15 segundos y elimina duplicados en
svix-id, ya que las entregas fallidas se reintentan con retroceso exponencial.
PromoteKit no tiene un evento de pago, por lo que detectar un cambio en payout_status significa consultar el endpoint de comisiones.
Crea afiliados a partir de un envío de formulario de Webflow
Un formulario de "Únete a nuestro programa de afiliados" en tu sitio de Webflow puede crear al afiliado en PromoteKit automáticamente. Un form_submission webhook envía datos a tu endpoint, y tu función reenvía los campos al endpoint de creación de afiliados de PromoteKit. El endpoint debe ser código alojado por ti.
Para implementar el flujo:
- Registra el webhook con
POST /v2/sites/{site_id}/webhooks, usandotriggerTypeform_submissiony un filtro en el nombre del formulario. Esto requiere el ámbitosites:write. - Analiza la carga útil. Contiene
name,siteId,data(los campos del formulario como pares clave-valor),submittedAt,formId,formElementIdyschema, según la referencia de eventos de webhook. - Envía
POST https://www.promotekit.com/api/v1/affiliatescon los detalles del solicitante y tu clave Bearer. - Activa Requerir aprobación para unirse en PromoteKit, una función de Pro y Enterprise, si deseas evaluar a los solicitantes. Los eventos de aprobación se activan como
affiliate.approved.
Cada respuesta de PromoteKit es JSON. Si tiene éxito, obtienes success: true y un objeto data; si falla, success: false y un objeto error.
Atribuye sesiones personalizadas de Stripe Checkout
Si tu backend crea sesiones de Stripe Checkout en lugar de usar enlaces de pago, la cookie no puede seguir al visitante. checkout.stripe.com es un dominio diferente. Lee el ID de referencia en tu página de Webflow y envíalo con la solicitud de pago. Pásalo en los metadatos de Stripe, como se documenta en la guía de configuración de la API de Stripe. La atribución personalizada de Stripe Checkout pasa los metadatos directamente a Stripe y no requiere acceso a la API REST de PromoteKit. Mantén la clave secreta de Stripe requerida en tu servidor, nunca en el código personalizado de Webflow.
Para implementar la atribución:
- Instala el script de PromoteKit tanto en la página de destino como en la de pago utilizando la aplicación o los métodos de código personalizado mencionados anteriormente.
- En la página de pago, lee en JavaScript, o en PHP. Inclúyelo en la solicitud a tu backend.
window.promotekit_referral$_COOKIE['promotekit_referral'] - Crea la sesión con la referencia en los metadatos:
const session = await stripe.checkout.sessions.create({ success_url: 'https://example.com/success', cancel_url: 'https://example.com/cancel', metadata: { promotekit_referral: req.body.referral, }, line_items: [ {price: 'price_1OBQlV2eZvKYlo2CDL02DbMx', quantity: 1}, ], mode: 'subscription', }); - Añade a la misma llamada si también quieres que se acepten códigos promocionales de afiliados al finalizar la compra.
allow_promotion_codes: true
Para pruebas gratuitas o registros que ocurran antes de cualquier pago, llama a en tu página. es obligatorio y el ID de cliente de Stripe es opcional.window.promotekit.refer(email, stripe_customer_id?)email
Lo que puedes construir con la integración de PromoteKit en Webflow
Integrar PromoteKit con Webflow te permite ejecutar un programa de afiliados atribuido a Stripe sin tener que crear un seguimiento de cookies o un registro de comisiones. PromoteKit también proporciona las herramientas para los pagos.
- Programa de socios SaaS en subdominios de marketing y aplicaciones: Un sitio de Webflow en captura la referencia. La compra se completa entonces en la aplicación en . La cookie se limita al dominio registrable en lugar del host, que es lo que permite la atribución entre ambos.
www.yoursite.comapp.yoursite.com - Programa de afiliados con códigos promocionales y cero código en el sitio: una página de precios de Webflow que apunta a un enlace de pago de Stripe, donde cada afiliado reparte su propio código. Al no necesitar scripts ni cookies, el seguimiento por códigos promocionales sortea los bloqueadores de anuncios y las restricciones de cookies de los navegadores; de hecho, las preguntas frecuentes de PromoteKit lo recomiendan como la vía ideal si quieres olvidarte del rastreo por cookies.
- Comunidad de pago en Webflow y Memberstack: un sitio de membresía donde los miembros pagan a través del checkout de Stripe de Memberstack, con el script de PromoteKit para Memberstack insertado en el encabezado. Los afiliados pueden promocionarlo tanto con su enlace como con su código promocional. Y si hay reembolsos en Stripe, sus comisiones se ajustan solas por arte de magia.
- Página de clasificación de afiliados en el CMS: Una página publicada de "Mejores socios" creada a partir de una lista de colecciones, alimentada por webhooks de y que escriben en la API de datos. Los recuentos de referencias y los totales de comisiones se actualizan a medida que llegan los pagos de Stripe. Esto requiere un plan PromoteKit Pro o Enterprise.
affiliate.createdcommission.created
Si buscas un mayor control sobre las comisiones o quieres personalizar la atribución en Stripe Checkout, la API tiene todo lo que necesitas. Comienza con nuestra guía sobre cómo configurar Stripe Checkout y luego añade los metadatos de referencia explicados arriba.
Preguntas frecuentes
No. PromoteKit lee las referencias y comisiones de tus pagos de Stripe, y sus propias preguntas frecuentes indican que se requiere una cuenta de Stripe y mencionan a Webflow como una de las plataformas que admite además de Stripe. Ninguna de sus guías de configuración cubre el proceso de pago nativo de Webflow Ecommerce. La configuración documentada es un sitio de Webflow que envía a los compradores a Stripe. El proceso de pago alojado en Stripe es una opción, y los enlaces de pago y las tablas de precios de Stripe también funcionan. Las sesiones de pago personalizadas de Stripe necesitan en los metadatos de la sesión.
promotekit_referralPara añadir el script necesitas un espacio de trabajo Core, Growth, Agency o Freelancer, o bien un plan de sitio activo, que es el requisito que marca la documentación de código personalizado de Webflow para el head y el body. El seguimiento con códigos promocionales es la gran excepción: no requiere script alguno en la web, tal como indica la guía de códigos promocionales de Stripe de PromoteKit, por lo que funciona sin problemas en sitios sin soporte para código personalizado. Fuera de eso, lo más rápido y directo es instalar la app de PromoteKit desde el Marketplace.
El código personalizado viene desactivado por defecto en el modo Preview, así que activa la opción Enable custom code para ver cómo se carga el script. Eso sí, todavía no generará ninguna referencia: PromoteKit solo las registra en el modo real de Stripe, por lo que una compra en modo de prueba nunca llegará a tu panel. Para poner a prueba todo el flujo sin gastar un solo céntimo, publica el sitio y utiliza un cupón del 100 % de descuento en el modo real de Stripe.
Zapier, Make, n8n, viaSocket e IFTTT carecen de conectores nativos para PromoteKit. Los puentes personalizados utilizan webhooks de PromoteKit para enviar JSON a cualquier punto final HTTPS, y una función sin servidor puede reenviar a la API de datos de Webflow. Los webhooks son una función de los planes Pro o Enterprise.
referral.convertedLa cookie dura 60 días por defecto y puedes cambiar la duración según la campaña. También abarca subdominios, ya que PromoteKit la registra en tu dominio principal en lugar del host exacto. La documentación de PromoteKit indica que "el seguimiento mediante cookies funciona en todos los subdominios de un dominio", por lo que un sitio de Webflow en
www.y una aplicación enapp.comparten la atribución. Si prefieres no depender de las cookies, la sección de preguntas frecuentes de PromoteKit menciona los códigos promocionales como la alternativa sin cookies.

Descripción
Instala la aplicación PromoteKit o pega su script de seguimiento en el código personalizado de tu sitio de Webflow para acreditar a los afiliados por las compras en Stripe que comiencen en tus páginas de Webflow.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.

AddThis
Convierte a tus visitantes en clientes fieles.


