Integración con Stripe

Se necesita ayuda del desarrollador

Necesitarás ayuda de tu equipo de desarrollo para pasar los metadatos (journey, usuario, dispositivo) al crear Sesiones de Checkout de Stripe. Comparte esta guía con ellos.

Stripe es una plataforma de pagos que te permite aceptar pagos y gestionar suscripciones. La integración de Stripe con Pushwoosh te permite rastrear pagos y suscripciones en campañas, analizar ingresos por journey y producto, segmentar usuarios por eventos de pago y usar ManyMoney AI para obtener información sobre los ingresos.

Resumen de la integración

Tipo de integración

Fuente: Los eventos de pago y suscripción se envían desde Stripe a Pushwoosh.

Requisitos previos

Para configurar la integración de Stripe con Pushwoosh, asegúrate de lo siguiente:

• Tienes una cuenta activa de Pushwoosh.
• Tienes una cuenta de Stripe.

Glosario (mapeo de nombres de entidades si son diferentes)

La siguiente tabla muestra cómo las entidades de Stripe se mapean a Pushwoosh. Este mapeo se logra pasando los campos correspondientes como metadatos cuando creas una Sesión de Checkout (ver Configuración de metadatos).

Stripe	Pushwoosh
Cliente	user_id (requerido), device_id (opcional) en metadatos
Pago / Cargo	Evento StripePaymentSucceeded (charge.succeeded)
Factura (pagada)	Evento StripeInvoicePaid (invoice.paid)
Suscripción	StripeSubscriptionCreated + atributos en StripeInvoicePaid
Producto / Precio	product_id, product_name en metadatos y atributos de evento
Campaña (journey)	journey_uuids en metadatos

Entidades sincronizadas

• Eventos de pago (pagos únicos, facturas de suscripción)
• Eventos de suscripción (suscripción creada, factura de suscripción pagada)

¿Cómo funciona la integración?

Después de conectar tu cuenta de Stripe a Pushwoosh a través de Stripe Connect, Pushwoosh recibe datos de pago y suscripción de Stripe. Puedes vincular cada transacción a una campaña y usuario o dispositivo pasando metadatos al crear una Sesión de Checkout (ver Configuración de metadatos).

Pushwoosh crea eventos que puedes usar para segmentación y análisis.

Flujo de datos

1. Conectas tu cuenta de Stripe a Pushwoosh una vez a través de Stripe Connect en Configuración → Integraciones de terceros.
2. Al crear una Sesión de Checkout, pasas metadatos para que el pago pueda ser atribuido más tarde (ver Configuración de metadatos).
3. Cuando ocurre un evento de pago o suscripción en Stripe (p. ej., charge.succeeded para un pago único, invoice.paid para una suscripción), Stripe envía los datos a Pushwoosh.
4. Pushwoosh crea los eventos correspondientes y utiliza los metadatos para la atribución. Estos datos aparecen en el Resumen Financiero, Audiencia → Eventos y ManyMoney.

Casos de uso

Rastrear pagos

Recibe automáticamente información sobre todos los pagos y suscripciones exitosos.

Vincular pagos a campañas

Asocia transacciones con customer journeys específicos pasando metadatos (ver Configuración de metadatos).

Analizar ingresos

Visualiza los ingresos por campañas, productos, usuarios y dispositivos.

Segmentar tu audiencia

Crea segmentos basados en eventos de pago.

Análisis con IA

El asistente ManyMoney AI recibe automáticamente estadísticas de pagos y suscripciones y puede tomar decisiones basadas en estos datos.

Configurar la integración

Conectar Stripe a Pushwoosh

1. Abre cualquier aplicación de Pushwoosh (la cuenta de Stripe se vincula a toda tu cuenta, no a una aplicación específica) y navega a Configuración → Integraciones de terceros.
2. Encuentra la tarjeta de Stripe y haz clic en el botón PÁGINA DE INICIO DE SESIÓN.

3. Serás redirigido a la página de autorización de Stripe.

4. En la página de Stripe, introduce tu correo electrónico y haz clic en Continuar.
5. Inicia sesión en tu cuenta de Stripe (o crea una nueva). Si tienes varias cuentas, selecciona la que deseas conectar.
6. Haz clic en Conectar para confirmar.
7. Después de una autorización exitosa, serás redirigido de nuevo a Pushwoosh. El estado de la integración cambiará a Conectado.

Desconectar la integración

Método 1. A través de Pushwoosh

1. Ve a Configuración → Integraciones de terceros.
2. Encuentra la tarjeta de Stripe y haz clic en el botón CONFIGURACIÓN.
3. En la ventana emergente, haz clic en el botón Desconectar.

Método 2. A través del Panel de control de Stripe

1. Inicia sesión en el Panel de control de Stripe.
2. Ve a Configuración → Equipo y seguridad → Aplicaciones instaladas.
3. Encuentra la aplicación en la sección Extensiones de Connect.

Cuando te desconectas a través de Stripe, Pushwoosh recibe automáticamente una notificación y elimina la integración.

Configuración de metadatos

Stripe envía eventos de pago a Pushwoosh, pero sin datos adicionales Pushwoosh no puede saber a qué campaña o a qué usuario pertenece el pago. Cuando pasas metadatos en la creación de la Sesión de Checkout (IDs de campaña, ID de usuario o dispositivo, producto), cada pago se atribuye al journey y usuario correctos.

Luego verás los ingresos por campaña en el Resumen Financiero, construirás segmentos por pagador y usarás ManyMoney con la atribución correcta.

Campos de metadatos disponibles

Campo	Descripción	Requerido	Ejemplo
journey_uuids	IDs de campaña (journey) separados por punto y coma	No	bfab4bc0-b0a5-414b-befc-4aaddc429b0e;a2bff710-6b49-44d1-96a7-3232feeca6e9
user_id	Identificador de usuario. Requerido para la recolección de eventos y para que se aplique device_id	Sí	user_12345 o email@example.com
device_id	ID de hardware del dispositivo (HWID).	No	hwid_abc123
product_id	ID del producto	No	prod_premium
product_name	Nombre del producto	No	Plan Premium

Importante

• Sin user_id, los eventos no se recopilan y se ignora device_id. Para un análisis completo, proporciona también journey_uuids y device_id.

• journey_uuids es opcional y solo se puede establecer a través de metadatos. Stripe no proporciona datos de campaña o journey, así que pásalo al crear la Sesión de Checkout si quieres que los ingresos se atribuyan a un journey.

• product_id y product_name son opcionales. Pushwoosh utiliza primero los metadatos. Si alguno de ellos falta en los metadatos, se toma de Stripe cuando esté disponible. Si ninguna de las fuentes tiene un valor, el campo no se almacena.

Pasar metadatos a través de la Sesión de Checkout

Los metadatos se pasan al crear una Sesión de Checkout dependiendo del tipo de pago:

Tipo de pago	Parámetro	Evento de Stripe
Pago único (mode=payment)	payment_intent_data[metadata]	charge.succeeded
Suscripción (mode=subscription)	subscription_data[metadata]	invoice.paid

Prioridad de los metadatos durante el procesamiento

Para suscripciones (evento invoice.paid):

Metadatos de la factura → si están vacíos → Metadatos de la suscripción

Para pagos únicos (evento charge.succeeded):

Metadatos del cargo (de payment_intent_data)

Creación de una sesión de checkout a través de la API de Stripe (curl)

Pago único (mode=payment)

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_live_YOUR_SECRET_KEY: \
  -d "mode=payment" \
  -d "success_url=https://example.com/success" \
  -d "cancel_url=https://example.com/cancel" \
  -d "line_items[0][price]=price_1234567890" \
  -d "line_items[0][quantity]=1" \
  -d "payment_intent_data[metadata][journey_uuids]=bfab4bc0-b0a5-414b-befc-4aaddc429b0e" \
  -d "payment_intent_data[metadata][user_id]=user_12345" \
  -d "payment_intent_data[metadata][device_id]=hwid_abc123" \
  -d "payment_intent_data[metadata][product_id]=prod_premium" \
  -d "payment_intent_data[metadata][product_name]=Premium Plan"

Suscripción (mode=subscription)

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_live_YOUR_SECRET_KEY: \
  -d "mode=subscription" \
  -d "success_url=https://example.com/success" \
  -d "cancel_url=https://example.com/cancel" \
  -d "line_items[0][price]=price_monthly_premium" \
  -d "line_items[0][quantity]=1" \
  -d "subscription_data[metadata][journey_uuids]=bfab4bc0-b0a5-414b-befc-4aaddc429b0e" \
  -d "subscription_data[metadata][user_id]=user_12345" \
  -d "subscription_data[metadata][device_id]=hwid_abc123" \
  -d "subscription_data[metadata][product_name]=Monthly Premium"

Ver datos

Después de una integración exitosa, aparece un nuevo panel de Resumen financiero en la sección de Paneles de control. Allí puedes ver las estadísticas de Ingresos brutos y Nuevas suscripciones desglosadas por campañas (journey).

Para obtener información más detallada, visita tu Panel de control de Stripe.

Crear segmentos basados en pagos

Usa los eventos de Stripe para crear segmentos de usuarios:

1. Abre Audiencia → Segmentos.
2. Haz clic en Crear Segmento para abrir el constructor de segmentos.
3. En Añadir filtro por, haz clic en Evento.
4. Selecciona un evento de Stripe del menú desplegable (consulta la tabla a continuación para ver los eventos disponibles).

Nota

Los eventos de Stripe aparecen en la lista después de que la integración se conecta y se reciben los datos de pago.

5. Establece la condición: cuántas veces ocurrió el evento y el período de tiempo (p. ej., durante los últimos 30 días, entre fechas).
6. Opcionalmente, acota el segmento por atributos de evento. La siguiente tabla enumera los atributos disponibles para cada evento.

Evento	Descripción	Atributos
StripePaymentSucceeded	Pago exitoso	__amount, __currency, invoice_id, journey_uuids, product_id, product_name, stripe_customer_id, subscription_id
StripeInvoicePaid	Factura de suscripción pagada	__amount, __currency, journey_uuids, product_id, product_name, stripe_customer_id, transaction_id, transaction_type
StripeSubscriptionCreated	Suscripción creada	__amount, __currency, interval, journey_uuids, product_id, product_name, status, stripe_customer_id, subscription_id

7. Para añadir más eventos, añade otro filtro de Evento y elige un operador (Y u O) entre las condiciones.

Aprende más sobre la creación de segmentos.

Consejo

También puedes mapear StripePaymentSucceeded (__amount, __currency, product_id) o StripeInvoicePaid (__amount, __currency, transaction_id, product_id) como fuente para Eventos de conversión, para incorporar los ingresos de Stripe en la segmentación RFM, la atribución de journeys y ManyMoney AI junto con tus otras fuentes de ingresos.

Asistente de IA ManyMoney

Después de una integración exitosa con Stripe, el asistente de IA ManyMoney obtiene acceso automáticamente a las estadísticas de pagos y suscripciones.

ManyMoney está disponible en la interfaz del Panel de control. Después de conectar Stripe, los datos de pago están disponibles para su análisis automáticamente. No se requiere configuración adicional.

Qué puede hacer ManyMoney

• Analizar ingresos: responde preguntas sobre ingresos, conversiones y efectividad de las campañas.
• Comparar períodos: muestra la dinámica de pagos y suscripciones en diferentes intervalos de tiempo.
• Identificar tendencias: detecta productos y segmentos de audiencia en crecimiento y en declive.
• Proporcionar recomendaciones: sugiere optimizaciones basadas en los datos de pago.

Ejemplos de prompts

• ¿Qué ingresos generó la campaña el mes pasado?
• Compara las tasas de conversión de suscripciones entre enero y febrero
• Muestra estadísticas de reembolsos