Publicar en el Stripe App Marketplace

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.

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

Pasos para publicar

Paso 1: actualiza tu manifiesto

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

{
  "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 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:

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

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:

{
  "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": "Subscribe to Stripe events for real-time Brevo sync"
    },
    {
      "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:

stripe apps upload

Requisitos de la ficha

La ficha de tu app debe incluir todos estos campos:

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 en tiempo real. 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 en tiempo real, 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

# 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: [email protected]
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