Guía de integración de Stripe Apps
Las Stripe Apps te permiten incorporar funcionalidades personalizadas directamente en el panel de Stripe, dando a los comerciantes acceso a la integración Tajo-Brevo sin salir de su flujo de pagos. Esta guía cubre todo lo necesario para crear, probar y publicar una Stripe App que conecte Stripe con Brevo a través de Tajo.
Tip
El objetivo es publicar una integración con Brevo en el Stripe App Marketplace, permitiendo a los comerciantes de Stripe sincronizar datos de clientes, pedidos y eventos directamente en Brevo para automatización de marketing y CRM.
¿Qué son las Stripe Apps?
Las Stripe Apps extienden el panel de Stripe con componentes UI personalizados e integraciones backend. Permiten a los desarrolladores externos:
- Agregar vistas personalizadas a las páginas del panel de Stripe (clientes, pagos, facturas, etc.)
- Acceder a datos de Stripe mediante permisos controlados
- Sincronizar datos entre Stripe y plataformas externas como Brevo
- Proporcionar flujos de onboarding y configuración dentro del panel
Objetivos de integración Tajo + Brevo
La app Tajo para Stripe conecta Stripe con Brevo para ofrecer:
- Inteligencia de clientes: Sincronización de perfiles de clientes, historial de pagos y valor de vida con contactos Brevo
- Seguimiento de eventos: Envío de eventos Stripe como eventos transaccionales en Brevo
- Campañas automatizadas: Activación de campañas de email, SMS y WhatsApp en Brevo
- Programas de fidelización: Flujos de retención usando datos de compras Stripe sincronizados con Brevo
Contenido de la guía
| Guía | Descripción |
|---|---|
| Publicar en el Marketplace | Requisitos y pasos para enviar tu app |
| Requisitos de revisión | Estándares de calidad, seguridad y UX |
| Referencia del App Manifest | Esquema completo del archivo stripe-app.json |
| Referencia de permisos | Lista completa de permisos de Stripe API |
| Referencia de Viewports | Ubicaciones del panel donde puede aparecer la UI de tu app |
| Apps Stripe embebidas | Componentes Connect embebidos para integraciones de plataforma |
| Enlaces de instalación y deep links | Generar URLs de instalación y deep links |
| Acciones post-instalación | Configurar flujos de onboarding tras la instalación |
| Analytics de la app | Rastrear instalaciones y métricas de conversión |
| Ecosistema de socios | Programa de socios Stripe para co-marketing |
Requisitos previos
- Cuenta Stripe: Una cuenta Stripe activada (no restringida al modo de prueba)
- Stripe CLI: Instalar la Stripe CLI para desarrollo local
- Node.js: Versión 16 o posterior
- Acceso a la plataforma Tajo: Cuenta Tajo activa con credenciales API de Brevo configuradas
Inicio rápido
brew install stripe/stripe-cli/stripestripe loginstripe apps create tajo-brevo-integrationstripe apps startCaution
Stripe requiere que las apps estén escritas en inglés para la distribución en el marketplace.