# Stripe + Brew

Sincroniza los clientes de Stripe con la audiencia de la marca, activa automatizaciones con 22 eventos de Stripe y lanza emails de ciclo de vida ya preparados (bienvenida, fin de la prueba, recuperación de pagos fallidos y recuperación de clientes).

URL canónica: https://brew.new/es/browse/integrations/stripe

- Dirección: Entrada de datos
- Conexión: OAuth
- Sincronización de clientes + disparadores por eventos

## Funciones disponibles

- **Disparadores por eventos**: Activa automatizaciones de Brew con 22 eventos de Stripe que abarcan suscripciones, facturas, checkouts, presupuestos, cargos, reembolsos e intentos de pago.
- **Sincronizar contactos**: Sincroniza los clientes de Stripe con la audiencia de la marca, con campos personalizados `stripe_*` disponibles como atributos filtrables.
- **Importación masiva de clientes**: Importa en un clic todos los clientes de Stripe a la marca activa. La importación se puede reanudar y es duradera gracias a Vercel Workflow.
- **Plantillas de emails de ciclo de vida**: Plantillas iniciales de bienvenida, fin de la prueba, recuperación de pagos fallidos y recuperación de clientes.

## Convierte los eventos de facturación en emails útiles

Conecta Stripe con OAuth para activar emails fieles a tu marca cuando empieza una suscripción, una prueba está a punto de terminar o falla el pago de una factura. Brew registra el webhook y pone los eventos compatibles a tu disposición como disparadores de automatizaciones.

Stripe sigue encargándose de los pagos, los reintentos, los reembolsos y los cambios de suscripción. Brew crea y envía los emails.


## Qué puedes crear

- Recordatorios de fin de prueba: usa el evento customer.subscription.trial_will_end para explicar qué pasa después y enlazar a tu página de planes o de facturación.
- Avisos de pago fallido: usa el evento invoice.payment_failed para enviar un aviso a tiempo con un enlace a tu propia página de facturación. Coordínalo con los emails a clientes que envía Stripe para que el mismo aviso no salga dos veces.
- Emails de bienvenida para suscriptores: parte del evento customer.subscription.created o del checkout.session.completed, y elige un solo disparador para no enviar bienvenidas duplicadas.
- Emails de cambio de plan: el evento customer.subscription.updated puede aportar los campos previousPlan y newPlan cuando el evento los incluye.
- Confirmaciones de pago: el evento invoice.paid se emite cuando se paga una factura. Usa amount, currency e invoiceNumber como etiquetas de combinación.
- Avisos de renovación: el evento invoice.upcoming se emite antes de que Stripe cree la siguiente factura de una suscripción e incluye amount y currency. Su payload no trae la fecha de renovación, así que enlaza a tu página de facturación para los detalles.
- Seguimiento tras una cancelación: el evento customer.subscription.deleted se emite cuando una suscripción se cancela o se elimina. Una suscripción nueva no detiene una ejecución que ya está en curso, así que añade una condición sobre contact.stripe_subscription_status antes de cada email posterior.
- Avisos de pausa y reanudación: los eventos customer.subscription.paused y customer.subscription.resumed sirven para confirmar el cambio al suscriptor.
- Resultados de pagos diferidos: los eventos checkout.session.async_payment_succeeded y checkout.session.async_payment_failed indican cómo se resolvió un método de pago diferido después del checkout. paymentStatus y sessionMode están disponibles como etiquetas de combinación.
- Recordatorios de checkout abandonado: Brew no tiene un disparador para las sesiones de Checkout caducadas. Dispara tu propio evento personalizado cuando tu aplicación detecte que una sesión ha caducado.
- Confirmaciones de reembolso: el evento refund.created incluye refundAmount, refundCurrency, refundReason y refundStatus del reembolso concreto. El evento charge.refunded solo incluye totales a nivel de cargo, como amountRefunded.
- Seguimiento de presupuestos: los eventos quote.finalized, quote.accepted y quote.canceled incluyen el importe, la moneda y el estado del presupuesto. No hay ningún campo con el enlace al presupuesto, así que dirige al comprador a tu propia página.
- Pagos únicos fallidos: el evento payment_intent.payment_failed incluye failureCode, failureMessage y declineCode, para que el email pueda reflejar por qué falló el pago.

## Un seguimiento de pagos fallidos que comprueba el estado actual

Empieza con un email activado por el evento invoice.payment_failed. Para un recordatorio posterior, haz que tu aplicación programe una nueva comprobación del estado de la factura en Stripe. Dispara un evento personalizado de Brew aparte solo si la factura sigue sin pagarse y el cliente aún cumple los requisitos.

Tras un paso de Espera, los campos del evento siguen conteniendo el payload original del evento. Una condición contact.stripe_subscription_status lee el valor actual del campo en el contacto de Brew cuando se ejecuta ese nodo. No consulta Stripe ni demuestra que se haya pagado una factura concreta. Las actualizaciones del contacto y los nuevos eventos de pago no cancelan automáticamente una ejecución anterior. Actualizar una tarjeta tampoco demuestra que se haya pagado.

Prueba las dos rutas: un cliente cuya factura sigue sin pagarse, y que aún cumple los requisitos, recibe el recordatorio; un cliente que paga antes de la comprobación programada, no. Prueba los reintentos con el contrato de idempotencia documentado.


## Configura Stripe en Brew

- Abre Integraciones, elige Stripe y selecciona Conectar. Autoriza el acceso con el OAuth de Stripe.
- Brew aprovisiona el webhook y 22 tipos de evento compatibles. No hay ningún interruptor para activar o desactivar eventos.
- Para importar los clientes que ya tienes, abre Gestionar y elige Sincronizar clientes de Stripe. Un registro de cliente no basta por sí solo para acreditar el consentimiento para emails de marketing.
- Crea una automatización y selecciona su evento de Stripe. Revisa el destinatario, los campos del payload, el contenido del email y los enlaces de facturación.
- Brew conecta cuentas reales de Stripe, y los eventos del modo de prueba no sincronizan contactos ni inician automatizaciones. Deja la automatización como borrador y pruébala con destinatarios controlados antes de publicarla. Cuando llega un evento que coincide, solo se ejecutan las automatizaciones activas.
- Un agente puede crear, probar y publicar automatizaciones a través del MCP de Brew o de la API, después de que una persona autorizada conecte la cuenta de Stripe en la app.

## Eventos de Stripe compatibles

Brew admite 22 tipos de evento:

- checkout.session.async_payment_succeeded
- checkout.session.async_payment_failed
- checkout.session.completed
- customer.created
- customer.updated
- customer.deleted
- customer.subscription.created
- customer.subscription.updated
- customer.subscription.paused
- customer.subscription.resumed
- customer.subscription.trial_will_end
- customer.subscription.deleted
- invoice.created
- invoice.paid
- invoice.payment_failed
- invoice.upcoming
- quote.finalized
- quote.accepted
- quote.canceled
- charge.refunded
- refund.created
- payment_intent.payment_failed

## Sincronización de clientes y personalización

Los eventos de clientes y de suscripciones pueden actualizar los contactos de Brew con datos de facturación. Entre los campos de contacto disponibles están stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end y stripe_delinquent. Su disponibilidad depende del evento de Stripe y de los datos recibidos.

Usa el esquema de payload declarado del evento seleccionado para las etiquetas de combinación. Según el evento, los campos incluyen firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan y failureMessage. Los importes están en centavos cuando el esquema así lo indica.

Los identificadores de objetos de Stripe se eliminan de los payloads de las automatizaciones. No des por hecho que puedes usar los ID de factura o de suscripción como etiquetas de combinación. Brew tampoco guarda en el contacto el ID de cliente de Stripe.

La opción Sincronizar el nombre completo, que se configura por evento, controla si Stripe puede actualizar el nombre del contacto. No activa ni desactiva ningún disparador.


## ¿Puedo detener un recordatorio cuando el cliente ya ha pagado?

Un evento de pago posterior no cancela automáticamente una ejecución iniciada por un fallo anterior. Programa una comprobación desde tu aplicación antes del recordatorio y dispara un evento nuevo solo mientras la factura siga sin pagarse.


## ¿Por qué aparece un evento sin que se envíe ningún email?

Recibir un evento y enviar un email son pasos distintos. Confirma que haya una automatización coincidente activa, revisa sus filtros y su historial de ejecuciones, y comprueba que el destinatario pueda recibir el email y el estado del dominio de envío. La opción Sincronizar el nombre completo solo controla las actualizaciones del nombre.


## Límites y solución de problemas

- Brew no puede crear cargos, emitir reembolsos ni modificar suscripciones de Stripe.
- Si un evento aparece en la pestaña Eventos de Gestionar pero no llega ningún email, comprueba que la automatización vinculada esté activa y revisa sus filtros, su historial de ejecuciones, el destinatario y si el dominio de envío está listo.
- Si los errores de firma del webhook persisten, vuelve a conectar Stripe para aprovisionar un secreto de webhook nuevo.
- Usa el evento refund.created cuando el email necesite campos específicos del reembolso; confirma qué campos hay disponibles en el esquema del disparador.
- Revisa el consentimiento y la finalidad de cada email. Importar contactos de facturación no autoriza a hacer envíos promocionales.

## Fuentes y guías de configuración

- [Crea un flujo de emails de ciclo de vida con Stripe](/es/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events)
- [Compara integraciones de email con Stripe](/es/blog/best-email-marketing-tools-with-stripe-integration-subscription-events-and-automation-compared)
- [Guía de configuración de Stripe](https://docs.brew.new/integrations/import/stripe)
- [Crea una automatización](https://docs.brew.new/create-emails/build-an-automation)
- [Etiquetas de combinación](https://docs.brew.new/create-emails/merge-tags)
- [Referencia de eventos de Stripe](https://docs.stripe.com/api/events/types)
- [Configuración de los emails a clientes de Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails)

## Relacionado

- [Todas las integraciones](https://brew.new/es/browse/integrations.md)
- [Crear cuenta](https://brew.new/es/sign-up.md)
- Sitio web: https://brew.new
