Guía de integración con Stripe Apps

Las Stripe Apps te permiten integrar funcionalidad propia directamente en el panel de control de Stripe. Esta sección es una guía de construcción: documenta cómo se construiría, se probaría y se publicaría una app así para la integración de Tajo y Brevo.

¿Qué son las Stripe Apps?

Las Stripe Apps amplían el panel de control de Stripe con componentes de UI propios e integraciones de backend. Permiten que los desarrolladores externos puedan:

• Añadir vistas propias a las páginas del panel de control de Stripe (clientes, pagos, facturas, etc.)
• Acceder a los datos de Stripe mediante permisos acotados
• Sincronizar datos entre Stripe y plataformas externas como Brevo
• Ofrecer flujos de onboarding y de configuración dentro del panel de control

Objetivos de la integración de Tajo + Brevo

La Stripe App de Tajo conecta Stripe con Brevo para ofrecer:

• Inteligencia de clientes: sincroniza los perfiles de cliente, el historial de pagos y el valor de vida de Stripe en los contactos de Brevo
• Seguimiento de eventos: envía los eventos de Stripe (pagos, suscripciones, reembolsos) como eventos transaccionales de Brevo
• Campañas automatizadas: activa campañas de email, SMS y WhatsApp en Brevo a partir de la actividad en Stripe
• Programas de fidelización: crea flujos de trabajo de retención con los datos de compra de Stripe sincronizados en Brevo

Resumen de la arquitectura

Contenido de la guía

Esta documentación cubre todo el ciclo de vida de crear y publicar una Stripe App:

Primeros pasos

Configuración y referencia

Funciones e integración

Operaciones y crecimiento

Requisitos previos

Antes de crear una Stripe App, asegúrate de tener:

1. Cuenta de Stripe: una cuenta de Stripe activada (no limitada al modo de prueba)
2. Stripe CLI: instala la Stripe CLI para el desarrollo local y la subida de apps
3. Node.js: versión 16 o posterior para la extensión de UI de la app
4. Acceso a la plataforma Tajo: cuenta de Tajo activa con las credenciales de la API de Brevo configuradas

Inicio rápido

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

Conceptos clave

El manifiesto de la app

Cada Stripe App tiene un manifiesto stripe-app.json que declara permisos, viewports y configuración. Consulta la referencia del manifiesto de la app para ver el esquema completo.

Extensiones de UI

Las Stripe Apps pueden renderizar componentes de UI basados en React en viewports concretos del panel de control. El kit de UI ofrece componentes ya creados que encajan con el sistema de diseño del panel de control de Stripe.

Permisos

Las apps deben declarar los recursos concretos de la API de Stripe a los que necesitan acceder. Los usuarios aprueban esos permisos durante la instalación. Consulta la referencia de permisos.

Secreto de firma

Cada app recibe un secreto de firma para verificar las firmas de instalación y proteger la comunicación entre tu backend y Stripe.

Flujo de desarrollo

1. Define tu manifiesto con los permisos y los viewports necesarios
2. Crea la extensión de UI con la biblioteca de componentes React de Stripe
3. Implementa los endpoints de backend para la sincronización de datos con Brevo a través de Tajo
4. Prueba en local con stripe apps start
5. Sube la app con stripe apps upload
6. Envía la app a revisión desde el panel de control de Stripe
7. Publica y haz seguimiento con la analítica

Siguientes pasos

Empieza con la guía de publicación para entender todos los requisitos y después recorre las referencias técnicas para configurar el manifiesto y los permisos de tu app.