---
title: "Publicar en el Stripe App Marketplace | Tajo"
description: "Guía paso a paso para preparar, enviar y publicar tu Stripe App en el marketplace"
url: https://tajo.io/es/docs/stripe-apps/publish-app/
markdown: https://tajo.io/es/docs/stripe-apps/publish-app.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.

# Publicar en el Stripe App Marketplace

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

Publicar tu Stripe App en el marketplace la pone a disposición de todos los usuarios de Stripe. Esta guía cubre los requisitos, los pasos de preparación y el proceso de envío.

Caution

**Estado: planificada, no construida.** Tajo no tiene ninguna Stripe App, así que hoy no se puede instalar nada de esta sección. Los identificadores de app, las URLs y las credenciales de esta página son marcadores de posición ilustrativos, no endpoints reales.

## Requisitos previos

Antes de poder publicar una app en el Stripe App Marketplace, debes cumplir estos requisitos:

- **Cuenta de Stripe activada**: tu cuenta no puede estar limitada solo al modo de prueba
- **Una app por cuenta**: cada cuenta de Stripe solo puede publicar una app pública en el marketplace
- **Solo en inglés**: todo el contenido de la app, los textos de la interfaz y la información de la ficha deben estar en inglés
- **App terminada**: tu app debe ser plenamente funcional y estar probada

Caution

Si necesitas publicar varias apps, tendrás que crear una cuenta de Stripe distinta para cada una.

## Pasos para publicar

### Paso 1: actualiza tu manifiesto

Cambia el valor de `distribution_type` en tu `stripe-app.json` a `public`:

```json
{
  "id": "com.tajo.brevo-integration",
  "version": "1.0.0",
  "name": "Tajo Brevo Integration",
  "icon": "./icon.png",
  "distribution_type": "public",
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Sync customer data to Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    },
    {
      "permission": "event_read",
      "purpose": "Track payment and subscription events for Brevo automation"
    }
  ]
}
```

### Paso 2: prepara tu app

Comprueba que tu app cumple todos los [requisitos de revisión](https://tajo.io/es/docs/stripe-apps/review-requirements) antes de enviarla:

1. Pruébala a fondo tanto en modo live como en sandbox
2. Verifica que todos los permisos son necesarios y están documentados
3. Confirma que la gestión de errores y los estados de carga están implementados
4. Comprueba que todos los textos de la interfaz están en inglés

### Paso 3: sube tu app

Usa la CLI de Stripe para subir tu app:

```bash
# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list
```

### Paso 4: redacta tu ficha

Ve al panel de control de Stripe para completar la ficha de tu app. Todos los campos de la ficha son obligatorios para el envío al marketplace.

### Paso 5: envía la app a revisión

Una vez completada la ficha, envía la app a revisión desde el panel de control de Stripe. El equipo de Stripe la evaluará según los [requisitos de calidad](https://tajo.io/es/docs/stripe-apps/review-requirements).

### Paso 6: publica

Cuando la app esté aprobada, podrás publicarla para que aparezca en el marketplace.

## Configuración del manifiesto para distribución pública

El manifiesto debe incluir `distribution_type: "public"` y declarar todos los permisos necesarios con descripciones claras de su finalidad:

```json
{
  "id": "com.tajo.brevo-integration",
  "version": "1.2.0",
  "name": "Tajo for Brevo",
  "icon": "./assets/icon.png",
  "distribution_type": "public",
  "stripe_api_access_type": "oauth",
  "allowed_redirect_uris": [
    "https://tajo.io/stripe/callback"
  ],
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Write sync metadata to customer records"
    },
    {
      "permission": "charge_read",
      "purpose": "Access payment data for Brevo event tracking"
    },
    {
      "permission": "event_read",
      "purpose": "Read Stripe events so a sync picks up changes"
    },
    {
      "permission": "product_read",
      "purpose": "Sync product catalog to Brevo for campaign personalization"
    },
    {
      "permission": "invoice_read",
      "purpose": "Track invoice events for Brevo transactional emails"
    }
  ],
  "ui_extension": {
    "views": [
      {
        "viewport": "stripe.dashboard.customer.detail",
        "component": "CustomerDetailView"
      },
      {
        "viewport": "stripe.dashboard.home.overview",
        "component": "OverviewView"
      }
    ]
  },
  "post_install_action": {
    "type": "onboarding"
  }
}
```

Sube la app ya configurada con:

```bash
stripe apps upload
```

## Requisitos de la ficha

La ficha de tu app debe incluir todos estos campos:

| Campo | Requisitos | Detalles |
| --- | --- | --- |
| **Nombre** | Máximo 35 caracteres | El nombre visible que se muestra en el marketplace |
| **Icono** | 300x300 píxeles, PNG o SVG | Icono cuadrado, sin esquinas redondeadas (Stripe las añade) |
| **Desarrollado por** | Nombre de la empresa o del desarrollador | Se muestra debajo del nombre de la app |
| **Categoría** | A elegir entre las categorías de Stripe | Escoge la categoría más relevante para tu app |
| **Subtítulo** | Máximo 80 caracteres | Eslogan breve que aparece en los resultados de búsqueda |
| **Acerca de** | Máximo 1.000 caracteres | Descripción detallada de lo que hace tu app |
| **Características clave** | Hasta 5, con imágenes | Destaca las funciones principales con capturas o diagramas |
| **Precios** | Gratis, de pago o freemium | Indica con claridad el modelo de precios y cualquier coste |
| **Soporte** | URL de contacto o email | Dónde pueden pedir ayuda los usuarios de tu app |
| **Política de privacidad** | URL de la política de privacidad | Documento legal obligatorio sobre el tratamiento de datos |

### Recomendaciones para el nombre

- Debe ser único en el marketplace
- Debe identificar con claridad la finalidad de tu app
- Evita términos genéricos que puedan confundir a los usuarios
- Ejemplo: “Tajo for Brevo” (15 caracteres)

### Recomendaciones para el icono

- Dimensiones: exactamente 300x300 píxeles
- Formato: PNG o SVG
- No añadas esquinas redondeadas, Stripe las aplica automáticamente
- Usa un logotipo o símbolo claro y reconocible
- Asegúrate de que se lee bien en tamaños pequeños

### Sección “Acerca de”

Escribe una descripción convincente que cubra:

- Qué problema resuelve tu app
- Las capacidades clave de la integración
- Para quién está pensada la app
- Cualquier requisito previo

Ejemplo:

> Tajo for Brevo conecta los datos de pago de Stripe con la plataforma de automatización de marketing de Brevo. Sincroniza clientes automáticamente, registra eventos de pago y activa campañas personalizadas de email, SMS y WhatsApp según el comportamiento de compra. Creada para negocios de ecommerce que quieren maximizar el valor de vida del cliente con un marketing de retención basado en datos.

### Características clave

Cada característica clave incluye:

- **Título**: nombre breve de la función
- **Descripción**: una o dos frases que expliquen la función
- **Imagen**: captura de pantalla o diagrama (se recomiendan 1600x900 píxeles)

Características recomendadas para la integración de Tajo con Brevo:

1. **Sincronización de clientes**, sincroniza automáticamente los perfiles de cliente de Stripe con los contactos de Brevo, con todo su historial de compras
2. **Automatización guiada por eventos**, activa flujos de trabajo de Brevo a partir de eventos de Stripe como pagos correctos, cambios de suscripción y reembolsos
3. **Sincronización del catálogo de productos**, mantén el catálogo de productos de Brevo sincronizado con Stripe para personalizar el contenido de tus campañas
4. **Campañas multicanal**, usa los datos sincronizados para impulsar campañas segmentadas de email, SMS y WhatsApp
5. **Datos en el panel de control**, consulta las métricas de interacción de Brevo directamente en la vista de cliente del panel de control de Stripe

### Información de precios

Comunica con claridad tu modelo de precios:

- **Gratis**: instalarla y usarla no tiene coste
- **De pago**: indica el precio y la frecuencia de facturación
- **Freemium**: describe qué se incluye gratis y qué requiere pago
- **Según uso**: explica los tramos de precios o los costes por unidad

## Cómo probar tu app

Antes de enviarla, prueba tu app a fondo:

### Pruebas en modo sandbox

```bash
# Start your app in test mode
stripe apps start --mode test

# Verify sandbox compatibility
stripe apps validate
```

### Formato de las credenciales de prueba

Cuando facilites credenciales de prueba al equipo de revisión, usa este formato:

```
Test Account Credentials
========================
Platform: Tajo
URL: https://app.tajo.io/test
Email: reviewer@test.tajo.io
Password: [secure test password]

Brevo Test API Key: xkeysib-test-xxxxxxxxxxxx

Required Setup Steps:
1. Log in to the Tajo test account
2. Navigate to Settings > Integrations > Brevo
3. The Brevo API key is pre-configured
4. Install the Stripe App from the test link provided

Expected Behavior:
- Customer sync should begin within 60 seconds of installation
- Navigate to any Stripe customer to see Brevo contact data
- Create a test payment to verify event sync to Brevo
```

### Lista de comprobación previa a la revisión

Antes de enviar la app, comprueba que:

- La app funciona tanto en modo live como en modo de prueba
- Todos los permisos tienen descripciones claras de su finalidad
- Los estados de error se gestionan con elegancia
- Se muestran estados de carga en las operaciones asíncronas
- No hay datos de prueba fijados en la compilación de producción
- La URL de la política de privacidad es accesible y correcta
- Los datos de contacto de soporte son válidos
- Todas las imágenes de la ficha cumplen los requisitos de tamaño
- La descripción de la app refleja fielmente su funcionamiento

## Después del envío

El equipo de revisión de Stripe suele responder en un plazo de 5 a 10 días laborables. Puede:

- **Aprobar** tu app para su publicación
- **Solicitar cambios** con comentarios concretos
- **Rechazar** la app si no cumple los requisitos

Si te piden cambios, atiende todos los comentarios y vuelve a enviarla. Cada nuevo envío pasa por el ciclo de revisión completo.

## Actualizar una app publicada

Para actualizar una app ya publicada:

1. Incrementa la versión en `stripe-app.json`
2. Sube la nueva versión: `stripe apps upload`
3. Envía la actualización a revisión
4. Una vez aprobada, la actualización se despliega automáticamente para todos los usuarios

Tip

Las correcciones de errores menores y los cambios no funcionales pueden recibir una revisión acelerada. Las funciones nuevas importantes o los cambios de permisos requieren una revisión completa.