---
title: "Guía de integración con Stripe Apps | Tajo"
description: "Estado: planificada, no construida. Esta sección es una guía de construcción. Tajo no tiene ninguna Stripe App, y hoy no se puede instalar nada de aquí."
url: https://tajo.io/es/docs/stripe-apps/
markdown: https://tajo.io/es/docs/stripe-apps.md
lang: es-ES
author: "Set Noa"
author_url: https://tajo.io/es/set-noa/
robots: noindex
---

Solicita acceso anticipado

Escribe tu nombre y dirección de correo de trabajo. Te enviaremos un enlace para confirmar tu solicitud de acceso a Tajo.

# Guía de integración con Stripe Apps

[Set Noa](https://tajo.io/es/set-noa/)

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.

Caution

**Estado: planificada, no construida.** Tajo no tiene ninguna Stripe App, así que hoy no se puede instalar nada de esta sección, y los identificadores de app, las URLs y las credenciales de estas páginas son marcadores de posición ilustrativos, no endpoints reales. Para conectar Stripe con Tajo ahora mismo, usa el [conector de Stripe](https://tajo.io/docs/connectors/stripe/) (clave de API restringida, sincronización de solo lectura).

Tip

El objetivo es publicar una **integración con Brevo** en el Stripe App Marketplace, para que los comercios de Stripe puedan sincronizar datos de clientes, pedidos y eventos directamente en Brevo para la automatización de marketing y el CRM.

## ¿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

*Adónde van los datos de una Stripe App. El panel de control de Stripe y Tajo intercambian datos de clientes y de pagos, y Tajo sincroniza contactos, campañas y automatizaciones con Brevo.*

## Contenido de la guía

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

### Primeros pasos

| Guía | Descripción |
| --- | --- |
| [Publicar en el Marketplace](https://tajo.io/es/docs/stripe-apps/publish-app) | Requisitos y pasos para enviar tu app a revisión |
| [Requisitos de revisión de apps](https://tajo.io/es/docs/stripe-apps/review-requirements) | Estándares de calidad, seguridad y UX para conseguir la aprobación |

### Configuración y referencia

| Guía | Descripción |
| --- | --- |
| [Referencia del manifiesto de la app](https://tajo.io/es/docs/stripe-apps/app-manifest) | Esquema completo del archivo de manifiesto `stripe-app.json` |
| [Referencia de permisos](https://tajo.io/es/docs/stripe-apps/permissions) | Lista completa de permisos de la API de Stripe y cómo solicitarlos |
| [Referencia de viewports](https://tajo.io/es/docs/stripe-apps/viewports) | Lugares del panel de control donde puede aparecer la UI de tu app |

### Funciones e integración

| Guía | Descripción |
| --- | --- |
| [Stripe Apps embebidas](https://tajo.io/es/docs/stripe-apps/embedded-apps) | Uso de componentes embebidos de Connect para integraciones de plataforma |
| [Enlaces de instalación y deep links](https://tajo.io/es/docs/stripe-apps/install-links) | Genera URLs de instalación y enlaces directos a vistas concretas de la app |
| [Acciones posteriores a la instalación](https://tajo.io/es/docs/stripe-apps/post-install) | Configura flujos de onboarding después de instalar la app |

### Operaciones y crecimiento

| Guía | Descripción |
| --- | --- |
| [Analítica de la app](https://tajo.io/es/docs/stripe-apps/analytics) | Haz seguimiento de instalaciones, vistas y métricas de conversión |

## 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

```bash
# 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](https://tajo.io/es/docs/stripe-apps/app-manifest) 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](https://tajo.io/es/docs/stripe-apps/permissions).

### 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

Caution

Stripe exige que las apps estén escritas en inglés para distribuirlas en el marketplace. La ficha de tu app, los textos de la UI y la documentación deben estar todos en inglés.

## Siguientes pasos

Empieza con la [guía de publicación](https://tajo.io/es/docs/stripe-apps/publish-app) para entender todos los requisitos y después recorre las referencias técnicas para configurar el manifiesto y los permisos de tu app.