Primeros pasos con Stripe

Objetivos del artículo

Aprende a integrar Stripe con Klaviyo para personalizar y dirigir correos electrónicos en función de los datos de facturación y pago de tus clientes.

Configurarás la integración de Stripe en 2 pasos. Primero, conecta tu cuenta de Stripe a Klaviyo. Luego, configura webhooks en Stripe y completa la configuración en Klaviyo para sincronizar los datos de facturas y pagos en tiempo real.

Aquí tienes una descripción general de los datos que sincronizamos desde Stripe:

• Cuando se emite una factura y los artículos incluidos en cada factura
• Información de pago para cuando un usuario no puede completar el pago, recibe un reembolso o paga correctamente

Conectar tu cuenta de Stripe

Antes de comenzar, asegúrate de tener una cuenta activa de Stripe y permiso para administrar integraciones en Klaviyo.

1. En Klaviyo, selecciona la pestaña Integraciones.
2. Selecciona Explorar aplicaciones, busca Stripe y haz clic en la tarjeta.
3. Entonces haz clic en Instalar.
4. Haz clic en Conectar con Stripe. Esto te llevará al sitio web de Stripe. Inicia sesión si es necesario.
5. Selecciona la cuenta de Stripe que deseas conectar a Klaviyo y haz clic en Conectar.
   

6. Copia la URL de webhook en Configuración de webhook. Mantén esta página abierta mientras creas el webhook en Stripe.

Configura webhooks de Stripe

Ahora configuraremos tus webhook de Stripe, lo que te permitirá sincronizar tus datos de Stripe en tiempo real.

1. Abre Stripe en una nueva pestaña. Usa las instrucciones de Stripe para crear un punto de conexión de webhook con la configuración que se indica a continuación.
2. Selecciona Tu cuenta y elige el formato de carga útil de Snapshot.

3. Usa la siguiente configuración para el punto de conexión:
   • URL del punto de conexión
     Pega la URL que acabas de copiar de Klaviyo.
   • Versión de la interfaz de programación de aplicaciones (API)
     Selecciona la versión más reciente de la interfaz de programación de aplicaciones (API).
   • Eventos
     Selecciona todos los eventos de charge y invoice para este punto de conexión. Si lo deseas, puedes omitir todos los eventos de charge.dispute. Incluye los siguientes eventos:
     • charge.captured
     • charge.expired
     • charge.failed
     • charge.pending
     • charge.refunded
     • charge.succeeded
     • charge.updated
     • invoice.created
     • invoice.deleted
     • factura.finalizada
     • invoice.marked_uncollectible
     • invoice.payment_action_required
     • invoice.payment_failed
     • invoice.payment_succeeded
     • invoice.sent
     • invoice.upcoming
     • invoice.updated
     • invoice.voided
4. Termina de crear y habilitar el punto de conexión en Stripe.

5. Confirma que el punto de conexión esté habilitado en Stripe.

6. Para verificar los webhooks de Stripe (recomendado), copia el secreto de firma del punto de conexión que acabas de crear en Stripe. Vuelve a Klaviyo y pégalo en Signing secret en Verify Stripe webhooks (Recommended). Esto agrega un nivel adicional de seguridad a tus integraciones.
7. Haz clic en Completar la configuración.

La integración con Stripe ya está habilitada y los datos históricos empezarán a sincronizarse.

Ver datos sincronizados desde Stripe

Klaviyo importa hasta 5 años de historial de facturas y pagos. Para revisar el progreso, abre Stripe desde integraciones y selecciona Datos. Espera a que termine la sincronización del historial antes de comparar los totales.

Para revisar tu integración habilitada:

1. Haz clic en el menú desplegable Análisis en Klaviyo y selecciona Métricas.
2. Busca y selecciona la métrica Successfully Paid de Stripe y, después, selecciona Activity feed.

3. Verifica que los eventos de pago exitosos aparezcan en el feed. Solo los pagos con una dirección de correo electrónico válida se sincronizan con Klaviyo.
4. Por ejemplo, haz clic en el encabezado Gráfico de la métrica Pagado correctamente. Este gráfico muestra los últimos 30 días de datos de forma predeterminada. Coloca el cursor sobre el punto de datos de ayer o consulta la tabla de datos debajo de la gráfica para ver cuántos pagos tuviste ayer. Compara ese número con Stripe para la misma fecha y zona horaria, teniendo en cuenta los pagos que no tienen direcciones de correo electrónico válidas.
5. Si los totales difieren, revisa que la sincronización histórica haya finalizado y que los pagos tengan direcciones de correo electrónico válidas. También compara las zonas horarias que se usan en Klaviyo y Stripe. Para revisar la configuración de zona horaria en Klaviyo:
   • Haz clic en el nombre de tu cuenta en la parte inferior izquierda.
   • Selecciona Configuración, luego General > Cuenta.
   • Desplázate hacia abajo hasta zona horaria.

Las métricas de Stripe

Stripe sincroniza las siguientes métricas con Klaviyo:

• Error en el pago
• Factura emitida
• Pago reembolsado
• Pago Realizado Correctamente

Error en el pago

Esta métrica se registra cada vez que un pago realizado a través de Stripe se marca como fallido. Usa esta métrica para segmentar a los clientes con pagos fallidos y avisarles que tienen un saldo vencido. Puedes filtrar y segmentar eventos de Pago fallido con detalles como Moneda y Motivo. Estos eventos incluyen la siguiente información:

• AttemptCount
  La cantidad de intentos de pago de la factura asociada. Se incluye cuando el pago está vinculado a una factura.
• Moneda
  La moneda del pago fallido, por ejemplo, USD, GBP.
• Factura
  La factura a la que está vinculado este pago fallido en Stripe, cuando esté disponible.
• Motivo
  El motivo en Stripe por el que falló este pago, por ejemplo: Tu tarjeta venció, Tu tarjeta fue rechazada.

Factura emitida

Esta métrica se registra cada vez que se emite una factura a tus clientes a través de Stripe. Usa esta métrica para segmentar a los clientes a quienes se les emitió una factura, pero que no han pagado o cuyo pago falló. También se puede usar para activar un flujo y notificar a los clientes sobre un próximo pago.

Pago reembolsado

Esta métrica registra un evento cuando reembolsas un pago a través de Stripe. Puedes filtrar y dirigir los eventos de pago reembolsado en función de los siguientes criterios:

• Monto
  El valor del pago que se reembolsó.

Pago Realizado Correctamente

Esta métrica se registra cada vez que un cliente realiza correctamente un pago a través de Stripe, esté o no vinculado a una factura. Estos eventos incluyen datos de pago y, cuando están presentes, la factura asociada y sus partidas. Usa esta métrica para enviar recibos automatizados de facturas a los clientes después de que paguen, o úsala junto con los datos de actividad del sitio web en flujos de correo electrónico para identificar a los clientes que han estado con actividad en el sitio web, pero no han realizado pagos por tus productos o servicios. Después, puedes enviarles correos electrónicos a esos usuarios con descuentos para que hagan una compra en el sitio web.

Puedes filtrar y segmentar eventos pagados correctamente por Moneda. Estos eventos incluyen la siguiente información:

• Moneda
  La moneda del pago, por ejemplo, USD, GBP.
• Factura
  La factura a la que está vinculado este pago en Stripe, cuando está disponible.

datos de clientes

Para esta integración, Klaviyo identifica a los clientes por su dirección de correo electrónico. Si Stripe sincroniza los datos del cliente con una nueva dirección de correo electrónico, Klaviyo creará un nuevo perfil que conste de la dirección de correo electrónico del cliente y las métricas de Stripe asociadas. Cuando un pago incluye detalles de la tarjeta, la fecha de vencimiento de la tarjeta se almacena en la propiedad personalizada Fecha de vencimiento de la tarjeta de Stripe en el perfil del cliente.

Usa datos de Stripe en Klaviyo

Usa una métrica de Stripe para activar un flujo. Puedes acotar el flujo con filtros de activación, como un filtro de Moneda, y personalizar los mensajes con datos del evento que lo activa.

Facturas automatizadas

Puedes enviar automáticamente recibos de factura a tus clientes después de que realicen un pago configurando un flujo de facturas, activado por la métrica Successfully Paid de Stripe.

Este flujo puede rellenar automáticamente un correo electrónico que muestra detalles de pago dinámicos usando etiquetas de plantilla que hacen referencia a atributos de pago de Stripe.

Para obtener más información sobre cómo insertar datos dinámicos en una plantilla de correo electrónico, consulta nuestro artículo sobre usar datos de eventos para personalizar mensajes de flujo.

Flujo de pagos fallidos de Stripe

Avisa a tus clientes sobre un pago fallido con un flujo automatizado, activado por la métrica Failed Payment de Stripe.

Guía de solución de problemas

No veo que toda la actividad de Stripe se sincronice con Klaviyo.

Un pago o una factura de Stripe debe tener una dirección de correo electrónico válida para sincronizarse con Klaviyo. Para pagos, revisa la dirección de correo electrónico del cliente de Stripe; si falta, Klaviyo usa el correo electrónico que aparece en los datos de facturación del pago. Para facturas, Klaviyo usa el correo electrónico del cliente en la factura y, si falta, usa el correo electrónico del cliente de Stripe. Si la dirección de correo electrónico que Klaviyo selecciona falta o no es válida, el evento no se sincronizará.

Ten en cuenta que las entradas de nombre y apellido no necesariamente son consistentes ni únicas, por lo que no creamos perfiles basados solo en esta información. Hacerlo podría generar duplicados y un seguimiento impreciso.

Si, incluso con direcciones de correo electrónico asociadas, aún no ves que los datos de Stripe se sincronicen con Klaviyo, comunícate con nuestro equipo de soporte.

Resultado

Ya integraste Stripe con Klaviyo y aprendiste a usar tus datos sincronizados.

Recursos adicionales