¿Cómo integro Stripe para el seguimiento de ingresos?

Conectar Stripe permite a Zenovay mostrar los ingresos junto a tus datos de tráfico — qué fuente de marketing produjo al cliente que pagó, en qué página convirtió, qué campaña cerró el trato.

La configuración ocurre por sitio, dentro del panel de ese sitio. Hay una credencial para pegar — una clave API de Stripe restringida — y Zenovay maneja el cableado del webhook por ti.

Conectar Stripe

1. 1

   Abre la configuración de Revenue del sitio

   En app.zenovay.com, abre el sitio que deseas conectar, ve a su Configuración, y abre la pestaña Revenue. Cada conexión Stripe se asigna a un sitio Zenovay.

2. 2

   Elige Stripe

   Haz clic en la tarjeta Stripe. Verás un formulario de configuración breve.

3. 3

   Crea y pega una clave API restringida

   Zenovay enlaza directamente a la pantalla «Crear clave restringida» de Stripe con los permisos de lectura que necesita (saldo, cargos, suscripciones, clientes, intenciones de pago, sesiones de pago, facturas) más escritura de webhook. Crea la clave en Stripe, cópiala (comienza con rk_live_… o rk_test_…), pégala en el campo, y haz clic en Conectar.

4. 4

   Deja que Zenovay termine la configuración

   Cuando guardes la clave, Zenovay la valida contra Stripe y crea automáticamente el punto final del webhook en tu cuenta Stripe, para que los pagos comiencen a fluir sin que toques el Stripe Dashboard. La tarjeta muestra Conectado con un distintivo verde «credenciales verificadas» una vez que esté listo.

Una vez conectado, la pestaña Revenue de tu panel muestra gráficos de MRR, ARR, ingresos por visitante e ingresos por fuente. Los ingresos se capturan a partir del momento en que te conectas — Zenovay registra los pagos conforme Stripe envía los eventos de webhook, no realiza una reimportación retroactiva del historial de Stripe.

Configurar el webhook manualmente (opcional)

Zenovay crea el webhook de Stripe por ti, así que la mayoría de las personas nunca necesitan esto. Si prefieres cablear el webhook tú mismo — por ejemplo porque tu clave de Stripe no incluye permiso de escritura de webhook — puedes apuntar Stripe al receptor de Zenovay y pegar el secreto de firma de vuelta.

1. En el Stripe Dashboard, ve a Developers → Webhooks → Add endpoint.
2. URL del punto final: https://api.zenovay.com/api/webhooks/stripe/YOUR_WEBSITE_ID (tu ID de sitio está en la URL de página del panel de tu sitio).
3. Selecciona estos eventos:
   • checkout.session.completed
   • payment_intent.succeeded
   • invoice.paid
   • customer.subscription.created
   • customer.subscription.updated
   • customer.subscription.deleted
4. Guarda, luego copia el secreto de firma del punto final (comienza con whsec_…).
5. De vuelta en el formulario Stripe de Zenovay (la pestaña de configuración Revenue), pega el secreto de firma para que Zenovay pueda verificar los eventos entrantes.

Atribuir un pago a un visitante

Para que la atribución pago-a-fuente-de-tráfico funcione, el ID anónimo de Zenovay del visitante debe llegar al registro de Stripe. La forma más simple es configurarlo como client_reference_id de la sesión de pago, o adjuntarlo como metadatos en el pago:

// En tu servidor de pago
const visitorId = req.cookies['zv_visitor_id'] // o como tu cliente lo pase
stripe.checkout.sessions.create({
  // ...
  client_reference_id: visitorId,
  metadata: { zenovay_visitor_id: visitorId }
})

Cuando el pago se completa, el manejador de webhooks de Zenovay lee el client_reference_id (o metadata.zenovay_visitor_id / metadata.visitor_id) y une el pago con la sesión del visitante — incluida la fuente, la campaña y las páginas que visitó antes de pagar. Los pagos sin un ID de visitante se siguen registrando como ingresos, solo sin atribución de fuente.

Qué modelos de atribución están disponibles

Zenovay calcula varios modelos de atribución para que puedas ver cómo el crédito cambia dependiendo de qué puntos de contacto peses:

• Last Touch — el crédito va a la fuente en la sesión donde ocurrió el pago.
• First Touch — el crédito va a la fuente de donde llegó el visitante primero.
• Linear — crédito dividido equitativamente entre todos los puntos de contacto en el camino.
• Position-Based — pondera el primer y último punto de contacto más fuertemente.
• Time-Decay — los puntos de contacto más cercanos a la conversión obtienen más crédito.

Cambia entre ellos en la pestaña Revenue para comparar cómo cada modelo asigna el crédito.

Desconectar

Abre la tarjeta Stripe en la pestaña de configuración Revenue del sitio y haz clic en Eliminar. Por defecto, esto solo desconecta las credenciales — tus registros de pago existentes permanecen en el panel durante tu período de retención de datos. Si también quieres eliminar los datos históricos de ingresos, marca la opción de eliminación en cascada en el cuadro de diálogo de confirmación (te muestra exactamente cuántos registros se borrarán).

Eliminar la integración en Zenovay no elimina el webhook del lado de Stripe, así que es posible que también quieras eliminar el punto final en tu Stripe Dashboard.

Lecturas relacionadas

• Visión general de webhooks
• Seguimiento de ingresos de e-commerce
• Visión general de la API
• Instalar el script de seguimiento